Skip to main content
EBANX is a payment platform focused on Latin America that enables merchants to accept local card payments in Brazil, Mexico, Peru, and Colombia. The platform supports direct capture, refunds, and zero-auth verification across multiple local currencies.

Setup

To create an EBANX account, visit the EBANX Business Page.

Credentials

When setting up EBANX in the dashboard, configure the following credentials:

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_id parameter to the EBANX connector ID when creating transactions. This overrides any Flow routing rules.
The connector ID can be found in the dashboard under Connections -> Configured connections.

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 codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry code
BRPEMXCO

Supported currencies

EBANX supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
BRLEURMXNPENUSDCLPCOPARS
BOBUYU

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
These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which automatically routes the payment to your configured EBANX connection based on your Flow rules or explicit payment_service_id parameter.

Required fields

EBANX requires additional buyer information depending on the country and currency of the transaction:
  • Brazil (BR with BRL, EUR, or USD) - First name, last name, email address, phone number, and tax ID
  • Mexico (MX with MXN or USD) - First name, last name, email address, and phone number
  • Argentina (AR with ARS or USD) - First name, last name, email address, phone number, and tax ID