> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anglpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EBANX - Card

> Connect to EBANX to accept credit and debit card payments in Latin America.

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](https://business.ebanx.com/en/request-contact).

## Credentials

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

* **Integration key** - The integration key obtained from the [EBANX Merchant Dashboard](https://dashboard.ebanx.com/).

## 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](/guides/dashboard/flow/overview) 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 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](/guides/payments/embed/quick-start)** - A pre-built, customizable payment form that handles the complete payment flow
* **[Secure Fields](/guides/payments/secure-fields/quick-start)** - Embed card input fields for building custom payment forms while maintaining PCI compliance
* **[Mobile SDKs](/guides/get-started#sdks-and-plugins)** - 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
