Mandatory parameters - Bank transfers

Mandatory parameterDescription
login32 chars
pass32 chars
external_idMax. 100 chars
document_idSee document validations below.
document_typeNIT - Número de Identificación Tributaria
CC - Cédula de Ciudadanía
CE - Carnet Extranjeria
PASS - Passport
PEP - Permiso Especial de Permanencia
beneficiary_nameMax. 50 chars
beneficiary_lastnameMax. 50 chars
countryCO
bank_codeSee bank codes below. ​
bank_accountSee bank account validations below. ​
account_typeC: for Checking accounts
S: for Savings accounts
currencyCOP or USD
amountMax. 2 decimal numbers
addressMax. 200 chars
emailEmail format - Max. 100 chars
phoneMax. 20 chars
purposeEPREMT - remittance
Mandatory only for remittance (C2C)
remitter_full_nameMandatory only for remittance. Max. 200 chars
remitter_addressMandatory only for remittance. Max. 200 chars
remitter_countryMandatory only for remittance. ISO 3166- 1 alpha -2 code

Example request

{
"login":"1n234n56",
"pass":"HolAc123o",
"external_id":"1234567812345678b",
"document_id":"901.458.652-7",
"country":"CO",
"bank_branch":"",
"bank_account":"1234567891",
"account_type":"C",
"currency":"COP",
"amount":"2000000000.00",
"type":"json",
"notification_url":"",
"bank_code":"7",
"comments":"",
"on_hold":"",
"beneficiary_name":"JUAN",
"beneficiary_lastname":"RUIZ",
"address":"calle 12# 12A - 12, Bogota",
"city":"",
"postal_code":"",
"email":"[email protected]",
"bdate":"",
"extra_info":"",
"bank_province":"",
"bank_city":"",
"bank_branch_name":"",
"document_type":"NIT",
"purpose":"",
}

Mandatory parameters - Transfiya payments

Mandatory parameterDescription
login32 chars
pass32 chars
external_idMax. 100 chars
beneficiary_nameMax. 50 chars
beneficiary_lastnameMax. 50 chars
countryCO
currencyCOP
amountMax. 2 decimal numbers
account_typetransfiya
phoneMax. 12 chars
Phone can be sent either with 10 digits (e.g. 1234567890) or with the country code plus 10 digits (e.g. +571234567890)

Example request

{
"login":"1n234n56",
"pass":"HolAc123o",
"external_id":"1234567812345678b",
"beneficiary_name":"JUAN",
"beneficiary_lastname":"RUIZ",
"country":"CO",
"currency":"COP",
"amount":"200000.00",
"account_type":"transfiya",
"phone":"+571234567890",
"notification_url":"https://thisisawebsite.net/payments",
"type":"json"
}

Document validations

ValidationNameLengthTypeVerification digitExample
DocumentCCBetween 6 to 10numericNo1.004.922.993
1004922993
DocumentNIT10 or 11numericLast digit901.458.652-7
901458.6527
DocumentPASSup to 12charactersNo
DocumentCEup to 12charactersNo
DocumentPEP15numericNo

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.

Some banks require a specific structure for the bank_account field:

BankBank codeSavings length (up to)Checking length (up to)Saving acc. exampleChecking acc. Example
Agrario0401212123456789012123456789012
Av. Villas0521113123456789011234567890123
Banco de Bogota00111111234567891212345678912
Banco de Occidente02399123456789123456789
Bancolombia00711112721321391296382852354
Bancoomeva0611212123456789012123456789012
BBVA0131616 (for payouts above 15K we only accept 9 digit accounts)12345678901234501234567890123450
Caja social BCSC0321212123456789012123456789012
Confiar29299123456789123456789
Coopcentral S.A.066-9-123456789
Cooperativa financiera de Antioquía283-11-12345678901
Cotrafa cooperativa financiera289-13-1234567890123
Davivienda0511818123456789012123456789012
Falabella S.A.0621212123456789012123456789012
Financiera Juriscoop121-12-123456789012
Itau01499123456789123456789
Pichincha06099123456789123456789
Popular00299620630925645324752
Procredit058131312345678901231234567890123
Santander00699272132139963828523
Scotiabank Colpatria019101012345678901234567890
Sudameris012811208342345908754102938455738947

Bank codes

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

Bank NameBank Code
Bancamia S.A.059
Banco Agrario040
Banco Av. Villas052
Banco Caja Social BCSC032
Banco Credifinanciera S.A.558
Banco Dale097
Banco Davivienda051
Banco de Bogota001
Banco de Occidente023
Banco Falabella S.A.062
Banco Finandina S.A.063
Banco J.P. Morgan Colombia S.A.71
Banco Mundo Mujer047
Banco Pichincha060
Banco Popular002
Banco Procredit058
Banco Santander de Negocios Colombia S.A.65
Banco Serfinanza S.A.069
Banco Sudameris012
Banco W S.A.053
Bancoldex S.A.031
Bancolombia007
Bancoomeva061
BBVA013
Citibank009
Coltefinanciera S.A.370
Confiar292
Coofinep Cooperativa Financiera291
Coopcentral S.A.066
Cooperativa Financiera de Antioquia283
Corpbanca Itau ​006
Cotrafa Cooperativa Financiera289
Daviplata551
Financiera Juriscoop121
Giros y Finanzas CF303
Iris637
Itau014
LULO BANK S.A.070
MiBanco S.A. ​067
Movii801
Nequi507
Rappipay151
Scotiabank Colpatria019