Pay In - Nequi

Develop Env

https://api.v2.stg.paypaga.com

POST

/payment

Channel

Wallet

Required Fields

Field	Description	Validation
phone	Phone number	10 Digits, RegEx `^3\d{9}$`

Amount

While ISO 4217 defines COP as having 2 decimal places, in practice these are not used. Amounts in COP must be sent as an integer, with no decimal places.

Example	Valid
`3724`	Yes
`193457345`	Yes
`3724.00`	No
`3724.50`	No

Expiry

Initiated transactions that are not completed, transition to an Expired state after 60 hours.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.v2.stg.paypaga.com/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "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 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": "payment_method",
            "label": "Método de Pago",
            "description": "nequi"
        },
        {
            "type": "label",
            "key": "instructions",
            "label": "Instrucciones",
            "description": "Por favor confirma el pago en tu app Nequi desde el apartado de notificaciones"
        }
    ]
}

Pay In - Movii

Pay In - PSE

Pay In - Nequi

Channel#

Required Fields#