Colombia

The necessary information for Colombia is presented below in order to carry out a correct payout.

Mandatory parameters

Field	Description
country	String (Required, max-length = 3) ISO 3166-1-alpha-3. In the case of Colombia: COL
amount	Integer (Required max-lenght = 10) The amount of the transaction. The 2 last digits will be consider as decimal. Ex: 100000 equals "one thousand"
currency	String (Required, max-length = 3) The currency of the payroll. ISO-4217. In the case of Col: COP You can see the explication on Currencies
oderId	String (Required max-lenght = 20) Merchant transaction code (Purchase Order)
description	String (Optional max-lenght = 50) For customer use
beneficiary.name	String (Required) Name of the Beneficiary
beneficiary.lastName	String (Required) Last name of the Beneficiary
beneficiary.email	String (Optional max-lenght = 100) Beneficiary's email
beneficiary.document.type	Integer (Required) Type of Account of the beneficiary to pay. You must enter the numeric code as indicated
beneficiary.document.number	String (Required) Contains the beneficiary's document number.
destination.bankAccount.bankCode	String (Required) Codee of the receiving bank or financial institution.
destination.bankAccount.accountType	Integer (Required) Type of Account of the beneficiary to pay. You must enter the numeric code or the text as indicated.
destination.bankAccount.accountNumber	Integer (Required) Beneficiary's account number. In the case of Nequi (507), the merchant need to send the phone number on this field
destination.bankAccount.expirationDate	Integer (Required only for Cash) Expiration date to claim a Cash order. The format must be YYYY-MM-DD and in Local Time Zone (UTC-5). If "null", a default of 7 calendar days will be applied.
subMerchantInfo.code	String (Required only for PSP) Submerchant Identifier
subMerchantInfo.name	String (Required only for PSP) Submerchant Name
subMerchantInfo.url	String (Required only for PSP) Submerchant URL

IMPORTANT

For NEQUI and DAVIPLATA:

• The minimum amount allowed is 1,000 COP and the maximum amount allowed is 10,000,000 COP.

• The value of destination.bankAccount.accountType must be always Savings account (id = 2).

For EFECTY:

• The minimum amount allowed is 20,000 COP and the maximum amount allowed is 1,000,000 COP.

• The value of destination.bankAccount.accountType must be always Cash (id = 3).

• Expiration date cannot be the same day the order is sent, the day before, or exceed the following 7 calendar days.

• The beneficiary.email is mandatory. If "null", the order will be rejected. An OTP code will be sent to the beneficiary's email so they can claim their cashout.

For other banks:

• The minimum amount allowed is 1,000 COP

Request Example

Payout

{
	"country": "COL",
	"amount": 100000,
	"currency": "COP",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "[e-mail]",
		"document": {
			"type": 1,
			"number": "12345678"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "001",
			"accountType": "1",
			"accountNumber": "12345678912"
		}
	}
}

Nequi Payout (id 507) using document number and phone number

{
	"country": "COL",
	"amount": 100000,
	"currency": "COP",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "[e-mail]",
		"document": {
			"type": 1,
			"number": "1073695047"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "507",
			"accountType": "1",
			"accountNumber": "3005950540"
		}
	}
}

Time Outs

In the case of receiving a Time Out as a response from this API we recommend resending the payout again after 30 seconds using the same orderId.

This way we will check if the payout was processed and avoid double payments.

Document Validations

Parameter	ID Type	Length
1	CC	up to 13 digits
2	CE	up to 13 digits
3	PAS	up to 13 digits
4	TI	up to 13 digits
5	NIT	up to 13 digits

IMPORTANT

For NEQUI the available documents are:

• CC

• CE

• TI

Account Type

Parameter	Type
1	Current account
2	Savings account
3	Cash (Available from January 2025)

Bank List

ID	BANK NAME
001	BANCO DE BOGOTÁ
002	BANCO POPULAR
006	ITAÚ
007	BANCOLOMBIA
009	CITIBANK
012	BANCO GNB SUDAMERIS
013	BBVA COLOMBIA
019	SCOTIABANK COLPATRIA S.A.
023	BANCO DE OCCIDENTE
031	BANCOLDEX S.A.
032	BANCO CAJA SOCIAL BCSC S.A.
040	BANCO AGRARIO
041	JPMORGAN
042	BNP PARIBAS COLOMBIA
047	BANCO MUNDO MUJER
051	BANCO DAVIVIENDA S.A.
052	BANCO AV VILLAS
053	BANCO W S.A.
058	BANCO PROCREDIT COLOMBIA
059	BANCAMIA S.A.
060	BANCO PICHINCHA
061	BANCOOMEVA
062	BANCO FALABELLA S.A.
063	BANCO FINANDINA S.A.
064	BANCO MULTIBANK S.A.
065	BANCO SANTANDER DE NEGOCIOS COLOMBIA S.A.
066	BANCO COOPERATIVO COOPCENTRAL
067	BANCO COMPARTIR S.A.
069	BANCO SERFINANZA S.A.
070	LULO BANK
071	BANCO JP MORGAN COLOMBIA
083	COMPENSAR
084	APORTES EN LINEA
086	ASOPAGOS
087	FEDECAJAS
088	SIMPLE
089	ENLACE OPERATIVO
090	CORFICOLOMBIANA
099	EFECTY (Available from January 2025)
121	FINANCIERA JURISCOOP S.A. COMPAÑÍA DE FINANCIAMIENTO
283	COOPERATIVA FINANCIERA DE ANTIOQUIA
289	COOTRAFA COOPERATIVA FINANCIERA
292	CONFIAR
298	CONFIAR COOPERATIVA FINANCIERA
303	Banco Unión (GIROS Y FINANZAS)
342	SERVIFINANSA S.A.
370	COLTEFINANCIERA S.A.
507	NEQUI
550	DECEVAL
551	DAVIPLATA
560	PIBANK
637	IRIS
683	DIRECCIÓN DEL TESORO NACIONAL
685	DGCPTN SISTEMA GENERAL DE REGALIAS
801	MOVII
803	POWII
805	BANCO BTG PACTUAL
808	Bold CF
812	COINK
809	NU
814	Global66
819	Banco Contactar
1062	BANCO FALABELLA S.A.
1063	BANCO FINANDINA S.A.
1053	BANCO WWB
1069	BANCO SERFINANZA SA
1283	COOPERATIVA FINANCIERA DE ANTIOQUIA
1291	COOFINEP
1292	CONFIAR COOPERATIVA FINANCIERA
1558	Ban100 (CREDIFINANCIERA SA)