Overview
EBANX supports card payments, account-to-account payments through PSE Avanza, Bre-B (the instant payment system) and Botón Bancolombia, Nequi and Nequi Recurring, and cash payments through Efecty in Colombia.
Colombia supports the cross-border and the local operation models. EBANX processes payments in COP, and credit cards support installments.
Available payment methods
EBANX supports the following payment methods in Colombia. Methods are grouped by Payment Bundle, the integration flow each method follows. Select a method for integration details, or visit the API Operability page.
- Cards: Credit Cards, Debit Cards
- Cash & Codes: Efecty, Bre-B, Nequi
- Trusted Redirects: PSE Avanza, Botón Bancolombia
- Tokenized Alternatives: Nequi Recurring
Customer document
The document field is required. Provide document_type to specify the document.
| Document Type | Format | Description |
|---|---|---|
| CC | 2-15 digits | Cedula de Ciudadania. National identity document for Colombian citizens. Default when document_type is omitted. |
| NIT | 2-15 digits | Numero de Identificacion Tributaria. Tax identification number for businesses. |
| CE | 2-15 digits | Cedula de Extranjeria. Identity document for foreign nationals. |
Currencies
| Detail | Value |
|---|---|
| Local currency | COP - Peso Colombiano |
| Accepted currencies | COP |
Taxes for local processing
The tax fields below are required only when both conditions are true:
- EBANX processes your Colombian payments as a local entity (
LOCAL_LATAM). - Your merchant account is enabled for single transaction and parameter taxes.
Required fields
When both conditions apply, the request must split the charged amount between the local and cross-border portions and declare the Colombian IVA (value-added tax). Add the following fields to the payment object of every payment method listed above, in addition to the parameters required by that payment method:
{
"single_transaction": {
"amount_local": 99.85,
"amount_crossborder": 0.00
},
"taxes": {
"iva_co": 0.00
}
}
Validation errors
| Error code | Cause |
|---|---|
BP-TX-01 | single_transaction.amount_local is positive and the taxes object is missing. |
BP-TX-02 | single_transaction.amount_local is positive and taxes.iva_co is missing. |
BP-ST-00 | single_transaction is sent, but the capability is not enabled for the merchant account. |
Refunds
- Card refunds are submitted to the card acquirer.
Refunds paid by bank transfer require the following customer bank details:
| Field | Description |
|---|---|
| Bank name | Must be a supported Colombian bank |
| City | Customer's city |
| Account type | Savings or checking |
| Account number | Bank account number (numeric) |
| Document type | CC, CE, or NIT |
| Document number | Customer's identification number (numeric) |
| Account holder name | Name of the bank account holder |
Need help?
- Existing merchants: Email sales.engineering@ebanx.com for integration support.
- New to EBANX? Complete the Merchant Signup Form to contact our commercial team.