Skip to main content

🇨🇴 Colombia

Learn everything you need to know about making payouts in Colombia.

Payment Methods

  • Nequi Instant
  • Bank Transfer

Available Operations

  • Cross Border

Payee Types

  • B2B
  • B2C

Payment Methods​

Checkout our SLAs for each payment method:

Payment MethodSLAB2BB2C
NequiNequi< 2 minutescheck_circle_outlinecheck_circle_outline
Bank TransferBank TransferUp to 3 dayscheck_circle_outlinecheck_circle_outline

Instructions​

To create a payout using EBANX Direct API, follow the steps below.

  1. Define request parameters
    ​

    Provide the required parameters listed below to create a payout.

    FieldDescription
    integration_keyYour EBANX integration key.
    external_referenceThe unique payout ID provided by you.
    countryThe two-letter country code for the customer country. In this case, we'll show the method to co (Colombia)
    amountThe amount in the specified currency (currency_code).
    currency_codeThree-letter code of the payout currency. In this case, we'll use COP (Colombian Peso)
    payeeA JSON object containing the details of the payee of your request.
    targetThe 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 typeDescription
    CCCitizenship card (Cédula de Ciudadanía).
    CEForeigner ID (Cédula de Extranjería).
    TIIdentity card (Tarjeta de Identidad).
    NITTax 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.

  2. Send payout request to EBANX
    ​

    To create a new Payout, you will use the /ws/payout/create endpoint.

    Choose the payment method for your payout request:

    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.

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/create' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "external_reference": "PAYOUT_EBANX_CO_01",
      "country": "co",
      "amount": 100000,
      "currency_code": "COP",
      "target": "ewallet_nequi",
      "target_account": "3001234567",
      "payee": {
        "document": "1234567890",
        "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).

    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

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/create' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "external_reference": "PAYOUT_EBANX_CO_B2B",
      "country": "co",
      "amount": 500000,
      "currency_code": "COP",
      "payee": {
        "name": "Empresa Colombia SAS",
        "email": "contacto@empresacolombia.com",
        "phone": "+573001234567",
        "document": "9001234567",
        "document_type": "NIT",
        "bank_info": {
          "bank_name": "1007 Bancolombia S.A.",
          "bank_account": "12345678901",
          "account_type": "C"
        },
        "address": {
          "zipcode": "110111",
          "state": "Bogota",
          "city": "Bogota DC",
          "street_address": "Carrera 7 No. 71-21",
          "street_complement": "Torre B Piso 12"
        }
      }
    }'

  3. 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 endpoint to start the payment process.

    Here's an example of a commit operation using the payout we've just created:

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/commit' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "uid": "c3574f5341c3c8c1e40ea9c06715f05778ff35ee"
    }'

    Once the new payout is commited, a JSON Object with type "success" will be returned.

    {
      "type": "success",
      "message": "Payout has already been committed"
    }

  4. 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 CodeInstitution Name
1007Bancolombia S.A.
1001Banco de Bogotá
1013BBVA Colombia
1009Citibank Colombia
1012GNB Sudameris
1023Banco de Occidente
1019Scotiabank Colpatria
1002Banco Popular
1006Banco Corpbanca Colombia S.A.
1014Itaú Colombia
1052Banco AV Villas
1051Davivienda
1062Banco Falabella
1063Banco Finandina
1066Banco Cooperativo Coopcentral
1292Confiar Cooperativa Financiera
1283CFA Cooperativa Financiera
1370COLTEFINANCIERA S.A.
1507Nequi
1551Daviplata
1801Movii

Possible Errors​

Click here and check out our Payout Error Code page to learn more about the possible errors.

Still need help?

Help Image

We hope this article was helpful. If you still have questions, you can explore the following options: