# 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](#document-validations)              | Beneficiary's document ID                                                                                         |
| `document_type`        | See [document validations](#document-validations)              | Beneficiary's document type                                                                                       |
| `country`              | `CO`                                                           | See [country codes](https://docs.pandablue.com/specifications/countries-specifications#countries-and-currencies)  |
| `currency`             | `COP` / `USD`                                                  | See [currency codes](https://docs.pandablue.com/specifications/countries-specifications#countries-and-currencies) |
| `amount`               | Number with up to 2 decimals                                   | Cashout amount                                                                                                    |
| `bank_code`            | See [bank codes](#bank-codes)                                  | Code specifying the beneficiary's bank                                                                            |
| `bank_account`         | See [validations below](#bank-account-validations)             | Beneficiary's bank account                                                                                        |
| `account_type`         | See [account type codes](#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](#phone-validations) | Beneficiary's phone number                                                                                        |

## 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    |
| D24 Card  |   10001   | Empty string            | `^$`             | ""            |
| Su Red    |   10002   | Empty string            | `^$`             | ""            |
| Efecty    |   10003   | Empty string            | `^$`             |               |
| Others    |     -     | Numeric                 | `^\d{8,19}$`     | 1234567890123 |

## Account Types

The `account_type` is specified with only one character as described below.

| `account_type` | Description       |
| :------------: | ----------------- |
|     **`C`**    | Checkings account |
|     **`S`**    | Savings account   |

## Document Validations

[Click here](https://docs.pandablue.com/specifications/countries-specifications#documents-validations) to check document types and validations.

## Phone validations

| Bank name | Bank code | Format                                                                                                                           | Required | Example |
| --------- | :-------: | -------------------------------------------------------------------------------------------------------------------------------- | :------: | ------- |
| Su Red    |   10002   | [Valid phone number for Colombia.](https://docs.pandablue.com/specifications/countries-specifications#phone-numbers-validations) |    Yes   |         |
| Others    |     -     | -                                                                                                                                |    No    | -       |

## Example Request

{% tabs %}
{% tab title="Generic" %}

```java
{
    "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="Baloto / Su Red " %}

```java
{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000001",
    "country": "CO",
    "currency": "COP",
    "amount": 100,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "",
    "bank_code": "10000", // 10000 for Baloto, 10002 for Su Red
    "account_type": "S",
    "phone": "+5715551234",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "address": "Calle 18, Colombia",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}
```

{% endtab %}

{% tab title="D24 Card" %}

```java
{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000002",
    "country": "CO",
    "currency": "COP",
    "amount": 100,
    "document_id": "848392783",
    "document_type": "CC",
    "bank_account": "",
    "bank_code": "10001",
    "account_type": "S",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "address": "Calle 18, Colombia",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}
```

{% endtab %}
{% endtabs %}

## Bank Codes

| 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   |
| BANCO CAJA SOCIAL BCSC              | 032   |
| BANCO AGRARIO                       | 040   |
| BANCO DAVIVIENDA                    | 051   |
| BANCO AV VILLAS                     | 052   |
| BANCO PROCREDIT                     | 058   |
| BANCO PICHINCHA                     | 060   |
| BANCOOMEVA                          | 061   |
| BANCO FALABELLA S.A                 | 062   |
| SANTANDER                           | 065   |
| COOPCENTRAL S.A                     | 076   |
| Directa24                           | 100   |
| COOPERATIVA FINANCIERA DE ANTIOQUIA | 283   |
| COTRAFA COOPERATIVA FINANCIERA      | 289   |
| CONFIAR                             | 292   |
| FINANCIERA JURISCOOP                | 296   |
| NEQUI                               | 1507  |
| DAVIPLATA                           | 1551  |
| Su Red                              | 10002 |
| Efecty                              | 10003 |
| Nubank                              | 809   |
| BREB Key — Phone                    | 20000 |
| BREB Key — Email                    | 20001 |
| BREB Key — Document                 | 20002 |
| BREB Key — Random                   | 20003 |

{% hint style="info" %}
For the full and most up-to-date list of banks and its codes, please check the [Cashout Bank Code endpoint.](https://docs.pandablue.com/api-documentation/cashouts-api/endpoints/cashout-bank-codes)
{% endhint %}