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
Fields validation
| field | validation |
|---|---|
| first_name | required, min length 2, max length 25, regexp ^\p{L}*(?:[ '-]\p{L}+)*$ |
| last_name | required, min length 2, max length 25, regexp ^\p{L}*(?:[ '-]\p{L}+)*$ |
| document_type | required, options |
| document_number | required, varies depending on document_type |
| bank_code | required, options |
required, min length 5, max length 50, regexp ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ | |
| phone | required, min length 8, max length 10, regexp ^\d+$ |
| address | required, min length 2, max length 64, regexp ^[\p{L}0-9][\p{L}0-9\s,'#/.°-]+$ |
Document type options
| document_type | name |
|---|---|
| CC | Cédula de Ciudadanía |
| CE | Cédula de Extranjería |
| PP | Pasaporte |
| TE | Tarjeta de Extranjería |
Document number validation
| document_number | validation |
|---|---|
| CC | min length 6, max length 10, regexp ^\d+$ |
| CE | min length 6, max length 10, regexp ^[a-zA-Z0-9]+$ |
| PP | min length 7, max length 12, regexp ^[a-zA-Z0-9]+$ |
| TE | min length 6, max length 15, regexp ^[a-zA-Z0-9]+$ |
Bank codes
Bank codes
| bank_code | bank name |
|---|---|
| 1289 | COTRAFA |
| 1070 | LULO BANK |
| 1062 | BANCO FALABELLA |
| 1047 | BANCO MUNDO MUJER S.A. |
| 1069 | BANCO SERFINANZA |
| 1814 | GLOBAL66 |
| 1286 | JFK COOPERATIVA FINANCIERA |
| 1804 | UALÁ |
| 1023 | BANCO DE OCCIDENTE |
| 1816 | CREZCAMOS |
| 1059 | BANCAMIA S.A. |
| 1052 | BANCO AV VILLAS |
| 1051 | BANCO DAVIVIENDA |
| 1637 | IRIS |
| 1801 | MOVII S.A. |
| 1815 | ALIANZA FIDUCIARIA |
| 1040 | BANCO AGRARIO |
| 1066 | BANCO COOPERATIVO COOPCENTRAL |
| 1002 | BANCO POPULAR |
| 1303 | BANCO UNION antes GIROS |
| 1121 | FINANCIERA JURISCOOP SA COMPAÑÍA DE FINANCIAMIENTO |
| 1803 | POWWI |
| 1032 | BANCO CAJA SOCIAL |
| 1071 | BANCO J.P. MORGAN COLOMBIA S.A. |
| 1060 | BANCO PICHINCHA S.A. |
| 1065 | BANCO SANTANDER COLOMBIA |
| 1808 | BOLD CF |
| 1009 | CITIBANK |
| 1507 | NEQUI |
| 1809 | NU |
| 1001 | BANCO DE BOGOTA |
| 1012 | BANCO GNB SUDAMERIS |
| 1006 | BANCO ITAU |
| 1370 | COLTEFINANCIERA |
| 1292 | CONFIAR COOPERATIVA FINANCIERA |
| 1097 | DALE |
| 1551 | DAVIPLATA |
| 1802 | DING |
| 1558 | BAN100 |
| 1063 | BANCO FINANDINA S.A. BIC |
| 1283 | CFA COOPERATIVA FINANCIERA |
| 1811 | RAPPIPAY |
| 1019 | SCOTIABANK COLPATRIA |
| 1013 | BANCO BBVA COLOMBIA S.A. |
| 1007 | BANCOLOMBIA |
| 1061 | BANCOOMEVA S.A. |
| 1812 | COINK SA |
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"
}
]
}