--- updatedAt: 2026-09-03T16:48:02.000Z agentTools: projectIndex: https://docs.dlocal.com/llms.txt --- # Colombia Learn everything you need to know to make payouts in Colombia with dLocal. [block:html] { "html": "\n \n
\n\n \n
\n
\n
\"\"
\n

Market specifications

\n

\n Take a look of all the information you need to make a payout. \n

\n Country reference\n Document validations\n Mandatory paramenters\n\n
\n
\n \n \n \n
\n
\"\"
\n

Payment methods

\n

\n Find all the information about payment methods capabilities. \n

\n Bank transfers\n Bre-B\n
\n
\n \n \n
\n
\n
\"\"
\n

Bank information

\n

\n Find all the bank account validations details you need to make a payout. \n

\n Bank account validations\n Bank codes\n
\n
\n \n " } [/block] *** # Market specifications Do you want to know more information about Colombia's market? Go to the [Colombia’s economy and eCommerce market](https://dlocal.com/payment-processors-in-latin-america/colombia-payment-methods-processors-ecommerce-market-dlocal/) article. ## Country reference | `country` code | `currency` code | `amount` decimals | `beneficiary.document.type` name | `beneficiary.document.id` format | | :------------: | :-------------: | :---------------: | :------------------------------: | :------------------------------: | | `CO` | `COP` | 0 | CC, NIT, PASS, CE, PEP | 6 to 15 characters | ## Document validations | Validation | Name | Length | Type | Verification digit | Example | | ---------- | ---- | -------- | ------------ | ------------------ | ----------------------------- | | Document | CC | 6 to 10 | numeric | No | 1.004.922.993
1004922993 | | Document | NIT | 10 to 11 | numeric | Last digit | 901.458.652-7
9014586527 | | Document | PASS | 12 to 15 | alphanumeric | No | AB123456789012 | | Document | CE | 12 to 15 | alphanumeric | No | CE123456789012 | | Document | PEP | 7 to 8 | numeric | No | 1234567
12345678 | ## Mandatory parameters ### Bank transfers | Bank transfer parameters | B2C | B2B | P2P | | :--------------------------------- | :-: | :-: | :-: | | `external_id` | Yes | Yes | Yes | | `payment_method_id` | Yes | Yes | Yes | | `flow_type` | Yes | Yes | Yes | | `purpose` | Yes | Yes | Yes | | `amount` | Yes | Yes | Yes | | `country` | Yes | Yes | Yes | | `currency` | Yes | Yes | Yes | | `beneficiary.document.id` | Yes | Yes | Yes | | `beneficiary.document.type` | Yes | Yes | Yes | | `beneficiary.first_name` | Yes | - | Yes | | `beneficiary.last_name` | Yes | - | Yes | | `beneficiary.business_name` | - | Yes | - | | `beneficiary.address.street` | Yes | Yes | Yes | | `beneficiary.bank_account.code` | Yes | Yes | Yes | | `beneficiary.bank_account.account` | Yes | Yes | Yes | | `beneficiary.bank_account.type` | Yes | Yes | Yes | | `remitter.first_name` | - | - | Yes | | `remitter.last_name` | - | - | Yes | | `remitter.address.street` | - | - | Yes | | `remitter.nationality` | - | - | Yes | ### Bre-B | Bre-B parameters | B2C | P2P | | :--------------------------------- | :-: | :-: | | `external_id` | Yes | Yes | | `payment_method_id` | Yes | Yes | | `flow_type` | Yes | Yes | | `purpose` | Yes | Yes | | `country` | Yes | Yes | | `amount` | Yes | Yes | | `currency` | Yes | Yes | | `beneficiary.first_name` | Yes | Yes | | `beneficiary.last_name` | Yes | Yes | | `beneficiary.document.id` | Yes | Yes | | `beneficiary.document.type` | Yes | Yes | | `beneficiary.address.street` | Yes | Yes | | `beneficiary.instant_payment.type` | Yes | Yes | | `beneficiary.instant_payment.id` | Yes | Yes | | `remitter.first_name` | - | Yes | | `remitter.last_name` | - | Yes | *** # Payment methods Colombia supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards. ## Bank transfers Bank transfers in Colombia require detailed account information, including document ID, document type, bank code, bank account number, account type, currency, amount, and address. The format of these fields depends on the receiving bank, and strict validation rules apply. Refer to the [document validations](#document-validations), [bank account validations](#bank-account-validations) and [bank codes](#bank-codes) sections for format specifications. ### Mandatory parameters All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types. | Mandatory parameter | Description | | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `external_id` | Payout identification at the merchant's end. Maximum 100 characters. | | `payment_method_id` | Payment method. For bank transfers, use `BANK_TRANSFER`. | | `flow_type` | Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person). | | `purpose` | Payout purpose code. See [purpose codes reference](https://docs.dlocal.com/docs/purpose-codes-reference-v3). | | `amount` | Payout amount in `COP`. For Colombian peso, use integers only (no decimal places). | | `country` | Country code. For Colombia, use `CO`. | | `currency` | Source currency of the FX operation. For Colombia, use `COP` or `USD`. Payouts are always paid in local currency to the beneficiary. | | `beneficiary.document.id` | Beneficiary's document ID or number. See [document validations](#document-validations) below. | | `beneficiary.document.type` | Beneficiary's document type: `NIT` - Número de Identificación Tributaria, `CC` - Cédula de Ciudadanía, `CE` - Carnet Extranjeria, `PASS` - Passport, `PEP` - Permiso Especial de Permanencia. | | `beneficiary.first_name` | Beneficiary's first name. Maximum 50 characters. | | `beneficiary.last_name` | Beneficiary's last name. Maximum 50 characters. | | `beneficiary.business_name` | Beneficiary's business name. Mandatory only for B2B. | | `beneficiary.address.street` | Street address of the beneficiary. Maximum 200 characters. | | `beneficiary.bank_account.code` | Beneficiary's bank account code. See the list of valid [bank codes](#bank-codes) below. | | `beneficiary.bank_account.account` | Beneficiary's bank account number. Format varies by bank. See [bank account validations](#bank-account-validations) below. | | `beneficiary.bank_account.type` | Beneficiary's bank account type. Account type:
`CHECKING`: Checking accounts
`SAVINGS`: Savings accounts | | `remitter.first_name` | Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P). | | `remitter.last_name` | Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P). | | `remitter.address.street` | Street address of the remitter. Maximum 200 characters. Mandatory only for remittance (P2P). | | `remitter.nationality` | Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P). | | `comments` | Additional information about the payment. If string `TRANSFIYA` is sent in this parameter, the payment will be routed through the 24/7 Transfiya network. | ### Example request ```json Bank transfers - B2C { "external_id": "1234567812345678b", "payment_method_id": "BANK_TRANSFER", "flow_type": "B2C", "purpose": "OTHER_SERVICES", "amount": 2000000000, "country": "CO", "currency": "COP", "beneficiary": { "document": { "id": "901.458.652-7", "type": "NIT" }, "first_name": "JUAN", "last_name": "RUIZ", "address": { "street": "calle 12# 12A - 12, Bogota" }, "bank_account": { "code": "007", "account": "1234567891", "type": "CHECKING" } } } ``` ```json Bank Transfer - P2P { "external_id": "1234567812345678p2p", "payment_method_id": "BANK_TRANSFER", "flow_type": "P2P", "purpose": "REMITTANCES", "amount": 2000000000, "country": "CO", "currency": "COP", "beneficiary": { "document": { "id": "1004922993", "type": "CC" }, "first_name": "JUAN", "last_name": "RUIZ", "phone": "+576010000000", "address": { "street": "calle 12# 12A - 12, Bogotá" }, "bank_account": { "code": "007", "account": "1234567891", "type": "CHECKING" } }, "remitter": { "first_name": "MARIA", "last_name": "LOPEZ", "address": { "street": "123 Main Street, Miami" }, "nationality": "US" } } ``` ```json Transfiya { "external_id": "1234567812345678p2p", "payment_method_id": "BANK_TRANSFER", "flow_type": "P2P", "purpose": "REMITTANCES", "amount": 2000000000, "country": "CO", "currency": "COP", "beneficiary": { "document": { "id": "1004922993", "type": "CC" }, "first_name": "JUAN", "last_name": "RUIZ", "address": { "street": "calle 12# 12A - 12, Bogotá" }, "bank_account": { "code": "007", "account": "1234567891", "type": "CHECKING" } }, "remitter": { "first_name": "MARIA", "last_name": "LOPEZ", "address": { "street": "123 Main Street, Miami" }, "nationality": "US" }, "comments": "TRANSFIYA" } ``` ## Bre-B Bre-B is Colombia’s government-backed, real-time payment rail, enabling instant, 24/7 account-to-account (A2A) transfers. Unlike traditional bank transfers, Bre-B allows payments to be routed using digital keys (llaves), such as phone numbers, national IDs, email addresses, or custom aliases, rather than full bank account details. ### Mandatory parameters All fields listed below are required for Bre-B payouts. For successful processing, ensure correct formatting and value types.
Mandatory parameter Description
`external_id` Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id` ID of the payment method. For Bre-B transactions, use `INSTANT_PAYMENT`.
`flow_type` Type of payment flow. Valid value: `B2C` (Business to Consumer) or `P2P` (Person to Person).
`purpose` Payout purpose code. See [purpose codes reference](https://docs.dlocal.com/docs/purpose-codes-reference-v3).
`country` Country code. For Colombia, use `CO`.
`amount` Source currency of the FX operation. Use up to 2 decimal numbers. The minimum amount for Bre-B is 1000 COP.
`currency` Payout currency. For Colombia, use `COP` or `USD`.
`beneficiary.first_name` Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name` Beneficiary's last name. Maximum 50 characters.
`beneficiary.document.type` Beneficiary's document type. Document type: `NIT` for Número de Identificación Tributaria, `CC` for Cédula de Ciudadanía, `CE` for Carnet Extranjeria, `PASS` for Passport, or `PEP` for Permiso Especial de Permanencia.
`beneficiary.document.id` Beneficiary's document ID or number. See [document validations](#document-validations) below.
`beneficiary.address.street` Street address of the beneficiary. Maximum 200 characters.
`beneficiary.instant_payment.type` Beneficiary's instant payment account type. For Bre-B, use `breb`.
`beneficiary.instant_payment.id` Bre-B digital key. The validations on this field depend on the type of Bre-B key used. The following is accepted: - **MSISDN** (phone): must be a 10-digit number starting with ‘3’. - **Alias**: must be an alphanumeric string 6 to 19 characters long, starting with ‘@’. - **Email**: must follow a valid email format and contain 10 to 92 alphanumeric characters. - **User Identification**: must be an alphanumeric string 5 to 18 characters long.
`remitter.first_name` Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name` Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
### Example request ```json Bre-B Transfer - B2C { "external_id": "1234567812345678breb", "payment_method_id": "INSTANT_PAYMENT", "flow_type": "B2C", "purpose": "OTHER_SERVICES", "country": "CO", "amount": 125800.00, "currency": "COP", "beneficiary": { "first_name": "DAVID", "last_name": "CIENFUEGOS", "document": { "type": "CC", "id": "1018417575" }, "address": { "street": "Calle 8" }, "instant_payment": { "type": "breb", "id": "3125888660" } } } ``` ```json Bew-B Transfer - P2P { "external_id": "1234567812345678breb", "payment_method_id": "INSTANT_PAYMENT", "flow_type": "P2P", "purpose": "OTHER_SERVICES", "country": "CO", "amount": 125800.00, "currency": "COP", "beneficiary": { "first_name": "DAVID", "last_name": "CIENFUEGOS", "document": { "type": "CC", "id": "1018417575" }, "address": { "street": "Calle 8" }, "instant_payment": { "type": "breb", "id": "3125888660" } }, "remitter": { "first_name": "MARIA", "last_name": "LOPEZ" } } } ``` # Bank information Access the reference formats and accepted values required for processing bank payouts in Colombia.
## Bank account validations
For every bank account the minimum length is 3 digits (they must be different from zero) and for the banks that do not have a maximum length on the following table, the maximum length is 18. | Bank | Bank code | Savings length (up to) | Checking length (up to) | Saving acc. example | Checking acc. Example | | ----------------------------------- | --------- | ------------------------------- | ---------------------------------------------------------- | ------------------- | --------------------- | | Agrario | 040 | 12 | 12 | 123456789012 | 123456789012 | | Av. Villas | 052 | 11 | 13 | 12345678901 | 1234567890123 | | Banco de Bogotá | 001 | 11 | 11 | 12345678912 | 12345678912 | | Banco de Occidente | 023 | 9 | 9 | 123456789 | 123456789 | | Bancolombia | 007 | 11 | 11 | 27213213912 | 96382852354 | | Bancoomeva | 061 | 12 | 12 | 123456789012 | 123456789012 | | BBVA | 013 | 16 | 16 (for payouts above 15K we only accept 9-digit accounts) | 1234567890123450 | 1234567890123450 | | Caja Social BCSC | 032 | 12 | 12 | 123456789012 | 123456789012 | | Confiar | 292 | 9 | 9 | 123456789 | 123456789 | | Coopcentral S.A. | 066 | - | 9 | - | 123456789 | | Cooperativa Financiera de Antioquía | 283 | - | 11 | - | 12345678901 | | Cotrafa Cooperativa Financiera | 289 | - | 13 | - | 1234567890123 | | Davivienda | 051 | 16 | 16 | 123456789012 | 123456789012 | | Davivienda - Transfiya | 051 | Accepts only 16-digit accounts. | Accepts only 16-digit accounts. | 1234567890123456 | 1234567890123456 | | Falabella S.A. | 062 | 12 | 12 | 123456789012 | 123456789012 | | Financiera Juriscoop | 121 | - | 12 | - | 123456789012 | | Itau | 014 | 9 | 9 | 123456789 | 123456789 | | Pichincha | 060 | 9 | 9 | 123456789 | 123456789 | | Popular | 002 | 9 | 9 | 620630925 | 645324752 | | Procredit | 058 | 13 | 13 | 1234567890123 | 1234567890123 | | Santander | 065 | 9 | 9 | 272132139 | 963828523 | | Scotiabank Colpatria | 019 | 10 | 10 | 1234567890 | 1234567890 | | Sudameris | 012 | 11 | 11 | 20834234590 | 10293845573 |
***
## Bank codes
These are the values the `beneficiary.bank_account.code` parameter can take in Colombia. | Bank Name | Bank Code | | :---------------------------------------- | :-------: | | Bancamia S.A. | 059 | | Banco Agrario | 040 | | Banco Av. Villas | 052 | | Banco Caja Social BCSC | 032 | | BAN100 S.A | 558 | | Banco Dale | 097 | | Banco Davivienda | 051 | | Banco de Bogotá | 001 | | Banco de Occidente | 023 | | Banco Falabella S.A. | 062 | | Banco Finandina S.A. | 063 | | Banco J.P. Morgan Colombia S.A. | 71 | | Banco Mundo Mujer | 047 | | Banco Pichincha | 060 | | Banco Popular | 002 | | Banco Santander de Negocios Colombia S.A. | 65 | | Banco Serfinanza S.A. | 069 | | Banco Sudameris | 012 | | Banco W S.A. | 053 | | Bancoldex S.A. | 031 | | Bancolombia | 007 | | Bancoomeva | 061 | | BBVA | 013 | | Citibank | 009 | | Coink | 812 | | Coltefinanciera S.A. | 370 | | Confiar | 292 | | Coopcentral S.A. | 066 | | Cooperativa Financiera de Antioquia | 283 | | Corpbanca Itau | 006 | | Cotrafa Cooperativa Financiera | 289 | | Daviplata | 551 | | Financiera Juriscoop | 121 | | Banco Union | 303 | | Iris | 637 | | Itau | 014 | | LULO BANK S.A. | 070 | | MiBanco S.A. | 067 | | Movii | 801 | | Nequi | 507 | | NU COLOMBIA | 809 | | Rappipay | 811 | | Scotiabank Colpatria | 019 |