EBANX Payment Gateway for WooCommerce


Accept with ease and security, the most popular local payment methods in Latin America and receive your money anywhere in the world. The WooCommerce EBANX Payment Gateway plugin will enable you to significantly increase your cross-border sales & conversion rates by allowing you to sell like a local in the world’s fastest growing ecommerce markets.

Ready to accept local payments but don’t have an account yet? Finish our simple sign-up and we can start helping you sell like a local in Latin America or schedule a call with a Business Development Executive.

Plugin Description

The WooCommerce EBANX Payment Gateway plugin allows you to accept local & international payment methods directly on your ecommerce store. Using the EBANX plugin you can process relevant cash, online debit, and credit card payments in Brazil, Mexico, Argentina, Chile, Colombia, Peru & Ecuador, and access over 20M EBANX Wallet users. No technical knowledge is needed for installation. Installation is simple, the way it should be.

EBANX Advantages

  • Security is already taken care of, the customer’s sensitive data doesn’t go to your server but is saved in EBANX environment using PCI standards
  • One-click purchases which allow your client to skip the checkout process
  • Checkout payment form is responsive and adapts nicely to all mobile screen sizes and themes
  • Everything you need in one plugin, you don’t have to install any external plugins or extensions
  • Sell to over 20M EBANX Wallet users
  • Join ecommerce merchants such as AliExpress, Airbnb and Spotify

Customize and Manage Your Payments

With the EBANX plugin, you can:

  • Choose which payment methods are displayed at checkout
  • Set a maximum number of installments
  • Select an expiration date for cash payments
  • Allow customers to save their credit card information
  • Set individual interest rates for each credit card instalment plan
  • Create orders & request refunds directly in WooCommerce
  • Accept Local Currencies, USD and EUR based on your WooCommerce Currency Options, to be processed by EBANX

The plugin also includes:

  • Sandbox mode for testing
  • Capture mode that when activated allows you to collect payments after a manual review
  • Extra fields that are added automatically for payments made in Brazil or Chile where customers must provide more information to local regulatory authorities
  • Support for checkout managers

Want to do a Test Drive?

Our demonstrations allow you to create a payment as customer would and to explore all the plugin features without having to install. Access the Demo Store for your own first-hand experience or request a personal demonstration via phone with a Business Development Executive.

Looking for more detailed information? Visit our Developer’s Academy for step-by-step guides, API references, and integration options or call a Business Development Executive.


All pages that incorporate the EBANX plugin must be served over HTTPS.


EBANX is a local payments expert and we offer complete solutions for international businesses wanting to sell more in Latin America. Whether you are an enterprise or running your own startup, EBANX can help you sell internationally with ease and efficiency.

Arbitrary section

When you use our plug in, you trust us with your information and agree that we may keep it and use it for the purposes of our commercial relationship. As we are a PCI compliant company, we will keep all your data safe, and will not use it for any other purposes.


  • EBANX Features - Be able to accept local credit cards.
  • EBANX Features - One of the features that the plugin brings, it's the One Click Payment. A functionality that allows your customer to save their card data and buy the product with only one click.
  • EBANX Features - Once you choose the EBANX Plugin, your Latin American customers will be able to pay in local methods, such as: boleto, oxxo payments and national credit cards.
  • Plugin Configuration - To start your integration, go to your EBANX Dashboard settings to find your test and live keys. Insert them and choose to enable the sandbox mode for testing.
  • Plugin Configuration - You can choose the countries and gateways to work with just by inserting them on the right field to enable payments methods.
  • Plugin Configuration - Set more advanced options such as: Save Card Data, One-click payment, enable auto-capture and maximum number of installments.



Automatic installation is the easiest option and can be done without leaving your web browser. To do an automatic install of the EBANX plugin, login to the WordPress Dashboard, go to the Plugins menu, and select “Add New.” Then, search for the “EBANX Payment Gateway for WooCommerce” and click “Install Now.”


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

Via GitHub

The EBANX Gateway Plugin can also be installed using GitHub. You can find our repository here. To download the plugin from our repository, please view our latest release and download the woocommerce-gateway-ebanx.zip package.

Still need your API Keys? You can pick those up here.


Installation Instructions


Automatic installation is the easiest option and can be done without leaving your web browser. To do an automatic install of the EBANX plugin, login to the WordPress Dashboard, go to the Plugins menu, and select “Add New.” Then, search for the “EBANX Payment Gateway for WooCommerce” and click “Install Now.”


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

