Colombia PSE
Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in
Channel
Required Fields
| Field | Description | Validation |
|---|---|---|
| first_name | First name | Length >= 2 <= 25, RegEx ^\p{L}(?:[ '-]\p{L}+)$ |
| last_name | Last name | Length >= 2 <= 25, 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_code | Bank Identification Code | See Bank Identifier Codes below |
| Email address | Length >= 5 <= 50, RegEx ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$ | |
| phone | Phone number | Length >= 8 <= 10, RegEx ^\d+$ |
| address | Full address | Length >= 2 <= 64, RegEx ^[\p{L}0-9][\p{L}0-9\s,'#/.°-]+$ |
Document types
| Name | Description | Validation |
|---|---|---|
| Cédula de Ciudadanía | CC | Length >= 6 <= 10, RegEx ^\d+$ |
| Cédula de Extranjería | CE | Length >= 6 <= 10 RegEx ^[a-zA-Z0-9]+$ |
| Pasaporte | PP | Length >= 7 <= 12, RegEx ^[a-zA-Z0-9]+$ |
| Tarjeta de Extranjería | TE | Length >= 6 <= 15, RegEx ^[a-zA-Z0-9]+$ |
Bank Identifier Code
| Name | Code |
|---|---|
| COTRAFA | 1289 |
| LULO BANK | 1070 |
| BANCO FALABELLA | 1062 |
| BANCO MUNDO MUJER S.A. | 1047 |
| BANCO SERFINANZA | 1069 |
| GLOBAL66 | 1814 |
| JFK COOPERATIVA FINANCIERA | 1286 |
| UALÁ | 1804 |
| BANCO DE OCCIDENTE | 1023 |
| CREZCAMOS | 1816 |
| BANCAMIA S.A. | 1059 |
| BANCO AV VILLAS | 1052 |
| BANCO DAVIVIENDA | 1051 |
| IRIS | 1637 |
| MOVII S.A. | 1801 |
| ALIANZA FIDUCIARIA | 1815 |
| BANCO AGRARIO | 1040 |
| BANCO COOPERATIVO COOPCENTRAL | 1066 |
| BANCO POPULAR | 1002 |
| BANCO UNION antes GIROS | 1303 |
| FINANCIERA JURISCOOP SA COMPAÑÍA DE FINANCIAMIENTO | 1121 |
| POWWI | 1803 |
| BANCO CAJA SOCIAL | 1032 |
| BANCO J.P. MORGAN COLOMBIA S.A. | 1071 |
| BANCO PICHINCHA S.A. | 1060 |
| BANCO SANTANDER COLOMBIA | 1065 |
| BOLD CF | 1808 |
| CITIBANK | 1009 |
| NEQUI | 1507 |
| NU | 1809 |
| BANCO DE BOGOTA | 1001 |
| BANCO GNB SUDAMERIS | 1012 |
| BANCO ITAU | 1006 |
| COLTEFINANCIERA | 1370 |
| CONFIAR COOPERATIVA FINANCIERA | 1292 |
| DALE | 1097 |
| DAVIPLATA | 1551 |
| DING | 1802 |
| BAN100 | 1558 |
| BANCO FINANDINA S.A. BIC | 1063 |
| CFA COOPERATIVA FINANCIERA | 1283 |
| RAPPIPAY | 1811 |
| SCOTIABANK COLPATRIA | 1019 |
| BANCO BBVA COLOMBIA S.A. | 1013 |
| BANCOLOMBIA | 1007 |
| BANCOOMEVA S.A. | 1061 |
| COINK SA | 1812 |
Amount
3724
193457345
3724.00
3724.50
Expiry
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 1000,
"country": "CO",
"currency": "COP",
"payment_method": "pse",
"merchant_order_reference": "ORDER-2026-0010",
"merchant_transaction_reference": "TRX-2026-0010",
"merchant_customer_id": "customer@email.com",
"customer_ip": "120.29.48.92",
"fields": {
"first_name": "Jon",
"last_name": "Snow",
"document_type": "CC",
"document_number": "123456789",
"bank_code": "1062",
"email": "jonsnow@email.com",
"phone": "669548354",
"address": "Calle 123 #45-67"
},
"return_urls": {
"success_url": "https://merchant.com/payment-success",
"failure_url": "https://merchant.com/payment-failure",
"cancel_url": "https://merchant.com/payment-cancelled"
}
}'Response Response Example
{
"transaction_id": "20260205-1606-4c98-9954-07972623401d",
"payment_method_reference": 129930,
"expires_at": "2026-06-09T14:13:05.143073869Z",
"instructions": {
"reference_url": "https://pay.com/v2/pay/20260205-1606-4c98-9954-07972623401d"
}
}Modified at 2026-06-09 11:31:18