EBANX Magento Extension

Version: 2.7.0

For Magento 1.6, 1.7, 1.8 and 1.9

Increase your sales with EBANX Magento

The EBANX Payment Gateway for Magento allows you to accept the most popular local payment methods of Latin America and receive your money anywhere in the world.

Install the extension quickly and start selling in the fastest growing markets; get ready to reach more customers and boost your sales.

If you don’t have an EBANX Account yet, don’t worry!

Access here to complete our simple sign-up or schedule a call with a Business Development Executive to expand your business with the intelligence and efficiency.

1. Update your merchant settings

1.1 Access the Dashboard and insert your username and password.

1.2 Go to Settings and change the following fields, where {YOUR_SITE} is your store URL:

  • Status Change Notification URL: {YOUR_SITE}/ebanx/payment/notify
  • Response URL: {YOUR_SITE}/ebanx/payment/return

2. Install the extension

2.1 Download the EBANX Magento extension and extract its contents to the root folder of your Magento installation. You may want to move it to your computer and then upload the content to your server.

2.2 Go to your store administrative area.

2.3 If you have cache enabled, you will need to flush it at System > Cache Management, by clicking on the button “Flush Magento Cache”.

2.4 If you follow all those steps correctly, you will see EBANX settings at System > Configuration > Payment Methods > EBANX.

Just to remind if you have an old version of EBANX Magento Extension, you will need to follow these two more steps:

2.5 After installation, access again “System” > “Configuration” > “Advanced” > “Advanced”, because now it’s time to disable the old version of EBANX Magento Extension.

2.6 Search for “EBANX Standard”, “EBANX EBANX” and “EBANX Express” that correspond to the old version and select to “Disable”.

Attention: after the update, it’s essential to let only “EBANX Gateway” activated, like this image below:

3. Update the extension settings

3.1 Enable the EBANX payment extension.

3.2 Add the integration key the EBANX integration team gave you. You will need to use different keys in test and production modes.

Understand every item on the configuration page in the list below :

Mode

Sandbox or live.

Sandbox Integration Key

Unique test mode key, keep it safe and do not expose this information.

Sandbox Public Integration Key

General test mode key. You can do a token operation using this, key instead of the integration key when the request is from the client of your customer (browser, app, etc.). By doing this you do not have to deal directly with the credit card information of your customer.

Live Integration Key

Once you have completed the process of integration with EBANX, you will receive a unique live mode key which will allow you to operate with our services; it is essential to keep all the information safe and not exposed.

Live Public Integration Key

General live mode key. Just like the Sandbox Public Integration Key, you can do a token operation using this key instead of the integration key when the request is from the client of your customer (browser, app, etc.). By doing this, you do not have to deal directly with the credit card information of your customer.

Enable Debug Log

Record all errors that occur when executing a transaction.

Checkout For

CPF – individuals/CNPJ – companies – to process with the EBANX Plugin in Brazil there a few mandatory fields such as CPF identification for individuals and CNPJ for companies.

Payment Methods

Select payment methods for each country.

Payment Methods Visualization

Show payment methods logo for better conversion at your checkout.

Enable instalments

Enable or disable instalments. Your merchant account must be allowed to process credit card payments with instalments.

Maximum n° of Instalments

The number of instalments that are enabled.

Minimum Instalment (USD)

Minimum Instalment value

Interest rates

Enables/disables interest rates to customer

Interest

Add and configure different interest rates for each number of instalments.

Days to Expiration

The due date for printable slips (boleto/boletas, etc.). You must ask EBANX to change this limit for your account.

Paid Payment Status

The paid order status. The standard option is “Processing”.

Pending Payment Status

The new order status. The standard option is “On Hold”.

Requested Payment Status

The new order status. The standard option is “Pending”.

Cancelled Payment Status

The cancelled order status. The standard option is “Canceled”.

Mandatory Fields

Processing with EBANX requires a few mandatory fields that need to be included in your checkout when processing to Brazil and Chile, such as CPF, CNPJ, DNI, and RUT. You can choose to: replace your TAX/VAT fields and name it as these mandataries field or add your own field.

Terms and conditions

Copyright (c) 2017, EBANX Ltda. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions be met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of EBANX nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. This software is provided by EBANX “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall EBANX be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.