Via GitHub

The EBANX Gateway Plugin can also be installed using GitHub. You can find our repository here. To download the plugin from our repository, please view our latest release and download the woocommerce-gateway-ebanx.zip package.

Still need your API Keys? You can pick those up here.

Does this plugin support subscriptions or recurring charges?

Not yet. However, customers are able to save credit card information and make one-click purchases. We are working on having the next version of the plugin support subscriptions.

Who can I contact if I still have questions?

Reach out to one of our integration specialists at integration@ebanx.com or speak with your merchant services or business manager. Don’t have a business manager yet? Sign-up here and we will assign one to your company account or schedule a call with a Business Development Executive.

Where can I find more documentation or instructions?

The Developer’s Academy has step-by-step instructions and detailed information about all our plugins.

Which payment types does EBANX process?
  • Visa, Mastercard, American Express, Diner’s Club, Discover – all countries
  • Brazil
    • EBANX Boleto, Cash Payment
    • Hipercard, Elo, and Aura Domestic Credit Cards
    • Online Debit Transfer
    • EBANX Wallet, Prepaid Card / Debit Transfer
  • Mexico
    • OXXO, Cash Payment
    • Debit & Credit Cards
    • EBANX Wallet, Debit Transfer
  • Argentina
    • Credit Card
    • Efectivo
  • Chile
    • Sencillito, Cash Payment
    • Servipag, Online Debit Transfer
  • Peru
    • PagoEfectivo, Cash Payment / Debit Transfer
    • SafetyPay, Cash Payment / Debit Transfer
  • Colombia
    • Credit Card
    • Pagos Seguros en Línea (PSE), Online Debit Transfer
    • Baloto
  • Ecuador
    • SafetyPay, Cash Payment / Debit Transfer
Which currencies does EBANX accept?
  • USD – U.S. Dollar
  • EUR – Euro
  • BRL – Real
  • ARS – Peso Argentino
  • MXN – Peso Mexicano
  • COP – Peso Colombiano
  • CLP – Peso Chileno
  • PEN – Novo Sol
Can I use my own Checkout Manager plugin?

Yes, you can.

  1. Set up your own billing fields in the checkout manager plugin page;
  2. Go to the EBANX Settings page and open the Advanced Options section;
  3. Enable the Use my checkout manager fields checkbox and fill in the field names as in step 1;
  4. There you go, you’re all set!



Now I can sell my products to Brazil and Latin America! And it is very very easy to install!

Latin America payments

Amazing!!!! I can sell and offer local payment to Brazil and Latin America with only one plugin and it is very simple to instal and configure.

Read all 5 reviews

Contributors & Developers

