LogoLogo
  • OKP APIs
  • Getting Started with OKP
  • API Documentation
    • Deposits API
      • Technical and Security Aspects
        • Calculating the Signature
      • Endpoints
        • Deposit Creation Endpoint
          • Notifications
        • Transactional Account Endpoint
          • Understanding the Solution
        • PCI Deposit Creation Endpoint
        • Deposit Status Endpoint
        • Payment Methods Endpoint
        • Currency Exchange Endpoint
        • Crypto Exchange Endpoint
        • Country States Codes Endpoint
        • Refund Creation Endpoint
          • Notifications
        • Refund Status Endpoint
      • Payment Methods
        • 🌎America
          • 🇧🇷Brazil
            • PIX Biometric
      • API Codes
    • Cashouts API
      • Technical and Security Aspects
        • Calculating the Payload-Signature
      • Endpoints
        • Cashout Creation Endpoint
          • Notifications
        • Cashout Status Endpoint
        • Cashout Update Status Endpoint
        • Cashout Cancellation Endpoint
        • Cashout Bank Codes
      • Countries Validations
        • American Countries
          • 🇧🇷Brazil
      • API Codes
    • Subscriptions API
      • Technical and Security Aspects
        • Calculating the Signature
      • Subscription Creation Endpoints
        • OneShot Subscription Creation
        • PCI Subscription Creation Endpoint
        • Notifications
      • Subscription Cancellation Endpoint
      • Subscription Status Endpoint
    • Quickpay
      • Endpoints
        • Deposit creation endpoint
          • Notifications
        • Deposit status endpoint
    • Bank Account Validation
      • Technical and Security Aspects
        • Calculating the Signature
      • Endpoints
        • Bank Account Validation Endpoint
          • Pix Key Validation and Details Endpoint
      • API Codes
    • KYC API
      • Technical and Security Aspects
        • Calculating the Signature
      • KYC Endpoint
      • API Codes
  • Deposits Tools
    • Cards SDK
      • With User Interface
        • 🚀Color Customization
      • Without User Interface
    • Java SDK
    • PHP SDK
  • Knowledge Base
    • Deposits with Cards SDK
      • With User Interface
      • Without User Interface
    • Countries Specifications
  • PLUGINS
    • WooCommerce
      • Installation
      • Configuration
  • Status Page
Powered by GitBook
On this page
  • Required fields
  • Bank Account Validations
  • Account Types
  • Document Validations
  • Phone validations
  • Example Request
  • Bank Codes
  1. API Documentation
  2. Cashouts API
  3. Countries Validations
  4. American Countries

Colombia

Check the requirements and validations made over the cashouts on 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

Beneficiary's document ID

document_type

Beneficiary's document type

country

CO

currency

COP / USD

amount

Number with up to 2 decimals

Cashout amount

bank_code

Code specifying the beneficiary's bank

bank_account

Beneficiary's bank account

account_type

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

Beneficiary's phone number

Bank Account Validations

Bank name

Bank code

Format

Example

Nequi

1507

Customer's mobile phone

5715551234

Daviplata

1551

Customer's mobile phone

5715551234

D24 Card

10001

Empty string

""

Su Red

10002

Empty string

""

Efecty

10003

Empty string

Others

-

Numeric

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

Phone validations

Bank name

Bank code

Format

Required

Example

Su Red

10002

Yes

Others

-

-

No

-

Example Request

{
    "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"
}
{
    "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"
}
{
    "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"
}

Bank Codes

Bank

Code

BANCO DE BOGOTÁ

001

BANCO POPULAR

002

ITAÚ - Antes CORPBANCA

006

BANCOLOMBIA

007

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

NEQUI

1507

DAVIPLATA

1551

Su Red

10002

Efecty

10003

TPAGA Wallet

10005

Last updated 4 months ago

See

See

See

See

See

See

See

String (max length: 20).

to check document types and validations.

For the full and most up-to-date list of banks and its codes, please check the

🇨🇴
Cashout Bank Code endpoint.
document validations
document validations
bank codes
validations below
account type codes
See validations
Click here
country codes
currency codes
Valid phone number for Colombia.