Skip to main content

Payout to Colombia (Bank Transfer)

To send a payout to Colombia, set the payout_method to BANK_TRANSFER. The required_CO object must include both the bank_code, account_type, account_number, tax_id, tax_id_type, of the recipient.

  POST https://api-sandbox.letpay.io/payoutTransaction

Body​

tax_id_type​

string, required

This field specifies the type of identification document.

Allowed values:

  • CC: Identity Document in Colombia.
  • NIT: Tax ID number in Colombia.
  • CE: Foreign resident card in Colombia.
  • TI: Identity Card in Colombia.
  • PP: Passport in Mexico and Colombia.

tax_id​

string, required

This field contains the identification document number.

bank_code​

string, required

This field contains the bank code.

  • If the accountType is NC, this field is optional.

account_type​

string, required

This field defines the bank account type.

Allowed values:

  • CC: Current Account in Colombia.
  • CA: Savings Account in Colombia.
  • NC: Cellphone Number. Colombia (Transfiya).
  • DE: Electronic deposit in Colombia.

account_number​

string, required

This field contains the bank account number.

  • If the accountType is NC, you must add the prefix 57.

Example Request​

{
    "payoutTransactions": [
        {
            "original_amount": 200.00,
            "original_currency": "COP",
            "payment_currency": "COP",
            "payment_country": "CO",
            "payout_method": "BANK_TRANSFER",
            "contract_id": "MY_PAYOUT_CONTRACT_ID",
            "reference_id": "MY_REFERENCE_ID",
            "notification_url": "https://my.notification.url/callback",
            "ttl": 0,
            "required_CO": {
                "bank_code": "1019",
                "account_type": "CA",
                "account_number": "123456",
                "tax_id": "123456789",
                "tax_id_type": "NIT"
            }
        }
    ]
}

Example Response​

{
    "payoutTransactionResponses": [
        {
            "tx_id": "PAYOUT_REFERENCE_ID",
            "reference_id": "MY_REFERENCE_ID",
            "amount": 200,
            "original_amount": 200,
            "original_asset": "COP",
            "customer_fees": 0,
            "customer_amount": 200,
            "merchant_fees": 0,
            "merchant_amount": 200,
            "asset": "COP",
            "banking_data": "1019:CA:123456",
            "status": "CREATED"
        }
    ],
    "refresh_token": "MY_ACCESS_TOKEN"
}