Colombia Bank Transfer
Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-out
Channel
Bank Transfer
Required Fields
| Field | Description | Validation |
|---|---|---|
| first_name | First name | Length >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$ |
| last_name | Last name | Length >= 2 <= 50, RegEx ^\p{L}*(?:[ '-]\p{L}+)*$ |
| document_type | Identification document type | See document types listed below |
| document_number | Identification document number | See document types listed below |
| bank_name | Bank name | See Bank Identifier Names below |
| account_type | Account type | Ahorro (Savings) or Corriente (Checking) |
| account_number | Bank account number | Length >= 4 <= 16, RegEx ^\d+$ |
| Email address | Length >= 5 <= 50, RegEx ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ | |
| phone | Phone number | Length >= 10 <= 10, RegEx ^(3\d{9}|60[1-8]\d{7})$. See phone number formats below |
| address | Full address | Length >= 2 <= 64, RegEx ^[\p{L}0-9][\p{L}0-9\s,'#/.°-]+$ |
Phone number formats
Bank Transfer accepts Colombian mobile numbers and unified national plan landline numbers:
| Type | Format | Length | Example |
|---|---|---|---|
| Mobile | Starts with 3 | 10 digits | 3001234567 |
| Landline (unified national plan, 2021+) | 60 + area code digit (1-8) | 10 digits | 6012345678 |
Document types
| Name | Type value |
|---|---|
| Cédula de Ciudadanía | CC |
| Cédula de Extranjería | CE |
Document types
| Name | Type value |
|---|---|
| Cédula de Ciudadanía | CC |
| Cédula de Extranjería | CE |
Bank Identifier Names
Bank Identifier Names
| Name | Type |
|---|---|
| AV VILLAS | Bank |
| BANCAMIA | Bank |
| BANCO AGRARIO | Bank |
| BANCO BTG PACTUAL | Bank |
| BANCO CAJA SOCIAL | Bank |
| BANCO DE BOGOTA | Bank |
| BANCO DE COMERCIO EXTERIOR | Bank |
| BANCO DE LA REPUBLICA | Bank |
| BANCO DE OCCIDENTE | Bank |
| BANCO FALABELLA | Bank |
| BANCO FINANDINA | Bank |
| BANCO MUNDO MUJER | Bank |
| BANCO PICHINCHA | Bank |
| BANCO POPULAR | Bank |
| BANCO SANTANDER DE NEGOCIOS | Bank |
| BANCO SERFINANZA | Bank |
| BANCO W | Bank |
| BANCOLDEX | Bank |
| BANCOLOMBIA | Bank |
| BANCOOMEVA | Financial |
| BBVA | Bank |
| BNP PARIBAS COLOMBIA | Bank |
| CITIBANK | Bank |
| COLSUBSIDIO | Financial |
| COLTEFINANCIERA | Financial |
| COMPENSAR | Financial |
| CONFIAR | Financial |
| COOFINEP | Financial |
| COOPERATIVA FINANCIERA DE ANTIOQUIA | Financial |
| COOTRAFA | Financial |
| COTRAFA COOPERATIVA FINANCIERA | Financial |
| CREDICORP CAPITAL COLOMBIA | Financial |
| DAVIPLATA | Wallet |
| DAVIVIENDA | Bank |
| FEDECAJAS | Financial |
| GIROS Y FINANZAS CFC | Financial |
| IRIS | Fintech |
| ITAU | Bank |
| JURISCOOP | Financial |
| LULO BANK | Bank |
| MIBANCO | Financial |
| MOVII | Wallet |
| NEQUI | Wallet |
| RAPPIPAY | Wallet |
| SCOTIABANK COLPATRIA | Bank |
| UALA | Wallet |
Amount
While ISO 4217 defines COP as having 2 decimal places in practice these are not used. Amounts in COP must be an integer amount with no decimal places.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-out' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 125.5,
"country": "CO",
"currency": "COP",
"customer_ip": "120.29.48.92",
"fields": {
"account_number": "1234567890",
"account_type": "Ahorro",
"address": "Calle 123",
"bank_name": "BANCOLOMBIA",
"document_number": "12345678",
"document_type": "CC",
"email": "juan.perez@email.com",
"first_name": "Juan",
"last_name": "Pérez",
"phone": "3001234567"
},
"merchant_customer_id": "customer@mail.com",
"merchant_order_reference": "ORDER-2026-0001",
"merchant_transaction_reference": "TRX-2026-0026",
"payment_method": "bank_transfer"
}'Response Response Example
202 - Generic response for all payment methods
{
"merchant_order_reference": "ORDER-2026-0001",
"merchant_transaction_reference": "TRX-2026-0026",
"transaction_id": "20240806-2010-4086-8342-c28f4979f834"
}Modified at 2026-09-07 16:03:57