Market specifications

Do you want to know more information about Colombia's market? Go to the Colombia’s economy and eCommerce market article.

Country reference

`country` code	`currency` code	`amount` decimals	`document_type` name	`document_id` format
`CO`	`COP`	0	CC o NIT	Between 6 to 11 digits

Document validations

Validation	Name	Length	Type	Verification digit	Example
Document	CC	Between 6 to 10	numeric	No	1.004.922.993 1004922993
Document	NIT	10 or 11	numeric	Last digit	901.458.652-7 901458.6527
Document	PASS	up to 12	characters	No	-
Document	CE	up to 12	characters	No	-
Document	PEP	15	numeric	No	-

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`login`	Yes	Yes	Yes
`pass`	Yes	Yes	Yes
`external_id`	Yes	Yes	Yes
`document_id`	Yes	Yes	Yes
`document_type`	Yes	Yes	Yes
`beneficiary_name`	Yes	Yes	Yes
`beneficiary_lastname`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`bank_code`	Yes	Yes	Yes
`bank_account`	Yes	Yes	Yes
`account_type`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`address`	Yes	Yes	Yes
`comments`	Yes	Yes	Yes
`purpose`	-	-	Yes
`remitter_full_name`	-	-	Yes
`remitter_address`	-	-	Yes
`remitter_country`	-	-	Yes

Bre-B

Bank transfer parameters	B2C
`login`	Yes
`pass`	Yes
`external_id`	Yes
`country`	Yes
`amount`	Yes
`currency`	Yes
`account_type`	Yes
`document_id`	Yes
`document_type`	Yes
`beneficiary_name`	Yes
`beneficiary_lastname`	Yes
`bank_account`	Yes

Payment methods

Colombia supports payouts via Bank transfers and Bre-B. Both methods require specific parameters and follow validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in Colombia require detailed account information, including document ID, document type, bank code, bank account number, account type, currency, amount, and address. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the document validations, bank account validations and bank codes sections for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`login`	API authentication credentials. Maximum 32 characters.
`pass`	API authentication credentials. Maximum 32 characters.
`external_id`	Unique transaction identifier. Maximum 100 characters.
`document_id`	Document ID of the beneficiary. See document validations below.
`document_type`	Document type: `NIT` - Número de Identificación Tributaria, `CC` - Cédula de Ciudadanía, `CE` - Carnet Extranjeria, `PASS` - Passport, `PEP` - Permiso Especial de Permanencia.
`beneficiary_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary_lastname`	Last name of the beneficiary. Maximum 50 characters.
`country`	Country code. For Colombia, use `CO`.
`bank_code`	Bank code of the beneficiary's bank. See bank codes below.
`bank_account`	Bank account number. See bank account validations below.
`account_type`	Account type: `C`: for Checking accounts, `S`: for Savings accounts.
`currency`	Payout currency. For Colombia, use `COP` or `USD`.
`amount`	Payout amount. Use up to 2 decimal numbers.
`address`	Full address. Maximum 200 characters.
`comments`	If string `TRANSFIYA` is sent in this parameter, the payment will be routed through the 24/7 Transfiya network.
`purpose`	Reason for the payout: `EPREMT` - remittance. Mandatory only for remittance (P2P).
`remitter_full_name`	Full name of the sender. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter_address`	Full address of the sender. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter_country`	ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P).

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "1234567812345678b",
  "document_id": "901.458.652-7",
  "document_type": "NIT",
  "beneficiary_name": "JUAN",
  "beneficiary_lastname": "RUIZ",
  "country": "CO",
  "bank_code": "007",
  "bank_account": "1234567891",
  "account_type": "C",
  "currency": "COP",
  "amount": "2000000000.00",
  "address": "calle 12# 12A - 12, Bogota"
}

Bre-B

Bre-B is Colombia’s government-backed, real-time payment rail, enabling instant, 24/7 account-to-account (A2A) transfers.

Unlike traditional bank transfers, Bre-B allows payments to be routed using digital keys (llaves), such as phone numbers, national IDs, email addresses, or custom aliases, rather than full bank account details.

Mandatory parameters

