EBANX Payment Gateway for WooCommerce Plugin

Accept with ease and security, the most popular local payment methods throughout Latin America and receive your settlement for all sales made, anywhere in the world.

The WooCommerce EBANX Payment Gateway plugin will enable you to significantly increase your cross-border sales & conversion rates selling like a local in the world’s fastest growing eCommerce markets in Latin America.

Ready to accept local payments but don’t have an account yet? Finish our simple sign-up or [request a call] (https://business.ebanx.com/en/contact-sales) 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 2.4M EBANX Account users, furthermore 30M Latin America unique end users. No technical knowledge is needed to get impressive results; the installation is simple how 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 2.4M EBANX Account 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 on your checkout page
• Set a maximum number of installments
• Select an expiration date for cash payments
• Have all the requested information gathered on one checkout page entirely integrated with your platform
• Allow your customers to save their credit card to buy with just one-click and improve your conversions
• Set individual interest rates for each credit card installment plan
• Create orders & request refunds directly in your WooCommerce store
• Accept Local Currencies 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, Argentina, Chile, and Colombia 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 a customer would and to explore all the plugin features without having to install it. Access the Demo Store for your own first-hand experience.

Looking for more detailed information? Visit our Developer’s Academy for step-by-step guides, API references, and integration options or [request a call] (https://business.ebanx.com/en/contact-sales) with a Business Development Executive.

Requirements

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

About EBANX

EBANX is a local payments expert that offer complete solutions to connect eager buyers with global sellers, increasing the merchant’s revenue in the fastest growing markets in Latin America. Whether you are an enterprise or running your startup, EBANX can help you sell internationally with ease and efficiency.

Security section

When you use our plugin, 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.

Automatic

Automatic installation is the easiest way to do it, and it 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” to find EBANX Payment Gateway for WooCommerce and click on “Install Now.” After the installation, you just have to activate and get ready to sell even more.

Manual

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. Don’t waste your time and improve your results!

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.

Do you still need your API Keys? You can pick those up here. Just access your Dashboard Account, click on your user name, then on Account Settings and “Integration”.

1. 

   EBANX Features - Be able to accept local credit cards according to the country selected.

2. 

   EBANX Features - Allow your customers to save their credit card data to buy with just one-click; in addition to increasing your sales even more.

3. 

   EBANX Features - Choosing the EBANX Plugin for WooCommerce your Latin American customers will be able to pay with local methods, such as boleto, OXXO, baloto, etc. One type of cash payment method that can be printed or a virtual voucher like this image above.

4. 

   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.

5. 

   Plugin Configuration - You can select which countries and gateways you will show to your customers by inserting them on the right field to enable payments methods. Be sure that the country chosen is already in your contract with the EBANX.

6. 

   Plugin Configuration - Set more advanced options such as Save Card Data, One-click payment, Enable Auto-Capture, Maximum number of Installments, etc.

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 [email protected] or get in touch with us through our “Help & Support” tab inside the EBANX Dashboard. If you don’t have an account yet, access our Sign-up here or request a call with a Business Development Executive.

Where can I find more documentation or instructions?

On the EBANX Developer’s Academy you will find 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 Account, Debit Transfer
• Mexico
  • OXXO, Cash Payment
  • Debit & Credit Cards
  • EBANX Account, Debit Transfer
• Argentina
  • Cupón de Pago, Cash Payment / Online Banking
• Colombia
  • Credit Card
  • Pagos Seguros en Línea (PSE), Online Debit Transfer
  • Baloto, Cash Payment
• Chile
  • Sencillito, Cash Payment
  • ServiPag, Online Debit Transfer
  • WebPay, Debit and Credit Card
  • Multicaja, Cash Payment / Bank Transfer
• Peru
  • PagoEfectivo, Cash Payment / Debit Transfer
  • SafetyPay, Cash Payment / Debit Transfer
• Ecuador
  • Cash Payment
  • Online 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 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!

1.41.3

• Fix – Fix compability with some themes #842

1.41.2

• Fix – Fix stable version tag #838

1.41.1

• Fix – Fix change log #835

1.41.0

• Fix – device_id usage #830
• Fix – Enable custom phone field #832

1.40.6

• Fix – IE11 Compatibility #827
• Fix – Checkout fields language #825

1.40.5

• Fix – Colombian creditcard validation #825

1.40.4

• Fix – Return brazilian document in WooCommerce Subscription #822

1.40.3

• Fix – Load brazilian document in WooCommerce Subscription #820

1.40.2

• Fix – Load customer document in WooCommerce Subscription #817

1.40.1

• Fix – Fix Customer Data refreshing upon failure #813

1.40.0

• Feature – Add Bolivia support #810
• Fix – Remove direct access to order object #711
• Fix – WC_Subscription class not found #804

1.39.1

• Fix – Update Benjamin Version #786
• Improvement – Remove require command and use Namespaces #785

1.39.0

• Fix – Refactor Payment Gateway #783
• Fix – Fix Virtual Product Status #772

1.38.6

• Fix – Remove Exchange Exception #770

1.38.5

• Fix – Remove warning messages #767

1.38.4

• Fix – fix fatal error when EBANX Gateway was active and Woocommerce was not #761

1.38.3

• Improvement – Redirect to EBANX page when payment is Banktransfer in Brazil #763
• Fix – Include error message BP-DR-39 in spanish #762

1.38.2

• Fix – Fix Argentine State/County selector on order-payment checkout #760

1.38.1

• Improvement – Set fallback person type at method get_person_type_from_order #758

1.38.0

• Fix – Fix WooCommerce Subscription #756
• Improvement – Update lib js version #755
• Improvement – Quality/fix e2 e tests intermittent #752
• Improvement – Add payment method validation to avoid EBANX warnings on other methods #751
• Feature – Add Argentine DNI Document on Checkout #748

1.37.3

• Improvement – Using WP_Mock in unit test and remove wc_function for mock #746

1.37.2

• Improvement – Remove iof when request a payment using benjamin #738

1.37.1

• Improvement – Hide optional fields tag from checkout #740

1.37.0

• Feature – Add User Agent header usage to send plugin-version data #734
• Feature – Add plugin check page #735
• Improvement – Remove PDF button and embed voucher in mobile for Banktransfer #733

1.36.0

• Fix – Resolved wrong behavior with CPF and CPNJ inputs exhibition #729
• Feature – Add credit card validation to front-end layer #731

1.35.0

• Feature – BankTransfer payment method #728

1.34.7

• Fix – Hide document field if not required #722

1.34.6

• Fix – Resolved wrong currency in payment by link #720

1.34.5

• Improvement – Add tests for payment adapter service #716

1.34.4

• Improvement – Add instalments and interest translation #714

1.34.3

• Improvement – Mask document in Chile and Colombia #708
• Fix – Resolved wrong amount in checkout page #709
• Update – Read instalments from benjamin #710

1.34.2

• Fix – Show correct value without taxes correctly on Credit Card gateways when flag is disabled #703

1.34.1

• Fix – Show value without taxes correctly when flag is disabled
• FIx – Resolved error message on product page for countries without creditcard #701

1.34.0

• Feature – Use Benjamin to calculate instalments values #699
• Feature – It is now possible to configure different interest rates fees for each country that accepts credit card #700

1.33.1

• Fix – Document will not be mandatory when a gateway that is not from EBANX is selected #697

1.33.0

• Fix – PHP Strict Standards issue on WC_EBANX_Logger 687
• Fix – Bugfix undefined offset 1 in class wc ebanx environment 692
• Feature – Change API urls 696

1.32.1

• Fix – Make chilean document mandatory #695

1.32.0

• Feature – Add document as mandatory for all colombian gateways #694

1.31.3

• Fix – Credit card tokenization compatibility issue with jQuery #683

1.31.2

• Fix – Log table creation #679
• Fix – Fix iframe voucher resize on thank you page #680

1.31.1

• Fix – Gather compliance data differently for payment by link #678

1.31.0

• Feature – Use Benjamin to decide if a gateway should be visible on checkout #675
• Fix – Complete payment status of downloadable products no longer overriden #677

1.30.0

• Feature – Force document on Argentina to have 11 digits #670
• Fix – Corrected bug that made some thank you pages to render html tags as texts #671
• Fix – Only send leads to EBANX on this plugin update to avoid errors #672
• Fix – Set payment as complete also on notification arrival #673

1.29.3

• Fix – get_country on null and min_instalment_value_ not defined bug #669

1.29.2

• Fix – Runtime exception warning #663

1.29.1

• Fix – Removed flush_rewrite from logs persistence step #660
• Fix – Restructured logs table #661

1.29.0

• Feature – WC Subscriptions support #594
• Feature – Logging request data for debugging purposes #627
• Feature – Use benjamin EBANX’s new SDK to make requests #652
• Feature – Get possible exceptions on apply_filters calls #653

1.28.3

• Feature – Allow 4 digit cvv only for America Express Credit Card brand #648
• Fix – Compatibility layer works with php 5.4 #645
• Fix – Currency options title not hiding when clicke on admin #647

1.28.2

• Fix – Instalment selection returning to 1x on checkout errors #639
• Fix – Outdated error messages #641

1.28.1

• Fix – Get settings from gateway and not from inexistent attribute on one-click #632

1.28.0

• Feature – Removed documents from some payment methods of Chilean and Colombian #617
• Feature – Added document as mandatory to Peruvian gateways #618
• Feature – Added document as mandatory to Argentinian gateways #619
• Feature – Added sandbox mode warning on gateway form #624
• Fix – Fixed due date options not appearing on admin #616
• Fix – Fixed instalment changing exchange rate message to total local amount message #623
• Fix – Fixed one click redirecting to product page on Mexico #626
• Fix – Stop changing ‘complete’ status on notification arrival #629

1.27.0

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

1.26.0

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

1.25.2

• Fix – Fixed IOF being mistakenly applied to installments #606

1.25.1

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

1.25.0

• Feature – Credit Card for Argentina #602
• Feature – SafetyPay for Ecuador #603

1.24.1

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

1.24.0

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

1.23.0

• 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 installment value to 5 BRL for Brazilian credit card payments #595

1.22.0

• 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 installments for disabled tax flag #584

1.21.0

• Feature – Added new Argentina payment method Efectivo #576
• Feature – Showing installments 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 deconfigured merchants #569
• Fix – Overwriting libjs invalid expiry date error #572
• Fix – Saving document on redirect payment methods #574
• Fix – Fixed iframe resized #575

1.20.0

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

1.19.0

• 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

1.18.0

• 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

1.17.1

• Fix – Removed unused include #554

1.17.0

• 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

1.16.0

• 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 WebLPay Gateway for Chile #538
• Feature – Added an option for merchant to hide IOF #541
• Feature – Added a compatibility layer to prevent incompatibilities 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

1.15.0

• 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

1.14.1

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

1.14.0

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

1.13.2

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

1.13.1

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

1.13.0

• 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 Installment (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

1.12.1

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

1.12.0

• Feature – Using interest rate on minimum installment 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 installments 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

1.11.4

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

1.11.3

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

1.11.2

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

1.11.0

• 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.

1.10.1

• Fix – Removed methods to prevent fatal error #412

1.10.0

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

1.9.1

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

1.9.0

• 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 installments with interests #395

1.8.1

• Fix – Fixed installment reading on checkout #393

1.8.0

• 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

1.7.1

• Fix – Fixed OXXO and Pago Efectivo iframe not showing #382

1.7.0

• 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 library 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

1.6.1

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

1.6.0

• 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 installment limits are now adjusted for local currency instead of assuming USD for prices #349

1.5.3

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

1.5.2

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

1.5.1

• Fix – Notification URL in payment payload #341

1.5.0

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

1.4.1

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

1.4.0

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

1.3.0

• 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

1.2.3

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

1.2.2

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

1.2.1

• Fix – Chile payments when using checkout manager #306

1.2.0

• Feature – Installments limit based on minimum 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

1.1.2

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

1.1.1

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

1.1.0

• Feature – Installments field now gets hidden when max installments 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

1.0.2

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

1.0.1

• 2016-01-17 – Texts – Changing the naming and texts from plugin.

1.0.0

• 2016-12-30 – First Release.