Colombia
Check the requirements and validations made over the cashouts on Colombia

Required fields

Field
Format
Description
login
String
Cashouts login
pass
String
Cashouts pass
external_id
String (max length: 100)
Transaction's ID on your end
document_id
Beneficiary's document ID
document_type
Beneficiary's document type
country
CO
currency
COP / USD
amount
Number with up to 2 decimals
Cashout amount
bank_code
See bank codes
Code specifying the beneficiary's bank
bank_account
Beneficiary's bank account
account_type
Beneficiary's bank account type
beneficiary_name
String (max length: 100)
Beneficiary's name
beneficiary_lastname
String (max length: 100)
Beneficiary's last name
address
String (max length: 255)
Beneficiary's address
phone
String (max length: 20). See validations
Beneficiary's phone number

Bank Account Validations

Bank name
Bank code
Format
Regex
Example
Nequi
1507
Customer's mobile phone
^[\s\S]{1,20}$
5715551234
Daviplata
1551
Customer's mobile phone
^[\s\S]{1,20}$
5715551234
Baloto
10000
Empty string
^$
""
D24 Card
10001
Empty string
^$
""
Su Red
10002
Empty string
^$
""
Others
-
Numeric
^\d{8,19}$
1234567890123

Account Types

The account_type is specified with only one character as described below.
account_type
Description
C
Checkings account
S
Savings account

Document Validations

Click here to check document types and validations.

Phone validations

Bank name
Bank code
Format
Required
Example
Baloto
10000
Yes
+5715551234
Su Red
10002
Yes
Others
-
-
No
-

Example Request

Generic
Baloto / Su Red
D24 Card
1
{
2
"login": "xxxxxxxx",
3
"pass": "xxxxxxxx",
4
"external_id": "30000000001",
5
"country": "CO",
6
"currency": "COP",
7
"amount": 100,
8
"document_id": "848392783",
9
"document_type": "CC",
10
"bank_account": "56687456",
11
"bank_code": "001",
12
"account_type": "C",
13
"beneficiary_name": "User",
14
"beneficiary_lastname": "Test",
15
"address": "Calle 18, Colombia",
16
"notification_url": "https://webhook.site/url",
17
"type": "json"
18
}
Copied!
1
{
2
"login": "xxxxxxxx",
3
"pass": "xxxxxxxx",
4
"external_id": "30000000001",
5
"country": "CO",
6
"currency": "COP",
7
"amount": 100,
8
"document_id": "848392783",
9
"document_type": "CC",
10
"bank_account": "",
11
"bank_code": "10000", // 10000 for Baloto, 10002 for Su Red
12
"account_type": "S",
13
"phone": "+5715551234",
14
"beneficiary_name": "User",
15
"beneficiary_lastname": "Test",
16
"address": "Calle 18, Colombia",
17
"notification_url": "https://webhook.site/url",
18
"type": "json"
19
}
Copied!
1
{
2
"login": "xxxxxxxx",
3
"pass": "xxxxxxxx",
4
"external_id": "30000000002",
5
"country": "CO",
6
"currency": "COP",
7
"amount": 100,
8
"document_id": "848392783",
9
"document_type": "CC",
10
"bank_account": "",
11
"bank_code": "10001",
12
"account_type": "S",
13
"beneficiary_name": "User",
14
"beneficiary_lastname": "Test",
15
"address": "Calle 18, Colombia",
16
"notification_url": "https://webhook.site/url",
17
"type": "json"
18
}
Copied!

Bank Codes

Bank
Code
BANCO DE BOGOTÁ
001
BANCO POPULAR
002
ITAÚ - Antes CORPBANCA
006
BANCOLOMBIA
007
ABN AMRO
008
CITIBANK
009
HSBC
010
BANCO SUDAMERIS
012
BBVA
013
ITAÚ (HELM)
014
BANCO COLPATRIA
019
BANCO DE OCCIDENTE
023
BANCO CAJA SOCIAL BCSC
032
BANCO AGRARIO
040
BANCO DAVIVIENDA
051
BANCO AV VILLAS
052
BANCO PROCREDIT
058
BANCO PICHINCHA
060
BANCOOMEVA
061
For the full and most up-to-date list of banks and its codes, please check the Cashout Bank Code endpoint.