“EBANX Payment Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.




  • Feature – Change tooltip message for IOF on local amount #611
  • Feature – Show exchange rate on checkout #612


  • Feature – Added instalments to payment by link order form #608
  • Feature – Treating BP-R-32 error message on payment by link order form #609


  • Fix – Fixed IOF being mistankenly applied to instalments #606


  • Fix – Preventing IOF from being applied more than once on instalments #604


  • Feature – Creditcard for Argentina #602
  • Feature – SafetyPay for Ecuador #603


  • Fix – Made some credit cards errors more specific for better user understanding #601


  • Feature – Updated Chile payments api identification code #597
  • Feature – Skipping asynchronous confirmations for credit card payments #592


  • Feature – One click form can now be submitted using keyboard #588
  • Feature – Better payment origin identification on dashboard #590
  • Feature – Plugin approved for wordpress 4.9 #593
  • Feature – Change minimum instalment value to 5 BRL for brazilian credit card payments #595


  • Feature – Explicit capture button #578
  • Feature – Added new Mexico payment method SPEI #581
  • Fix – Adjusted iFrame display for Argentina cash payment methods #580
  • Fix – Ignored IOF in instalments for disabled tax flag #584


  • Feature – Added new Argentina payment method Efectivo #576
  • Feature – Showing instalments on local currency #571
  • Fix – Saving customer document when creating account on checkout #566
  • Fix – Show one click button only if customer has document #567
  • Fix – Removed ::class from same file that checks if php version is supported #568
  • Fix – Added fake birthdate to payment data to prevent error on unconfigured merchants #569
  • Fix – Overwriting libjs invalid expiry date error #572
  • Fix – Saving document on redirect payment methods #574
  • Fix – Fixed iframe resizer #575


  • Feature – Dashboard lead links update to Dashboard v2 #564


  • Feature – Credit Card refusal message and detailed log #560
  • Feature – Removed Birth Date from checkout form #561
  • Fix – Changed currency array for One Click #562


  • Feature – Filter to change amount per gateway #555
  • Feature – Added “Cancel Order” button on “My Account” page #556
  • Fix – Removed autocomplete from cvv field on on-click payment #557
  • Fix – Correctly saves Credit Card when creating account #558


  • Fix – Removed unused include #554


  • Feature – New Thank You pages for Credit Card and Boleto #544
  • Feature – Added translation for Minimum Amount for Purchase error on Colombia #547
  • Feature – Added Portuguese translation for Settings Page #549
  • Feature – Changed project license to Apache v2.0 #548
  • Fix – Changed IOF messages on Admin Dashboard #545
  • Fix – Fixed Debit Card tokenize error #550
  • Fix – Fixed One Click Payment not processing #551
  • Fix – Updated pay for order layout #552


  • Feature – Pay for order(woocommerce native payment by link) #531
  • Feature – Added Credit Card Gateway for Colombia #534
  • Feature – Added Multicaja Gateway for Chile #539
  • Feature – Added Webpay Gateway for Chile #538
  • Feature – Added an option for merchant to hide IOF #541
  • Feature – Added a compability layer to prevent incompabilities from third party plugins and themes like WooCommerce’s Storefront #535
  • Fix – Fixed PHP notice when using empty interest rate option #530
  • Fix – Fixed error when a Merchant Payment Code gets greater than 40 characters #537


  • Feature – Created an option to hide the local amount value on checkout page #526
  • Fix – Applied box-sizing: border-box on boleto thank you pages button to avoid issues #527


  • Fix – Problem resolved when the actions were updated via book actions. #523


  • Feature – Added EURO conversion #520
  • Feature – Support for pt_PT translations #521


  • Fix – Replaced wp_die to exit to avoid error 500 #515
  • Fix – Updating order when it receives a payment status notification #516


  • Fix – Avoid duplication payment notifications #509
  • Fix – Changed PSE thank you page HTML #512
  • Fix – Changed Boleto thank you page HTML #513


  • Fix – Fix for debug log when is enabled before record a log #507
  • Fix – Fix issue to avoid some issues on refund transactions #506
  • Fix – Changed label to Minimum Instalment (title-cased labels) #500
  • Fix – Fixed compliance fields when country is empty #498
  • Feature – Docker implementation and end-to-end tests for Brazil payments done #504


  • Fix – Credit-card saving for new customers #496
  • Fix – One-click payments button in product details #496


  • Feature – Using interest rate on minimum instalment value #490
  • Feature – Refactor EBANX query router #487
  • Feature – Added a minimal value setting on settings #477
  • Feature – Changed cookie to localStorage to save flags #476
  • Feature – Plugin docs using phpDocumentator #488
  • Fix – Thank you page values and instalments fixed #473
  • Fix – Hide saved cards when option is disabled #475
  • Fix – DNI field is not mandatory for colombia any more #486
  • Fix – Changed the assets path to system path instead of host path #489
  • Fix – Using absolute path to spinner gif #485
  • Improvement – Updated notification notices and notes #468


  • Fix – Fixed float values not being accepted in interest rates #480
  • Fix – Added ‘/’ to Notification URL to prevent Response Code 301 #480


  • Fix – Fixed a problem that it was incrementing a value by instalment #463


  • Fix – Fixed translation paths #462
  • Fix – Fixed converted value message when instalments is changed #462
  • Fix – Fixed problems with newer version of WooCommerce #462


  • Feature – Showing the prices with IOF for Brazil before on gateways #441
  • Feature – Alert the merchants when HTTPS isn’t present #427
  • Feature – Show a message to fill the integration keys when empty #426
  • Feature – Hooks implemented to facilitate the future integrations #423
  • Feature – Capture payment manually clicking on “Processing” button #421
  • Feature – Show a message when credit card is invalid on sandbox mode #420
  • Feature – Created a flash message management helper class #414
  • Improvement – Assets optimization by 62% faster #429
  • Fix – Refactored and fixed bugs of one click feature #457
  • Fix – Reverts the WC3 update keeping backward compatibility #455
  • Fix – SafetyPay Notices #450

