Colombia

Detail of fields for transaction processing in Colombia.

AttributeData TypeMandatory
order_idString [max_length: 40][max_length: 40]Yes
credit_noteString [max_length: 40][max_length: 40]Yes
account_idInteger [max_length:20][max_length:20] Use numbers onlyYes
account_type

String [max_length:9][max_length:9]

Allow values:
  • CC (Checking Account)
  • CH (Savings Account)
  • DP (Electronic Deposit)
Yes
vat_idInteger [max_length:11][max_length:11]
Use numbers only
Yes
vat_id_type

String [max_length:4][max_length:4]

Allow values:
  • CC (Cédula de Ciudadanía)
  • NIT (Número de Identificación Tributaria)
  • CE (Cédula de Extranjería)
  • PA (Pasaporte)
  • TI (Tarjeta de Identidad)
  • PPT (Permiso por Protección Temporal)
Allow values only for Nequi:
  • CC (Cédula de Ciudadanía)
  • CE (Cédula de Extranjería)
  • TI (Tarjeta de Identidad)
  • PPT (Permiso por Protección Temporal)
No
nameString [max_length:100][max_length:100]Yes
amountdecimalYes
subjectString [max_length:100][max_length:100]
Example: Withdrawal request
Yes
bank_detailString [max_length:100][max_length:100]
Example: User withdrawal request
Yes
channelString [max_length:100][max_length:100]
Example: Transfer request
Yes
user_emailString [max_length:100][max_length:100]
Example: [email protected]
Yes
phone_numberString [max_length:30][max_length:30]
Example: +57111111111
Yes
bankId value according to bank from /api/banks/?country=CO&fields=id,nameYes
currency

Id value from /api/currencies/

Allow currencies:
  • COP
Ye

Payment provider Cobre

List of payment providers and account types accepted.

Account type

CodeDescription
ccChecking Account
chSavings Account
dpElectronic deposit

Payment providers

📘

To retrieve the most up-to-date list of supported payment providers (banks), please use the following endpoint: /api/banks/?country=CO. For detailed parameter information, refer to the Bank List Documentation.

Ensure the country query parameter is set to the correct ISO code (e.g., CO for Colombia).