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 and must be "00". 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. In Key Transfer this field is optional.

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 Real-time Payouts:

via Transfiya, the merchant could send the phone number on this field.
via Bre-B, the merchant must send the Bre-B key 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

Email Notification to the Beneficiary

It is now possible to automatically send emails to the beneficiary with the outcome of the Payout (success or rejected).

Requirements:

Request the activation of "Email notifications to the user" through your account manager.
Include the beneficiary.email parameter in each transaction. If this field is missing, the email will not be sent.

IMPORTANT

For NEQUI and DAVIPLATA:

The minimum amount allowed is 5,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) or Cellphone Number.

For Cash (Not Available):

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. If the parameter is not sended or is "null", a default of 7 calendar days will be applied.
The beneficiary.email is mandatory. An OTP code will be sent to the beneficiary's email so they can claim their cashout.
The bankAccount.accountNumber it´s optional only for Cash.

For other banks:

The minimum amount allowed is 1,000 COP

IMPORTANT

Real-Time Payouts via Transfiya – Colombia

Monnet offers real-time payouts to bank entities and digital wallets through the Transfiya channel using an "Account Number" or "Phone Number". This service is available on demand and requires prior configuration and approval through your account executive.

The maximum amount allowed is 5,000,000 COP.

IMPORTANT

Real-Time Payouts via Bre-b Key – Colombia Monnet offers real-time payouts using Bre-B Key Transactions. This service is available on demand and requires prior configuration and approval through your account executive. The maximum amount allowed is 12,110,000 COP.

Bre-B Key is alphanumeric and can have between 5 and 100 characters. Bre-B keys can be:

Phone number
National ID number
Email address
Alphanumeric code (this must start with @)

Request Example

Payout - Bank Transfer

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

Payout - Cash


{
    "country": "COL",
    "amount": 2000000,
    "currency": "COP",
    "orderId": "BJB_{{randomUUID}}",
    "beneficiary": {
        "name": "John {{randomFirstName}}",
        "lastName": "Doe {{randomLastName}}",
        "document": {
            "type": 1,
            "number": "1333888555"
        },
        "customerId": "{{randomUUID}}",
        "userName": "John Doe",
        "email": "[email protected]"
    },
    "destination": {
        "bankAccount": {
            "bankCode": "099",
            "accountType": 3,
            "accountNumber": "123456789",
            "expirationDate": "2025-05-16"
        }
    }
}

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": "[email protected]",
		"document": {
			"type": 1,
			"number": "1073695047"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "507",
			"accountType": "4",
			"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

up to 13 digits

PAS

up to 13 digits

NIT

up to 13 digits

NUIP

up to 10 digits

PEP

7 to 15 digits

PPT

10 to 15 digits

IMPORTANT

For NEQUI the available documents are:

CC
CE
TI
NUIP
PPT

Account Type

Parameter

Type

Current account

Savings account

Cash (Not available)

Cellphone Number (Available from Q3 2025)

Bre-b key

Bank List

Last updated 12 days ago

hashtagMandatory parameters

hashtagRequest Example

hashtagDocument Validations

hashtagAccount Type

hashtagBank List

Mandatory parameters

Request Example

Document Validations

Account Type

Bank List