This page's content:

EBANX WooCommerce plugin
Version: 1.30.0
Compatibility: For WooCommerce 3.0.0 or later

Make more money with EBANX WooCommerce

With the EBANX Payment Gateway plugin for WooCommerce, you can offer local and relevant payment methods in the fastest growing markets in Latin America for thousands of new customers.

After our plugin is installed you will be able to:

  • Create orders & request refunds directly in WooCommerce, without needing any other integration or plugin
  • One-click purchases which allow your client to skip the checkout process by saving their credit card information
  • Choose which payment methods are displayed at checkout
  • Sell to over 2,40M EBANX Account users

And don’t worry, no technical knowledge is needed for installation; follow a few steps to install it and start processing locally in Latin America with EBANX.

1. Installing the plugin

DISCLAIMER: If you are using our old plugin for Woocommerce, please uninstall it before using the new one.

2. Learn how to install it

The easiest and quickest option to install the EBANX plugin for WooCommerce is an automatic installation that can be done without leaving your web browser.

To do it, log in to the WordPress Dashboard and follow the steps:

  • Open your admin page in WordPress. Go to Plugins > Add new and search for “EBANX Payment Gateway”.
  • Click on “Install Now” button.
  • Wait and once the plugin is installed, tap on “Activate”.
  • On this step, your plugin is already installed. You have to go to EBANX Settings placed on the sidebar to configure your checkout page.
  • Doing this is time to fill out your information. You need to insert your Integration Keys found on your Dashboard Account, check the payment methods and the other options.

See an example in the video below:

Just five steps to start making money in Latin America!

Otherwise, if you want to install manually, access our repository on Github.

3. Manual Via Github

You can find our repository here. To view step-by-step installation via GitHub instructions click here.

To install manually, download our plugin and upload it to your web server via an FTP application. Visit the WordPress codex for further instructions.

2. Configuring your plugin

At the EBANX Dashboard, tap on your user name on the right corner, then Account Settings and Integration to find your Integration Keys.

Look an example of the page you will find:

Dashboard page with the Keys

Then, go to your WooCommerce and click on EBANX Settings in sidebar admin menu.

Add the integration key you’ve found on the EBANX Dashboard. You will need to use different keys in test (sandbox) and production (live) modes.

Screen shot with EBANX Plugin Configuration

Our plugin already comes with set settings, but you can change them according to your necessity.

3. Integration

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.

EBANX Sandbox

Mark or unmark the box to go into sandbox mode and live. EBANX Sandbox is a testing environment that mimics the live environment. Use it to make payments requirements to see how your eCommerce processes them.

Debug Log

Mark or unmark the box to choose to record all errors that occur when executing a transaction.

4. Enable Payment Methods

Do not forget to enable the payment methods for your checkout and make sure that the payment methods chosen are included in your agreement.

Check the list below for the payment methods available in each country:


Boleto EBANX, Domestic Credit Card and Bank Transfer (TEF)


OXXO, Credit and Debit Cards and SPEI


Cupón de Pago


PSE (Pago Seguros en Línea), Baloto and Credit Cards


ServiPag, Sencillito, WebPay, Multicaja


SafetyPay and PagoEfectivo


Cash and Bank transfer

The following image show how it will appear in your administrative area:

Payment Options

Credit Card

Save Card Data

Choose to allow your customer to save their credit and debit card data for future purchases.(TEF)

One-click Payment

Choose to allow your customer to complete payments in one-click using credit cards saved.

Enable Auto Capture

Automatically capture payments from your customers, just for the credit card. Otherwise, you will need to capture the payment going to WooCommerce -> Orders. Not captured payments will be cancelled within four days.

Maximum Number of Installments

Establish the maximum number of installments in which your customer can pay, as consented to your contract. Only Colombia supports more than 12.

Minimum Installment (USD)

Set the minimum installment value during checkout. The minimum EBANX allows for BRL is 5 and MXN is 100, lower values in these currencies will be ignored.

Interest Rates

Enable and set a custom interest rate for your customers according to the number of Installments you allow the payment.

Cash Payments

Days to Expiration

Define the maximum number of days on which your customer can complete the payment of Boleto, OXXO, Sencillito, PagoEfectivo, and SafetyPay.

5. Advanced Options

In the advanced options, you can select or not features that will help your client to have a better experience in their shops.

Enable Checkout for

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

Checkout Manager

If you make use of a Checkout Manager, please identify the HTML name attribute of the fields.

Currency and Amount Options

In the advanced options, you can select or not features that will help your client to have a better experience in their shops.

Total Local Amount

Show your customer the total purchase amount in local currency at the checkout.

Exchange Rate

Show your customer the currency exchange rate of the day.

IOF on Local Amount

Apply IOF (Brazilian Tax on Financial Operations) when calculating the price in BRL on the checkout.

6. Testing our plugin

Before installing our product, you can test by yourself in our demonstration page. Access here and have the same experience as your customer.

Do you have any other question?

Talk to us. Send an email to; our team will be there to help you out. 🙂

Check out the Plugin in the WordPress Directory.

7. Terms and conditions

Copyright (c) 2018, EBANX S.A. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are 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.