Skip to main content

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.

Customer document​

The document field is required. Provide document_type to specify the document.

Document TypeFormatDescription
CC2-15 digitsCedula de Ciudadania. National identity document for Colombian citizens. Default when document_type is omitted.
NIT2-15 digitsNumero de Identificacion Tributaria. Tax identification number for businesses.
CE2-15 digitsCedula de Extranjeria. Identity document for foreign nationals.

Currencies​

DetailValue
Local currencyCOP - Peso Colombiano
Accepted currenciesCOP

Taxes for local processing​

When this section applies

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:

JSON
{
"single_transaction": {
"amount_local": 99.85,
"amount_crossborder": 0.00
},
"taxes": {
"iva_co": 0.00
}
}

Validation errors​

Error codeCause
BP-TX-01single_transaction.amount_local is positive and the taxes object is missing.
BP-TX-02single_transaction.amount_local is positive and taxes.iva_co is missing.
BP-ST-00single_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:

FieldDescription
Bank nameMust be a supported Colombian bank
CityCustomer's city
Account typeSavings or checking
Account numberBank account number (numeric)
Document typeCC, CE, or NIT
Document numberCustomer's identification number (numeric)
Account holder nameName of the bank account holder

Need help?

Help Image