Colombia

Mandatory parameters

Mandatory parameter
Validations
login
32 chars
pass
32 chars
external_id
Max. 100 chars
document_id
See document validations here
document_type
NIT
CC
CE - Carnet Extranjeria
PASS - Passport
beneficiary_name
Max. 100 chars
beneficiary_lastname
Max. 100 chars
country
CO
bank_code
See bank codes here
bank_account
See bank account validations here
account_type
C: for Checking accounts
S: for Savings accounts
amount
Max. 2 decimal numbers
address
Max. 200 chars
email
Email format - Max. 100 chars
phone
Max. 20 chars

Example request

1
{
2
"login":"1n234n56",
3
"pass":"HolAc123o",
4
"external_id":"1234567812345678b",
5
"document_id":"901.458.652-7",
6
"country":"CO",
7
"bank_branch":"",
8
"bank_account":"1234567891",
9
"account_type":"C",
10
"currency":"COP",
11
"amount":"2000000000.00",
12
"type":"json",
13
"notification_url":"",
14
"bank_code":"7",
15
"comments":"",
16
"on_hold":"",
17
"beneficiary_name":"JUAN",
18
"beneficiary_lastname":"RUIZ",
19
"address":"calle 12# 12A - 12, Bogota",
20
"city":"",
21
"postal_code":"",
22
23
"bdate":"",
24
"extra_info":"",
25
"bank_province":"",
26
"bank_city":"",
27
"bank_branch_name":"",
28
"document_type":"NIT",
29
"purpose":"",
30
}
Copied!

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
numeric
Last digit
901.458.652-7
901458.6527
Document
PASS
up to 12
characters
No
Document
CE
up to 12
characters
No

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:
Bank
Bank code
Savings length (up to)
Checking length (up to)
Saving acc. example
Checking acc. Example
Popular
002
9
9
620630925
645324752
Santander
006
9
9
272132139
963828523
Bancolombia
007
11
11
27213213912
96382852354
HSBC
010
15
15
208342345908754
102938455738947
Sudameris
012
8
11
208342345908754
102938455738947
BBVA
013
16
16 (for payouts above 15K we only accept 9 digit accounts)
1234567890123456
1234567890123456
Itau
014
9
9
123456789
123456789
Scotiabank Colpatria
019
10
10
1234567890
1234567890
Banco de Occidente
023
9
9
123456789
123456789
Caja social BCSC
032
12
12
123456789012
123456789012
Agrario
040
12
12
123456789012
123456789012
Davivienda
051
18
18
123456789012
123456789012
Av. Villas
052
11
13
12345678901
1234567890123
Procredit
058
13
13
1234567890123
1234567890123
Pichincha
060
9
9
123456789
123456789
Bancoomeva
061
12
12
123456789012
123456789012
Falabella S.A.
062
12
12
123456789012
123456789012
Coopcentral S.A.
076
------
9
------
123456789
Cooperativa financiera de Antioquía
283
------
11
------
12345678901
Cotrafa cooperativa financiera
289
------
13
------
1234567890123
Confiar
292
9
9
123456789
123456789
Financiera Juriscoop
296
------
12
------
123456789012
Banco de Bogota
001
11
11
12345678912
12345678912

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
Scotiabank Colpatria
019
Banco Compartir S.A.
067
Banco Davivienda
051
Banco de Bogota
001
Banco de Occidente
023
Banco Falabella S.A.
062
Banco Finandina S.A.
063
Banco Multibank S.A.
064
Banco Mundo Mujer
047
Banco Pichincha
060
Banco Popular
002
Banco Procredit
058
Banco Santander
006
Banco Serfinanza S.A.
069
Banco Sudameris
012
Banco W S.A.
053
Bancoldex S.A.
031
Bancolombia
007
Bancoomeva
061
BBVA
013
Coltefinanciera S.A.
370
Confiar
292
Coopcentral S.A.
076
Cooperativa Financiera de Antioquia
283
Cotrafa Cooperativa Financiera
289
Daviplata
551
Financiera Juriscoop
296
HSBC
010
Itau
014
Nequi
507
Banco Dale
097
Last modified 3mo ago