> For the complete documentation index, see [llms.txt](https://apidocs.onekeypayments.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.onekeypayments.com/guides/cashouts/countries-validations/american-countries/colombia.md). # Colombia ## Required fields | Field | Format | Description | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | | `login` | String | Cashouts login | | `pass` | String | Cashouts pass | | `external_id` | String (max length: 100) | Transaction's ID on your end | | `document_id` | See [document validations](/guides/cashouts/countries-validations/american-countries/colombia.md#document-validations) | Beneficiary's document ID | | `document_type` | See [document validations](/guides/cashouts/countries-validations/american-countries/colombia.md#document-validations) | Beneficiary's document type | | `country` | `CO` | The country codes are in ISO 3166-1 alpha-2 format. | | `currency` | `COP` / `USD` | The currencies are in ISO 4217 format. | | `amount` | Number with up to 2 decimals | Cashout amount | | `bank_code` | See [bank codes](/guides/cashouts/countries-validations/american-countries/colombia.md#bank-codes) | Code specifying the beneficiary's bank | | `bank_account` | See [validations below](/guides/cashouts/countries-validations/american-countries/colombia.md#bank-account-validations) | Beneficiary's bank account | | `account_type` | See [account type codes](/guides/cashouts/countries-validations/american-countries/colombia.md#account-types) | Beneficiary's bank account type | | `beneficiary_name` | String (max length: 100) | Beneficiary's name | | `beneficiary_lastname` | String (max length: 100) | Beneficiary's last name | | `address` | String (max length: 255) | Beneficiary's address | | `phone` | String (max length: 20). [See validations](/guides/cashouts/countries-validations/american-countries/colombia.md#phone-validations) | Beneficiary's phone number | | `email` | String (max length: 255) | Optional Field - Only required for Punto Red | ### `bank_account` validations | Bank name | Bank code | Format | Regex | Example | | --------- | :-------: | -------------------------------------------- | ---------------- | ------------- | | Nequi | 1507 | Customer's mobile phone | `^[\s\S]{1,20}$` | 5715551234 | | Daviplata | 1551 | Customer's mobile phone | `^[\s\S]{1,20}$` | 5715551234 | | Efecty | 10003 | Empty string | `^$` | | | Punto Red | 10006 | Customer's mobile phone and customer's email | `^[\s\S]{1,20}$` | 5715551234 | | Others | - | Numeric[^1] | `^\d{8,19}$` | 1234567890123 | ### `account_type` The `account_type` is specified with only one character as described below. | account\_type | Description | | :-----------: | ----------------- | | **`C`** | Checkings account | | **`S`** | Savings account | ### `phone` validations
Bank nameBank codeFormatRequiredExample
Efecty10003Numeric - Country code +57 plus 10 digits
+57 XXX XXXXXXX		Yes+57 310 4028587
Punto Red10006Numeric - Country code +57 plus 10 digits
+57 XXX XXXXXXX		Yes+57 310 4028587
Others--No-
### `document_type` and `document_id` validations
document_typedocument_id format
CCNumeric. Length between 6 and 10 inclusive
NITNumeric. Length between 8 and 15
CENumeric. Length between 6 and 10 inclusive
PASSNumeric. Length between 6 and 10 inclusive
### Example request {% tabs %} {% tab title="Generic" %} ```json { "login": "xxxxxxxx", "pass": "xxxxxxxx", "external_id": "30000000001", "country": "CO", "currency": "COP", "amount": 100, "document_id": "848392783", "document_type": "CC", "bank_account": "56687456", "bank_code": "001", "account_type": "C", "beneficiary_name": "User", "beneficiary_lastname": "Test", "address": "Calle 18, Colombia", "notification_url": "https://webhook.site/url", "type": "json" } ``` {% endtab %} {% tab title="Efecty" %} 
{
  "login": "xxxxxxxxx",
  "pass": "xxxxxxxxx",
  "external_id": "30000000002",
  "country": "CO",
  "currency": "COP",
  "amount": 100,
  "document_id": "24721498",
  "document_type": "CC",
  "cashout_type": "BANK",
  "bank_account": "",
  "bank_branch": "",
  "bank_code": 10003,
  "account_type": "S",
  "beneficiary_name": "User",
  "beneficiary_lastname": "Test",
  "address": "Calle 43"
  "email": "",
  "phone": "+57 310 4028587",
  "notification_url": "https://webhook.site/url",
}
{% endtab %} {% tab title="Punto Red" %} 
{
  "login": "xxxxxxxxx",
  "pass": "xxxxxxxxx",
  "external_id": "30000000002",
  "country": "CO",
  "currency": "COP",
  "amount": 100,
  "document_id": "24721498",
  "document_type": "CC",
  "cashout_type": "BANK",
  "bank_account": "",
  "bank_branch": "",
  "bank_code": 10006,
  "account_type": "S",
  "beneficiary_name": "User",
  "beneficiary_lastname": "Test",
  "address": "Calle 43",
  "email": "useremail@gmail.com",
  "phone": "+57 310 4028587",
  "notification_url": "https://webhook.site/url",
}
{% endtab %} {% endtabs %} #### BREB Cashouts - Types of Keys | Bank | Bank Code | Bank Details | | ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | BREB Key Phone | 20000 | `bank_account` and `bank_branch` must be empty. The field `acount_type` can have any value. The field phone must be sent | | BREB Key Email | 20001 | `bank_account` and `bank_branch` must be empty. The field `acount_type` can have any value. The field email must be sent | | BREB Key Document | 20002 | `bank_account` and `bank_branch` must be empty. The field `acount_type` can have any value. The field `document_id` must be sent | | BREB Key Random | 20003 | `bank_branch` must be empty. The field `account_type` can have any value. The field `bank_account` must be sent - this indicates the customer's BREB random key | ### Bank codes {% hint style="success" %} ### Bank code retrieval via API For the full and most up-to-date list of banks and its codes, please check this endpoint Get bank codes {% endhint %} | Bank | Code | | ----------------------------------- | ----- | | BANCO DE BOGOTÁ | 001 | | BANCO POPULAR | 002 | | ITAÚ - Antes CORPBANCA | 006 | | BANCOLOMBIA | 007 | | ABN AMRO | 008 | | CITIBANK | 009 | | HSBC | 010 | | BANCO SUDAMERIS | 012 | | BBVA | 013 | | ITAÚ (HELM) | 014 | | BANCO COLPATRIA | 019 | | BANCO DE OCCIDENTE | 023 | | BANCOLDEX S.A. | 031 | | BANCO CAJA SOCIAL BCSC | 032 | | BANCO AGRARIO | 040 | | BANCO MUNDO MUJER | 047 | | BANCO DAVIVIENDA | 051 | | BANCO AV VILLAS | 052 | | BANCO W S.A. | 053 | | BANCO PROCREDIT | 058 | | BANCAMIA S.A. | 059 | | BANCO PICHINCHA | 060 | | BANCOOMEVA | 061 | | BANCO FALABELLA S.A | 062 | | BANCO FINANDINA | 063 | | BANCO MULTIBANK S.A. | 064 | | SANTANDER | 065 | | BANCO COMPARTIR S.A. | 067 | | BANCO SERFINANZA S.A. | 069 | | LULO BANK S.A | 070 | | J.P. MORGAN COLOMBIA | 071 | | COOPCENTRAL S.A. | 076 | | BANCO DALE | 097 | | Directa24 | 100 | | COOPERATIVA FINANCIERA DE ANTIOQUIA | 283 | | COTRAFA COOPERATIVA FINANCIERA | 289 | | COOFINEP | 291 | | CONFIAR | 292 | | FINANCIERA JURISCOOP | 296 | | BANCO UNION | 303 | | COLTEFINANCIERA | 370 | | BANCO CREDIFINANCIERA S.A. | 558 | | IRIS | 637 | | MOVII | 801 | | RAPPIPAY | 811 | | BANCO W | 1053 | | MIBANCO | 1067 | | ASOPAGOSS | 1086 | | JFK COOPERATIVA FINANCIERA | 1286 | | NEQUI | 1507 | | DAVIPLATA | 1551 | | BAN100 CREDIFINANCIERA | 1558 | | PIBANK | 1560 | | DING TECNIPAGOS SA | 1802 | | POWWI | 1803 | | UALA | 1804 | | BANCO BTG PACTUAL | 1805 | | BOLD CF | 1808 | | COINK | 1812 | | GLOBAL66 | 1814 | | Su Red | 10002 | | Efecty | 10003 | | TPAGA Wallet | 10005 | | PUNTO RED | 10006 | | Nubank | 809 | | BREB | 1184 | [^1]: Numeric