🇨🇴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	The country codes are in ISO 3166-1 alpha-2 format.
currency	COP / USD	The currencies are in ISO 4217 format.
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
email	String (max length: 255)	Optional Field - Only required for Punto Red

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
Efecty	10003	Empty string	^$
Punto Red	10006	Customer's mobile phone and customer's email	^[\s\S]{1,20}$	5715551234
Others	-		^\d{8,19}$	1234567890123

account_type

The account_type is specified with only one character as described below.

account_type	Description
C	Checkings account
S	Savings account

phone validations

Bank name	Bank code	Format	Required	Example
Efecty	10003	Numeric - Country code +57 plus 10 digits +57 XXX XXXXXXX	Yes	[phone]
Punto Red	10006	Numeric - Country code +57 plus 10 digits +57 XXX XXXXXXX	Yes	[phone]
Others	-	-	No	-

document_type and document_id validations

document_type	document_id format
CC	Numeric. Length between 6 and 10 inclusive
NIT	Numeric. Length between 8 and 15
CE	Numeric. Length between 6 and 10 inclusive
PASS	Numeric. Length between 6 and 10 inclusive

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"
}

Efecty

{
  "login": "xxxxxxxxx",
  "pass": "xxxxxxxxx",
  "external_id": "30000000002",
  "country": "CO",
  "currency": "COP",
  "amount": 100,
  "document_id": "24721498",
  "document_type": "CC",
  "cashout_type": "BANK",
  "bank_account": "",
  "bank_branch": "",
  "bank_code": 10003,
  "account_type": "S",
  "beneficiary_name": "User",
  "beneficiary_lastname": "Test",
  "address": "Calle 43"
  "email": "",
  "phone": "[phone]",
  "notification_url": "https://webhook.site/url",
}

Punto Red

{
  "login": "xxxxxxxxx",
  "pass": "xxxxxxxxx",
  "external_id": "30000000002",
  "country": "CO",
  "currency": "COP",
  "amount": 100,
  "document_id": "24721498",
  "document_type": "CC",
  "cashout_type": "BANK",
  "bank_account": "",
  "bank_branch": "",
  "bank_code": 10006,
  "account_type": "S",
  "beneficiary_name": "User",
  "beneficiary_lastname": "Test",
  "address": "Calle 43"
  "email": "[email protected]",
  "phone": "[phone]",
  "notification_url": "https://webhook.site/url",
}

Bank codes

Bank code retrieval via API

For the full and most up-to-date list of banks and its codes, please check this endpoint Get 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
BANCOLDEX S.A.	031
BANCO CAJA SOCIAL BCSC	032
BANCO AGRARIO	040
BANCO MUNDO MUJER	047
BANCO DAVIVIENDA	051
BANCO AV VILLAS	052
BANCO W S.A.	053
BANCO PROCREDIT	058
BANCAMIA S.A.	059
BANCO PICHINCHA	060
BANCOOMEVA	061
BANCO FALABELLA S.A	062
BANCO FINANDINA	063
BANCO MULTIBANK S.A.	064
SANTANDER	065
BANCO COMPARTIR S.A.	067
BANCO SERFINANZA S.A.	069
LULO BANK S.A	070
J.P. MORGAN COLOMBIA	071
COOPCENTRAL S.A.	076
BANCO DALE	097
Directa24	100
COOPERATIVA FINANCIERA DE ANTIOQUIA	283
COTRAFA COOPERATIVA FINANCIERA	289
COOFINEP	291
CONFIAR	292
FINANCIERA JURISCOOP	296
BANCO UNION	303
COLTEFINANCIERA	370
BANCO CREDIFINANCIERA S.A.	558
IRIS	637
MOVII	801
RAPPIPAY	811
BANCO W	1053
MIBANCO	1067
ASOPAGOSS	1086
JFK COOPERATIVA FINANCIERA	1286
NEQUI	1507
DAVIPLATA	1551
BAN100 CREDIFINANCIERA	1558
PIBANK	1560
DING TECNIPAGOS SA	1802
POWWI	1803
UALA	1804
BANCO BTG PACTUAL	1805
BOLD CF	1808
COINK	1812
GLOBAL66	1814
D24 Card	10001
Su Red	10002
Efecty	10003
TPAGA Wallet	10005
PUNTO RED	10006
Nubank	809