All fields listed below are required for Bre-B payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`login`	API authentication credentials. Maximum 32 characters.
`pass`	API authentication credentials. Maximum 32 characters.
`external_id`	Unique transaction identifier. Maximum 100 characters.
`country`	Country code. For Colombia, use `CO`.
`amount`	Payout amount. Use up to 2 decimal numbers. The minimum amount for BreB is 1000 COP.
`currency`	Payout currency. For Colombia, use `COP` or `USD`.
`account_type`	Account type. For Bre-B, use `breb`.
`document_id`	Document ID of the beneficiary. See document validations below.
`document_type`	Document type: `NIT` - Número de Identificación Tributaria, `CC` - Cédula de Ciudadanía, `CE` - Carnet Extranjeria, `PASS` - Passport, `PEP` - Permiso Especial de Permanencia.
`beneficiary_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary_lastname`	Last name of the beneficiary. Maximum 50 characters.
`bank_account`	Bank account number. The validations on this field depend on the type of Bre-B key used. The following is accepted: - MSISDN (phone): must be a 10-digit number starting with ‘3’. - Alias: must be an alphanumeric string 6 to 19 characters long, starting with ‘@’. - Email: must follow a valid email format and contain 10 to 92 alphanumeric characters. - User Identification: must be an alphanumeric string 5 to 18 characters long.

Example request

{
  "login": "userco",
  "pass": "passco",
  "external_id": "BREB_TRX_TEST_001",
  "country": "CO",
  "amount": "1258",
  "currency": "COP",
  "account_type": "breb",
  "document_id": "1018417575",
  "document_type": "CC",
  "beneficiary_name": "David",
  "beneficiary_lastname": "Cienfuegos",
  "bank_account": "3125888660"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Colombia.

Bank account validations

For every bank account the minimum length is 3 digits (they have to be different to cero) and for the banks that do not have a maximum length on the following table, the maximum length is 18.

Bank	Bank code	Savings length (up to)	Checking length (up to)	Saving acc. example	Checking acc. Example
Agrario	040	12	12	123456789012	123456789012
Av. Villas	052	11	13	12345678901	1234567890123
Banco de Bogota	001	11	11	12345678912	12345678912
Banco de Occidente	023	9	9	123456789	123456789
Bancolombia	007	11	11	27213213912	96382852354
Bancoomeva	061	12	12	123456789012	123456789012
BBVA	013	16	16 (for payouts above 15K we only accept 9-digit accounts)	1234567890123450	1234567890123450
Caja Social BCSC	032	12	12	123456789012	123456789012
Confiar	292	9	9	123456789	123456789
Coopcentral S.A.	066	-	9	-	123456789
Cooperativa Financiera de Antioquía	283	-	11	-	12345678901
Cotrafa Cooperativa Financiera	289	-	13	-	1234567890123
Davivienda	051	16	16	123456789012	123456789012
Davivienda - Transfiya	051	Accepts only 16-digit accounts.	Accepts only 16-digit accounts.	1234567890123456	1234567890123456
Falabella S.A.	062	12	12	123456789012	123456789012
Financiera Juriscoop	121	-	12	-	123456789012
Itau	014	9	9	123456789	123456789
Pichincha	060	9	9	123456789	123456789
Popular	002	9	9	620630925	645324752
Procredit	058	13	13	1234567890123	1234567890123
Santander	065	9	9	272132139	963828523
Scotiabank Colpatria	019	10	10	1234567890	1234567890
Sudameris	012	11	11	20834234590	10293845573

Bank codes

These are the values the bank_code parameter can take in Colombia.

Bank Name	Bank Code
Bancamia S.A.	059
Banco Agrario	040
Banco Av. Villas	052
Banco Caja Social BCSC	032
BAN100 S.A	558
Banco Dale	097
Banco Davivienda	051
Banco de Bogota	001
Banco de Occidente	023
Banco Falabella S.A.	062
Banco Finandina S.A.	063
Banco J.P. Morgan Colombia S.A.	71
Banco Mundo Mujer	047
Banco Pichincha	060
Banco Popular	002
Banco Santander de Negocios Colombia S.A.	65
Banco Serfinanza S.A.	069
Banco Sudameris	012
Banco W S.A.	053
Bancoldex S.A.	031
Bancolombia	007
Bancoomeva	061
BBVA	013
Citibank	009
Coink	812
Coltefinanciera S.A.	370
Confiar	292
Coopcentral S.A.	066
Cooperativa Financiera de Antioquia	283
Corpbanca Itau	006
Cotrafa Cooperativa Financiera	289
Daviplata	551
Financiera Juriscoop	121
Banco Union	303
Iris	637
Itau	014
LULO BANK S.A.	070
MiBanco S.A.	067
Movii	801
Nequi	507
NU COLOMBIA	809
Rappipay	811
Scotiabank Colpatria	019