Colombia Nequi

Production

https://api.paypaga.com

POST

/v2/transactions/pay-in

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

Response Fields

Field	Description
reference_url	Link to redirect the customer to Nequi's checkout to complete the payment.

Expiry

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

Payment Instructions

Confirm the payment in your Nequi app from the notifications section.

Spanish:
Por favor confirma el pago en tu app Nequi desde el apartado de notificaciones.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Pay-in accepted.

Headers

Bodyapplication/json

🟠400ValidationAndBadRequestError

🔴500InternalError

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",
    "customer_ip": "120.29.48.92",
    "fields": {
        "phone": "3651234567"
    },
    "merchant_customer_id": "customer@email.com",
    "merchant_order_reference": "ORDER-2026-0009",
    "merchant_transaction_reference": "TRX-2026-0009",
    "payment_method": "nequi",
    "return_urls": {
        "failure_url": "https://merchant.com/payment-failure",
        "success_url": "https://merchant.com/payment-success"
    }
}'

Response Example

201 - Colombia Nequi

{
    "expires_at": "2026-06-09T14:13:05.143073869Z",
    "instructions": {
        "reference_url": "https://pay.com/v2/pay/20260205-1606-4c98-9954-07972623401d"
    },
    "payment_method_reference": "129930",
    "transaction_id": "20260205-1606-4c98-9954-07972623401d"
}

Modified at 2026-10-15 16:12:25

Colombia Movii

Colombia PSE

Colombia Nequi

Channel#

Required Fields#

Amount#

Response Fields#

Expiry#

Payment Instructions#