🇨🇴Colombia

Instant Transfer - Transfiya

• payout_method.type = bank_transfer

• payout_method.payment_method = instant_transfer

Example Instant Transfer Payload

Example Request

{
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "instant_transfer",
        "beneficiary": {
            "name": "John Doe",
            "payout_method_details": {
                "first_name": "John",
                "last_name": "Doe",
                "phone_number": "[phone]",
                "bank_code": "TRANSFIYA"
            }
        }
    },
    "amount": {
        "value": "2000.00",
        "currency_code": "COP"
    },
    "country_code": "CO",
    "purpose": "salaries",
    "reference": "Invoice #12345",
    "request_id": "unique_request_id"
}

Example Response

{
    "purpose": "SALARIES",
    "reference": "Invoice #12345",
    "id": "694e1f99-8924-4767-ade4-0db7c4e03f7a",
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "co_instant_transfer",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 2000.00,
        "currency_code": "COP"
    },
    "country_code": "CO",
    "request_id": "unique_request_id",
    "created_at": 1717576191
}

Bank Transfer

• payout_method.type = bank_transfer

• payout_method.payment_method = bank_transfer

Note: Wallets are supported – Dale, Nequi, Daviplate,Iirs, Movi, Rappipay.

They can be found in the Colombia Bank Codes section.

Example Bank Transfer Payload

Example Request

{
  "payout_method": {
    "type": "bank_transfer",
    "payment_method": "bank_transfer",
    "beneficiary": {
      "name": "John Doe",
      "payout_method_details": {
        "first_name": "John",
        "last_name": "Doe",
        "phone_number": "[phone]",
        "email": "[e-mail]",
        "address": "123 Main St, Bogotá, Colombia",
        "document_type": "CC",
        "document_id": "1004922993",
        "account_number": "123456789012",
        "account_type": "S",
        "bank_code": "059"
      }
    }
  },
  "amount": {
    "value": 2000.00,
    "currency_code": "COP"
  },
  "country_code": "CO",
  "purpose": "salaries",
  "reference": "Invoice #12345",
  "request_id": "unique_request_id"
}

Example Response

{
    "purpose": "SALARIES",
    "reference": "Invoice #12345",
    "id": "ff5b3a77-0e67-47a8-94f4-f2ac1865cd8b",
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "co_bank_transfer",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 2000,
        "currency_code": "COP"
    },
    "country_code": "CO",
    "request_id": "unique_request_id",
    "created_at": 1717576785
}

Colombia Document ID Validation

Colombia Bank Account Number Validation

For every bank account the minimum length is 3 digits. For the banks that do not have a maximum length in the following table, the maximum length is 18.

Some banks require a specific structure for the account_number field:

Colombia Bank Codes