Skip to main content
POST
https://api.onepay.la/v1
/
request-to-pay
/
nequi
curl https://api.onepay.la/v1/request-to-pay/nequi \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: nequi-001" \
  -d '{
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "amount": 10000,
    "phone": "+573167591030",
    "title": "Cobro de servicio",
    "external_id": "order-12345"
  }'

{
  "id": "4ba8a568-b5c9-4446-a858-b6d00dab341e",
  "description": "Charge description",
  "amount": 10000,
  "amount_label": "Charge amount",
  "source": "nequi",
  "status": "pending",
  "currency": "COP",
  "payment_method_type": "nequi",
  "payment_method_id": "4ba8a568-b5c9-4446-a858-b6d00dab341e",
  "created_at": "2022-01-01T00:00:00.000Z",
  "paid_at": null,
  "remarks": null,
  "is_test": false,
  "network_id": "4ba8a568-b5c9-4446-a858-b6d00dab341e",
  "external_id": "4ba8a568-b5c9-4446-a858-b6d00dab341e"
}
Tiempo de confirmación: Para transacciones con NEQUI, el usuario tiene hasta 45 minutos para confirmar el pago. Es importante que tu aplicación maneje este tiempo de espera o implemente un flujo que permita al usuario completar la confirmación dentro de este período.Lastimosamente, la API de NEQUI no ofrece la posibilidad de cancelar este proceso.

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

​
Body

​
external_id
string
Identificador que asocias a tu proveedor externo.
​
customer_id
string
required
ID del cliente sobre el cual se hará la solicitud. Crear cliente.
​
amount
number
required
Monto a cobrar al usuario.
​
phone
string
required
Número de teléfono en formato E.164 a enviar la solicitud.
​
title
string
required
Título de la solicitud.
curl https://api.onepay.la/v1/request-to-pay/nequi \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: nequi-001" \
  -d '{
    "customer_id": "9dd4158b-0e45-42bc-b56f-a4c1f856814d",
    "amount": 10000,
    "phone": "+573167591030",
    "title": "Cobro de servicio",
    "external_id": "order-12345"
  }'

{
  "id": "4ba8a568-b5c9-4446-a858-b6d00dab341e",
  "description": "Charge description",
  "amount": 10000,
  "amount_label": "Charge amount",
  "source": "nequi",
  "status": "pending",
  "currency": "COP",
  "payment_method_type": "nequi",
  "payment_method_id": "4ba8a568-b5c9-4446-a858-b6d00dab341e",
  "created_at": "2022-01-01T00:00:00.000Z",
  "paid_at": null,
  "remarks": null,
  "is_test": false,
  "network_id": "4ba8a568-b5c9-4446-a858-b6d00dab341e",
  "external_id": "4ba8a568-b5c9-4446-a858-b6d00dab341e"
}