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.

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.

destination.bankAccount.AdittionalAccountInfo

Integer (Optional) Required field only if the merchant has "User Enrollment" enabled for real-time payments with "Transfiya".

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 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) or Cellphone Number.

For Cash:

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 (Available from Q3 2025)

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

"User enrollment" for beneficiaries not registered in Transfiya: Merchants with this functionality enabled can register beneficiaries who are not currently enrolled in Transfiya. This requires a specific configuration on your merchant credential, which can be done immediately through your account executive.

Technical considerations for "User enrollment in Transfiya": If your credential has the user enrollment feature enabled, the following conditions must be met to avoid payment rejections:

If accountType is "Cellphone Number" and BankCode is different from Nequi, DaviPlata, Dale, Bold, Powwi or Movii then the "bank account number" must be provided in AdditionalAccountInfo.
If accountType is "Savings Account" o "Current Account", then the phone number must be provided in AdditionalAccountInfo.
AdditionalAccountInfo must not have the same value as accountNumber.

The beneficiary will receive an SMS notification prompting them to register with Transfiya. If they do not complete the enrollment, the payout will be rejected.

Finally, if the beneficiary registers with a different financial entity than the one instructed by the merchant, a second registration attempt will be made. If the beneficiary again registers with a different entity, the payment will be rejected.

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": "1",
			"accountNumber": "3005950540"
		}
	}
}

Payout - Real-Time (Transfiya) - User Enrollment enabled (New Parameter: "AdditionalAccountInfo")

{
	"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": "007",
			"accountType": "4",
			"accountNumber": "3008367989"
			"AdditionalAccountInfo": "34225420698"
		}
	}
}

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

IMPORTANT

For NEQUI the available documents are:

Account Type

Parameter

Type

Current account

Savings account

Cash (Available from Q4 2025)

Cellphone Number (Available from Q3 2025)

Bank List

Last updated 31 minutes ago