Skip to main content

​
¿Qué es Request to Pay?

Request to Pay es una solicitud de cobro que se envía directamente a la billetera digital del usuario (Nequi o DaviPlata). El usuario recibe una notificación en su app y solo debe aceptar o rechazar el monto.
A diferencia de un Payment (donde el cliente abre un link y elige cómo pagar), aquí la notificación llega directamente a la app del usuario.

​
Ventajas

  • El usuario no necesita ingresar montos manualmente
  • Se elimina el error humano en transferencias
  • La transacción queda registrada de forma inmediata
  • Permite cobros automatizados desde WhatsApp o portales de pago

​
Flujo DaviPlata

  1. OnePay genera la solicitud con el monto, referencia y número DaviPlata
  2. DaviPlata envía la notificación al usuario
  3. El usuario abre la app, ve el detalle y acepta o rechaza
  4. Al aceptar, el dinero se transfiere automáticamente

​
Flujo Nequi

  1. OnePay envía la solicitud al número asociado a Nequi
  2. Nequi notifica al usuario dentro de la app
  3. El usuario revisa el monto y acepta
  4. Nequi ejecuta el débito y notifica a OnePay

​
Ejemplo rápido

curl https://api.onepay.la/v1/request-to-pay \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: rtp-001" \
  -d '{
    "amount": 50000,
    "phone": "+573201112233",
    "description": "Pago servicio mensual"
  }'

​
Endpoints

MétodoEndpointDescripción
POST/request-to-payCrear solicitud de pago
GET/request-to-payListar solicitudes
GET/request-to-pay/Detalle de una solicitud