Setup
To create an EBANX account, visit the EBANX Business Page.Credentials
When setting up EBANX in the dashboard, configure the following credentials:- Integration key - The integration key obtained from the EBANX Merchant Dashboard.
Connector configuration
After setting up your EBANX connector in the dashboard, configure how transactions are routed to it. Choose one of the following options:- Using Flow - Configure EBANX as the target connector in Flow to automatically route card transactions to this connector
- Using the API - Explicitly set the
payment_service_idparameter to the EBANX connector ID when creating transactions. This overrides any Flow routing rules.
Features
EBANX supports the following features:- Direct capture - Payments are captured immediately at the time of authorization
- Partial refunds - Refund a portion of the captured amount
- Refunds - Refund transactions in full
- Void - Cancel an authorized transaction before capture
- Zero auth - Verify a card without charging it
Supported countries
EBANX supports transactions from buyers in the following countries:| Country code | Country code | Country code | Country code | Country code | Country code | Country code | Country code |
|---|---|---|---|---|---|---|---|
BR | PE | MX | CO |
Supported currencies
EBANX supports processing payments in the following currencies:| Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code |
|---|---|---|---|---|---|---|---|
BRL | EUR | MXN | PEN | USD | CLP | COP | ARS |
BOB | UYU |
Limitations
The following features are not supported by this connector:- Delayed capture - Authorizing a payment and capturing it later is not supported
- Partial capture - Capturing a portion of the authorized amount is not supported
- Over capture - Capturing more than the authorized amount is not supported
- Partial authorization - Accepting a partial amount when the full amount cannot be authorized is not supported
- Payment method tokenization - Storing payment methods outside of transactions is not supported
- 3-D Secure - Neither hosted nor pass-through 3DS authentication is supported
- Network tokens - Network tokenization is not supported
- Digital wallets - Digital wallet integrations are not supported
- Transaction sync - Automatic transaction status synchronization is not supported
- Settlement reporting - Automatic settlement reporting is not supported
Integration
To accept card payments with EBANX, use one of Gr4vy’s client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. You can integrate using:- Embed - A pre-built, customizable payment form that handles the complete payment flow
- Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
- Mobile SDKs - Native SDKs for iOS, Android, React Native, and other platforms
payment_service_id parameter.
Required fields
EBANX requires additional buyer information depending on the country and currency of the transaction:- Brazil (
BRwithBRL,EUR, orUSD) - First name, last name, email address, phone number, and tax ID - Mexico (
MXwithMXNorUSD) - First name, last name, email address, and phone number - Argentina (
ARwithARSorUSD) - First name, last name, email address, phone number, and tax ID