This page presents all information related to the Ebanx connection using Cards as payment. Use the following buttons to navigate to the desired section.

General Information

Captures

Refunds

Voids

Installments

Chargebacks

Security

Testing Guidelines

Integration Configuration

Production Environment

Connecting with Yuno

Mandatory fields when integrating via Yuno:

first_name,
last_name,
email,
document_number,
address_line_1,
country,
state,
city,
zip_code,
telephone_number

General information

Countries:

Argentina

Brazil

Colombia

Chile

Costa Rica

El Salvador

Guatemala

Mexico

Panama

Paraguay

Peru

Uruguay

Currencies:

ARS, BRL, COP, CLP, CRC, USD, GTQ, MXN, PYG, PEN, UYU.

Payment methods:

Credit card

Debit card

Prepaid card

Minimum amount:

Argentina: 5 ARS
Brazil: 0.5 BRL
Colombia: 1 COP
Chile: 1 CLP
Costa Rica: 10 CRC
El Salvador: 1 USD
Guatemala: 1 GTQ
Mexico: 3 MXN
Panama: 0.5 PAB/USD
Paraguay: 1 PYG
Peru: 1 PEN
Uruguay: 15 UYU

Maximum amount:

The standard is USD 10,000.00 but this can be configured by merchant.

TRX limit:

No limit.

Support of international BIN:

Not for CrossBorder operation. For Local Latam it is supported.

Activation of functionality:

For Local Latam the functionality must be activated in the merchant's account.

TRX without CVV:

Yes.

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Yes

Support for recurrency:

Yes, but EBANX doesn't have the recurrent engine, merchants or partners have to handle the payment transactions.

Webhooks:

Yes

Captures

Partial capture:

Yes. This feature is only available in Brazil. If you want to enable this feature, please contact Ebanx's Integration Team.

Multiple captures:

Maximum time to capture an authorization:

7 days for cards.

Captures over the amount of authorization:

No, only the total amount (except for the local fees or taxes - e.g.: IOF in Brazil)

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

Yes

Time to request refund:

To use and receive in the same payment method, under 90 days. After that, the refund is available only via Bank Transfer.

Time to process refund:

Depends on the country and financial institution.

Installments

Capability to define the installments when creating the payment:

Yes

GET endpoint available for retrieving the permitted BIN for the installments:

Yes

Possibility to choose who will be responsible for financing the installments:

Conditions or restrictions:

There are fees to use installments and that comes from Banks and Card Brands, EBANX sets that up into our system. You can check the fees applied over each installment via GET Installments Plan. EBANX can set up to charge the merchant or charge the customer, this part is negotiated between EBANX and the Merchant.

Deferral date availability:

Not on payment context.

Grace period:

Not on payment context.

Minimum number of installments (#months):

Brazil: 1 (depending on your contract).
Mexico: 1 (depending on your contract).
Colombia: 1 (depending on your contract).
Argentina: 1 (depending on your contract).
Peru: 1 (depending on your contract).

Maximum number of installments (#months):

Brazil: 12 (depending on your contract).
Mexico: 12 (depending on your contract).
Colombia: 36 (depending on your contract).
Argentina: 12 (depending on your contract).
Peru: 48 (depending on your contract).

Chargebacks

Notifications of chargebacks:

Yes, via EBANX dashboard.

Defined period to make a chargeback:

Under 180 days.

Endpoint for disputes:

No, the process is done via EBANX dashboard.

Maximum time to dispute a chargeback (provide evidence):

5 days

Testing guidelines for sandbox environment

Necessary fields for testing:

Merchant ID, Public Key, Private Key and Merchant Account ID.

Test cards:

Card Brand	Name	Code
American Express	amex	378282246310005
American Express	amex	378282749798722
Aura	aura	5078601870000127985
Diners Club	diners	30569309025904
Discover	discover	6011111111111117
Elo	elo	6362970000457013
Elo	elo	6362971747129170
Hipercard	hipercard	6062825624254001
Hipercard	hipercard	6062823936268330
Visa	visa	4111111111111111
Visa	visa	4111115666052208
MasterCard	mastercard	5555555555554444
MasterCard	mastercard	5555556355564617
CARNET (For Mexico only)	carnet	5062224607440872
Credimas (For Argentina only)	credimas	5045201174402586
Naranja (For Argentina only)	naranja	5895626292990446
Cabal (For Argentina only)	cabal	5896578742026538
Magna (For Chile only)	magna	5680095660610110

Limitations/Specifications for testing:

CVV: use any number with three digits, except American Express which CVV is four digits.
Expiration date (due date): use any date in the future.

Integration configuration

Credentials and steps to obtain them:

Log in to Ebanx dashboard.
Navigate to Settings and Integrations.
Get your keys.

Dashboard configuration:

Log in to dashboard.y.uno.
Click Connections and then select Ebanx.
Introduce Name, Integration key and Public Integration Key.
Click Connect

Configuration of webhooks in partner:

Log in to Ebanx dashboard.
Navigate to Settings and then Integrations.
Enter the proper URLs to receive notifications with updates of a transaction.

Production environment

Specific procedure for a merchant to go live:

Merchant must go through Compliance and Legal steps in order to be ready for a production account. After that, Ebanx must align the necessary requirements to make each country and payment method available.