PayOuts
En esta guía encontrarás cómo generar un PayOut, consultar su estado, comprender el flujo de procesamiento y conocer los estados disponibles para el seguimiento de tus transferencias.
Con PayOuts de ProntoPaga puedes dispersar fondos hacia cuentas bancarias en Perú mediante una integración de API simple y segura. Envía transferencias a cuentas propias o de terceros, consulta el estado de cada operación en tiempo real y accede a la trazabilidad completa de tus transacciones para facilitar la conciliación y auditoría.
¿Qué puedes hacer?
Envía una solicitud de dispersión indicando beneficiario, cuenta bancaria de destino y monto.
Obtén el detalle actualizado de cualquier PayOut en cualquier momento.
Cada solicitud queda registrada con su historial de estados para auditoría y conciliación.
¿Cómo funciona?
El proceso de un PayOut local en Perú sigue estas etapas, desde la solicitud hasta la confirmación de la transferencia.
- Creación de la solicitud de PayOut. Tu sistema llama a la API de ProntoPaga indicando el beneficiario, la cuenta bancaria destino y el monto a dispersar. No se requiere ningún PayIn previo.
- Registro y confirmación de recepción. Cuando se registra la solicitud, ProntoPaga asigna un identificador único.
- Revisión y procesamiento interno. ProntoPaga revisa la solicitud y ejecuta la transferencia bancaria local. Durante este proceso, el PayOut puede quedar temporalmente en estado de
on_holdsi existe algún impedimento que requiera resolución. - Consultar el estado del PayOut. En cualquier momento puedes consultar el estado actualizado de tu PayOut usando su identificador. Esto te permite hacer el seguimiento de la transferencia.
- Actualización al estado final. Una vez ejecutada la transferencia, el estado del PayOut se actualiza a su valor definitivo:
completedsi la operación fue exitosa, ofailedsi no pudo ejecutarse. Ambos son estados finales.
Cuenta internaLos fondos se dispersan desde el saldo disponible en tu cuenta registrada en ProntoPaga.
Monedas y límites
Las monedas disponibles para este producto están en formato ISO 4217.
- PEN
- CLP
- USD
Los montos permitidos por transacción son:
- Monto mínimo: 1
- Monto máximo: 100000000000
Genera un PayOut
Para conectarte de forma segura con las APIs de ProntoPaga y gestionar tus dispersiones, debes generar un access token utilizando tus credenciales (clientId y clientSecret). Estas credenciales se te proporcionarán durante el onboarding por ProntoPaga. Conoce el endpoint para generar tu access token.
Para solicitar una dispersión, envía un request a este endpoint indicando beneficiario, cuenta destino y monto.
Estados
Las siguientes tablas muestran los estados de creación de un PayOut y los posibles estados derivados del endpoint de detalles de un PayOut.
| Estado | Endpoint | Escenario |
|---|---|---|
received | Detalle | Solicitud recibida y pendiente de revisión. |
completed | Detalle | Transferencia ejecutada y registrada. |
on-hold | Detalle | Ejecución de transferencia en pausa |
failed | Detalle | Error definitivo en la ejecución del PayOut. |
Respuestas
A continuación te mostramos las posibles respuestas que pueden derivarse de un PayOut.
Respuestas de creación de un PayOut
La siguiente tabla contiene las respuestas comunes que pueden derivarse de la creación de un PayOut.
| Código | Descripción / Mensaje |
|---|---|
201 | Solicitud de PayOut creada correctamente. |
401 | Unauthorized |
400 | Invalid document number for type {type} |
400 | Amount hasn't a valid format for currency origin |
400 | Payout reference id already exists |
400 | Internal account not found |
400 | Internal account hasn't enough funds to cover the refund |
400 | Bank account hasn't enough funds to cover the refund |
Respuestas de detalles de un PayOut
Esta tabla muestra las respuestas que pueden derivarse de la consulta de detalle de un PayOut.
| Código | Descripción / Mensaje |
|---|---|
200 | Consulta exitosa. |
401 | Unauthorized |
404 | Payout not found |
Respuestas de detalles de un PayOut por referenceId
referenceIdEsta tabla muestra las respuestas que pueden derivarse de la consulta de detalle de un PayOut por referenceId.
| Código | Descripción / Mensaje |
|---|---|
401 | Unauthorized |
404 | Payout not found |
Updated about 23 hours ago