Skip to main content
POST
https://api.onepay.la/v1
/
request-to-pay
/
nequi
Nequi
curl --request POST \
  --url https://api.onepay.la/v1/request-to-pay/nequi \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '
{
  "customer_id": "<string>",
  "amount": 123,
  "phone": "<string>",
  "title": "<string>",
  "external_id": "<string>"
}
'
{
  "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.
{
  "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"
}