# Countries Colombia > Create a Payout for Colombia using our API and Dashboard export const nequi = PAYOUT_PAYMENT_METHODS.find( (method) => method.id === "nequi", ); export const breB = PAYOUT_PAYMENT_METHODS.find( (method) => method.id === "bre-b", ); export const bankTransfer = PAYOUT_PAYMENT_METHODS.find( (method) => method.id === "bank-transfer", ); # 🇨🇴 Colombia Learn everything you need to know about making payouts in Colombia. ## Payment Methods Checkout our SLAs for each payment method: ## Instructions To create a payout using EBANX Direct API, follow the steps below. ### Define request parameters Provide the required parameters listed below to create a payout. | Field | Description | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `integration_key` | Your EBANX integration key. | | `external_reference` | The unique payout ID provided by you. | | `country` | The two-letter country code for the customer country. In this case, we'll show the method to co (Colombia) | | `amount` | The amount in the specified currency (currency_code). | | `currency_code` | Three-letter code of the payout currency. In this case, we'll use COP (Colombian Peso) | | `payee` | A JSON object containing the details of the payee of your request. | | `target` | The payment method that will be used. Can be left empty and the payout target will be assumed as Bank Transfer. More info below. | **Document Types Allowed** These document types are used to identify payees or shareholders. | Document type | Description | | ------------- | -------------------------------------------------------------------------------- | | CC | Citizenship card (Cédula de Ciudadanía). | | CE | Foreigner ID (Cédula de Extranjería). | | TI | Identity card (Tarjeta de Identidad). | | NIT | Tax identification number (Número de Identificación Tributaria) - for companies. | > **CE Document Type** > If you need to send the **CE** document type, it's mandatory to send **payee_document_date_issue** in the format `YYYY-MM-DD`. ### Send payout request to EBANX To create a new Payout, you will use the [**/ws/payout/create**](/api-reference?api=payout&page=post--ws-payout-create) endpoint. Choose the payment method for your payout request: {nequi?.label} } > For **Nequi** transactions, the `target` parameter must be set to "ewallet_nequi". Additionally, the `target_account` must contain the phone number linked to the payee's Nequi account. Nequi is one of the most popular digital wallets in Colombia, offering instant payouts to millions of users. ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "external_reference": "{{unique_external_reference}}", "country": "co", "amount": 100000, "currency_code": "COP", "target": "ewallet_nequi", "target_account": "3001234567", "payee": { "document": "{{tax_id}}", "document_type": "CC", "name": "Juan Carlos Rodriguez", "email": "juan.rodriguez@email.com" } }' ``` > **Phone Number Format** > The phone number must be in Colombia local format: 10 digits starting with 3 (e.g., `3001234567`). {breB?.label} } > **Bre-B** is an instant payment method in Colombia powered by the ACH Colombia network. It supports both **B2B** and **B2C** payouts with an SLA of less than 2 minutes. To use Bre-B, set the `target` parameter to `"bre_b"` and provide the payee's Bre-B key in the top-level `target_account` field. Bre-B does not use the `payee.bank_info` object — the recipient's bank details are resolved from the key by the Bre-B directory. A Bre-B key can be a phone number, an email address, a document number, or an alphanumeric key. ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "external_reference": "{{unique_external_reference}}", "country": "co", "amount": 100000, "currency_code": "COP", "target": "bre_b", "target_account": "3001234567", "payee": { "name": "John Doe", "email": "john.doe@example.com", "phone": "5555555555", "document": "{{tax_id}}", "document_type": "CC" } }' ``` Bank Transfer } > To use **Bank Transfer** as the payment method, the `target` field can be left empty (defaults to bank_account). For bank account payouts in Colombia, you must include the **bank_info** object with the bank account details. You must also include the **account_type** attribute to specify the destination account type: - Use **C** for Checking (Cuenta Corriente) - Use **S** for Savings (Cuenta de Ahorros) ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "external_reference": "{{unique_external_reference}}", "country": "co", "amount": 100000, "currency_code": "COP", "payee": { "name": "Juan Carlos Rodriguez", "email": "juan.rodriguez@email.com", "phone": "+573001234567", "document": "{{tax_id}}", "document_type": "CC", "bank_info": { "bank_name": "1007 Bancolombia S.A.", "bank_account": "{{bank_account}}", "account_type": "S" }, "address": { "zipcode": "110111", "state": "Bogota", "city": "Bogota DC", "street_address": "Carrera 7 No. 71-21", "street_complement": "Torre B Piso 12" } } }' ``` **Example with CE document type:** ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "external_reference": "{{unique_external_reference}}", "country": "co", "amount": 100000, "currency_code": "COP", "payee": { "name": "John Smith", "email": "john.smith@email.com", "phone": "+573001234567", "document": "{{tax_id}}", "document_type": "CE", "payee_document_date_issue": "2020-05-15", "bank_info": { "bank_name": "1007 Bancolombia S.A.", "bank_account": "{{bank_account}}", "account_type": "S" }, "address": { "zipcode": "110111", "state": "Bogota", "city": "Bogota DC", "street_address": "Carrera 7 No. 71-21", "street_complement": "Torre B Piso 12" } } }' ``` A successful creation will return a JSON Object with type "success" and a payout object with all the details of the newly created payout. **B2B Payouts (Organizations)** For organizations, you need to use the **NIT** document type and include shareholder information. The following fields are required in the **shareholder** object: - `name` - `document` - `document_type` - `email` - `ownership_percent` ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/create' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "external_reference": "{{unique_external_reference}}", "country": "co", "amount": 500000, "currency_code": "COP", "payee": { "name": "Empresa Colombia SAS", "email": "contacto@empresacolombia.com", "phone": "+573001234567", "document": "{{tax_id}}", "document_type": "NIT", "bank_info": { "bank_name": "1007 Bancolombia S.A.", "bank_account": "{{bank_account}}", "account_type": "C" }, "address": { "zipcode": "110111", "state": "Bogota", "city": "Bogota DC", "street_address": "Carrera 7 No. 71-21", "street_complement": "Torre B Piso 12" } } }' ``` ### Send commit request to EBANX Once the new payout record is created it'll be committed automatically after 6 hours. Or you can use the [**/ws/payout/commit**](/api-reference?api=payout&page=post--ws-payout-commit) endpoint to start the payment process. Here's an example of a commit operation using the payout we've just created: ```bash curl -X POST \ --location 'https://sandbox.ebanxpay.com/ws/payout/commit' \ --header 'Content-Type: application/json' \ --data '{ "integration_key": "{{integration_key}}", "uid": "{{payout_uid}}" }' ``` Once the new payout is committed, a JSON Object with type "success" will be returned. ```json { "type": "success", "message": "Payout has already been committed" } ``` ### Congratulations! You have successfully **Created a Payout** in Colombia. ## Creating a Payout using the Dashboard You can also create a payout through our Dashboard in the Overview section of the Payout tab. Click on Create Payout, fill in the payee information, payout amount and click on Create. Additionally, you can create a Mass Payout by sending a spreadsheet to be processed in bulks. ## Available Banks | Bank Code | Institution Name | | :-------- | :----------------------------- | | **1007** | Bancolombia S.A. | | **1001** | Banco de Bogotá | | **1013** | BBVA Colombia | | **1009** | Citibank Colombia | | **1012** | GNB Sudameris | | **1023** | Banco de Occidente | | **1019** | Scotiabank Colpatria | | **1002** | Banco Popular | | **1006** | Banco Corpbanca Colombia S.A. | | **1014** | Itaú Colombia | | **1052** | Banco AV Villas | | **1051** | Davivienda | | **1062** | Banco Falabella | | **1063** | Banco Finandina | | **1066** | Banco Cooperativo Coopcentral | | **1292** | Confiar Cooperativa Financiera | | **1283** | CFA Cooperativa Financiera | | **1370** | COLTEFINANCIERA S.A. | | **1507** | Nequi | | **1551** | Daviplata | | **1801** | Movii | ## Possible Errors See the [Payout Error Code page](/docs/payout/create-payout/errors/payout-error-codes) to learn more about the possible errors. ## Still need help? If you still have questions, you can explore the following options: - **Merchant support:** Contact our support team at [sales.engineering@ebanx.com](mailto:sales.engineering@ebanx.com) for assistance. - **Not a partner yet?** Complete the [Merchant Signup Form](https://business.ebanx.com/en/request-contact), and our commercial team will reach out to you.