Pay In - PSE
Developing
Develop Env
https://api.v2.stg.paypaga.com
Develop Env
https://api.v2.stg.paypaga.com
POST
https://api.v2.stg.paypaga.com
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 |
Expiry
Initiated transactions that are not completed, transition to an Expired state after 60 hours.
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.v2.stg.paypaga.com/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_id": "20251028-1414-416f-af1d-83a4bca556a9",
"payment_method_code": "pse",
"country_code": "CO",
"currency": "COP",
"transaction_total": 1000,
"merchant_transaction_reference": "abc4561698162696828",
"transaction_fields": [
{
"name": "first_name",
"value": "Jon"
},
{
"name": "last_name",
"value": "Snow"
},
{
"name": "document_type",
"value": "CC"
},
{
"name": "document_number",
"value": "123456789"
},
{
"name": "bank_code",
"value": "1815"
},
{
"name": "email",
"value": "jonsnow@email.com"
},
{
"name": "phone",
"value": "3123456789"
},
{
"name": "address",
"value": "calle 93 # 32"
}
]
}'Response Response Example
200 - Success PSE
{
"transaction_id": "20251028-1414-416f-af1d-83a4bca556a9",
"transaction_payment_mode": "ASYNCHRONOUS",
"payment_method_reference": "90911724696",
"message": "Transaction Successfully",
"version": "0.1",
"next_steps_detail_instructions": [
{
"type": "label",
"key": "currency",
"label": "Moneda",
"description": "COP"
},
{
"type": "label",
"key": "payment_method",
"label": "Método de Pago",
"description": "pse"
},
{
"type": "label",
"key": "lookup_id",
"label": "Lookup ID",
"description": "20251028-1414-416f-af1d-83a4bca556a9"
},
{
"type": "label",
"key": "ticket_id",
"label": "Ticket ID",
"description": "531252608"
},
{
"type": "external_link",
"key": "reference_url",
"label": "Presione aquí para completar su pago",
"description": "https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=XM8y5ZNSqTSUpkMYfvAbrMf9QWJf7qVOqi2ndq%2bBdfw%3d"
}
]
}