Pay In - Nequi
Developing
Develop Env
https://api.v2.stg.paypaga.com
Develop Env
https://api.v2.stg.paypaga.com
POST
https://api.v2.stg.paypaga.com
Channel
Wallet
Required Fields
| Field | Description | Validation |
|---|---|---|
| phone | Phone number | Length >= 8 <= 10, RegEx ^\d+$ |
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-1402-4364-a28d-f57318bb9e1c",
"payment_method_code": "nequi",
"country_code": "CO",
"currency": "COP",
"transaction_total": 1000,
"merchant_transaction_reference": "abc4561698162696828",
"transaction_fields": []
}'Response Response Example
200 - Success Nequi
{
"transaction_id": "20251028-1402-4364-a28d-f57318bb9e1c",
"transaction_payment_mode": "ASYNCHRONOUS",
"payment_method_reference": "90955764965",
"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": "nequi"
},
{
"type": "label",
"key": "lookup_id",
"label": "Lookup ID",
"description": "20251028-1402-4364-a28d-f57318bb9e1c"
},
{
"type": "external_link",
"key": "reference_url",
"label": "Presione aquí para completar su pago",
"description": "sandbox-checkoutapp.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJNRVJDSEFOVF9DRUwiOiIrNTI4MTgzNTYyNjAwIiwiTUVSQ0hBTlRfQ09ERSI6MjAzNzI2LCJPUkRFUl9DT0RFIjo1NjkzNDEzLCJNRVJDSEFOVF9FTUFJTCI6ImluZm9AcGF5cGFnYS5jb20iLCJNRVJDSEFOVF9MT0dPIjoiaHR0cHM6Ly90ZXN0LWltYWdlcy5wYXl2YWxpZGEuY29tL3ZhbGlkZGF3ZWIvbG9nb19tZXJjaGFudC9wYXlwYWdhcHJ1ZWJhcy9wYXlwYWdhcHJ1ZWJhc18yMDI1LTAzLTI3VDEwOjA2OjE4LTA1OjAwLnBuZyIsIk1FUkNIQU5UX1VSTF9SRVRVUk4iOiJodHRwczovL2FwaS52Mi5zdGcucGF5cGFnYS5jb20vcGF5L2NvbXBsZXRlZCIsIk1FUkNIQU5UX05BTUUiOiJQQVlQQUdBIChDTykiLCJFWFBJUkFUSU9OIjoiMzAvMTAvMjAyNSIsIk9SREVSX0JSSUVGIjoiUGFnbyIsIk1FUkNIQU5UX1RFTCI6Iis1MjgxODM1NjI2MDAiLCJPUkRFUl9DVVJSRU5DWSI6IkNPUCIsIk9SREVSX0FNT1VUIjoiMTAwMC4wIiwiTUVSQ0hBTlRfSUQiOiJwYXlwYWdhcHJ1ZWJhcyIsIk9SREVSX1JFRkVSRU5DRSI6IjkwOTU1NzY0OTY1IiwiT1JERVJfTUVUSE9EIjoibmVxdWkiLCJVU0VSX0RJIjoiIiwiVVNFUl9UWVBFX0RJIjoiIiwiVVNFUl9OQU1FIjoiIiwiUkVESVJFQ1RfVElNRU9VVCI6IiIsIk1FUkNIQU5UX1RFTVBMQVRFIjoiZGVmYXVsdCIsIkNPVU5UUllfQ09ERSI6IjM0MyIsIlZFUlNJT04iOiJiNWM2MDc2NC01MTc5LTRjMmEtODQzNy00MmYzN2E5YjNhN2EiLCJpc3MiOiJhdXRoMCIsImV4cCI6MTc2MTg4NjgwMH0.PHonjEybErUWMyYeH3kn2RoV05drolWDDmGI3r6IMyE"
}
]
}