🇨🇴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	See document validations	Beneficiary's document ID
document_type	See document validations	Beneficiary's document type
country	CO	See country codes
currency	COP / USD	See currency codes
amount	Number with up to 2 decimals	Cashout amount
bank_code	See bank codes	Code specifying the beneficiary's bank
bank_account	See validations below	Beneficiary's bank account
account_type	See account type codes	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
D24 Card	10001	Empty string	^$	""
Su Red	10002	Empty string	^$	""
Efecty	10003	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
Su Red	10002	Valid phone number for Colombia.	Yes
Others	-	-	No	-

Example Request

Generic

{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000001",
    "country": "CO",
    "currency": "COP",
    "amount": 100,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "56687456",
    "bank_code": "001",
    "account_type": "C",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "address": "Calle 18, Colombia",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

Baloto / Su Red

{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000001",
    "country": "CO",
    "currency": "COP",
    "amount": 100,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "",
    "bank_code": "10000", // 10000 for Baloto, 10002 for Su Red
    "account_type": "S",
    "phone": "[phone]",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "address": "Calle 18, Colombia",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

D24 Card

{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000002",
    "country": "CO",
    "currency": "COP",
    "amount": 100,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "",
    "bank_code": "10001",
    "account_type": "S",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "address": "Calle 18, Colombia",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

Bank Codes

Bank	Code
BANCO DE BOGOTÁ	001
BANCO POPULAR	002
ITAÚ - Antes CORPBANCA	006
BANCOLOMBIA	007
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
BANCO FALABELLA S.A	062
SANTANDER	065
COOPCENTRAL S.A	076
Directa24	100
COOPERATIVA FINANCIERA DE ANTIOQUIA	283
COTRAFA COOPERATIVA FINANCIERA	289
CONFIAR	292
NEQUI	1507
DAVIPLATA	1551
Su Red	10002
Efecty	10003
TPAGA Wallet	10005

For the full and most up-to-date list of banks and its codes, please check the Cashout Bank Code endpoint.