These are the most importante fixes and features, but another fixes and quality issues were resolved too.


  • Fix – Removed methods to prevent fatal error #412


  • Feature – Removed restriction on guest users for sandbox mode #406
  • Feature – Showing some EBANX order details on admin order details page #404
  • Improvement – Removed unecessary properties and variables #407
  • Improvement – Improved texts and options on OXXO thank you page #409
  • Fix – Updated deprecated function #403


  • Fix – Fixed translations string keys in instalment template #402


  • Feature – Advanced options hide when not applicable #391
  • Feature – Translated my-account credit card section #398
  • Feature – Added tooltips with nice descriptions to gateway settings page #400
  • Improvement – Cached last key check response to speed up admin panel #396
  • Improvement – Cached exchange rates in short intervals to improve checkout page performance #399
  • Fix – Fixed translations for instalments with interests #395


  • Fix – Fixed instalment reading on checkout #393


  • Feature – Hide irrelevant fields and group fields by country on EBANX Settings page #373
  • Feature – Added new payment gateway Baloto (Colombia) #371
  • Feature – Hide the payment gateways on checkout page when sandbox mode is enabled for non admin users and not logged users #380
  • Feature – A warning was added when sandbox mode is enabled #378
  • Feature – Added asterisk to required compliance fields on checkout page #370


  • Fix – Fixed Oxxo and Pagoefectivo iframe not showing #382


  • Feature – The HTML select fields are now using the select2 jQuery plugin to improve the user experience #356
  • Improvement – We removed some unnecessaries folders and files from plugin #353
  • Improvement – All JS assets are loading on footer #357
  • Fix – Fixed the low resolution of the EBANX badge on non-retina displays #354
  • Fix – Prevent fatal error when the plugin is activated without WooCommerce plugin #360
  • Fix – Avoid SSL warning from EBANX PHP libray when the plugin make a request to URLs with a bad SSL certificate #362
  • Fix – Resolves fatal error when the plugin can’t get some informations #365


  • Fix – Address splitting function to avoid mistakes during checkout #352


  • Feature – Integrates with EBANX Dashboard plugin presence check #348
  • Improvement – Gets the banking ticket HTML by cUrl with url fopen fallback #345
  • Improvement – Changed iframe boleto URL fetching to avoid xss injections #345
  • Fix – Max instalment limits are now adjusted for local currency instead of assuming USD for prices #349


  • Fix – In case user country was not set one-click payments was crashing #343


  • Fix – Checking for new feature’s settings presence to avoid notices #342


  • Fix – Notification URL in payment payload #341


  • Feature – Instalment interest rates are now configurable #336
  • Improvement – Payment Options section in admin is now togglable #336


  • Fix – Fixed API Lead URL to the correct URL, because it was causing a redirect without www


  • Fix – Fixed max instalments limit according to acquirer in one-click payments #334
  • Improvement – Sending analytics information for plugin activations #332


  • Feature – Allowed local currency, USD and EUR to be processed by EBANX based on WooCommerce Currency Options #325
  • Improvement – Updated to new EBANX logo #326
  • Fix – Removed the pipe character from the last WooCommerce Checkout Settings tab menu #329


  • Fix – Checkout manager field for person type selecting in Brasil value is now respected #323


  • Fix – Chceckout manager fields are no longer mandatory when activated #320


  • Fix – Chile payments when using checkout manager #306


  • Feature – Instalments limit based on minimun amount accepted by credit card acquirer #298
  • Feature – API requests now using cUrl as main method of http communication #302
  • Feature – Checkout manager option for entity type field in brazil checkout in cases where cnpj and cpf are both enabled #304
  • Fix – Undisplayed thank-you-page messages #299
  • Fix – Checkout manager settings being respected even when disabled #304


  • Fix – Integration keys validation messages now update properly #297


  • Fix – Brazil compliance fields showing for other countries #294


  • Feature – Instalments field now gets hidden when max instalments is set to one #275
  • Feature – Send store notification and return links to payment api #268
  • Feature – Support for third-party checkout manager plugins #279
  • Feature – CPF/CNPJ Brazilian person types support #279
  • Feature – New debit card flags for mexico #290
  • Change – Added the new tags: alternative payments and accept more payments
  • Fix – Thank you pages for each payment gateway are now called by order status #277
  • Fix – The credit cards gateways were separated by countries #277


  • Bug – Fixed bug that was breaking the media uploader #267
  • Enhancement – All methods are commented now #266


  • 2016-01-17 – Texts – Chaging the namings and texts from plugin.


  • 2016-12-30 – First Release.