Reportes del negocio
POST
Reporte de pagos en línea sin aplicar
POST /api/reports/list-orphan-payments
Descripción
Devuelve el listado paginado de pagos en línea que se aprobaron pero no se aplicaron a su pedido, con el total pendiente por conciliar.
Detalles
Reúne los pagos en línea que la pasarela aprobó pero que no se pudieron aplicar a su pedido: el pedido ya se había cerrado o cancelado, no había una caja abierta al momento de acreditar, o el monto ya no correspondía al saldo. Cada pago trae el pedido relacionado, el motivo por el que no se aplicó y la referencia de la pasarela para gestionar la devolución. Acompaña al listado un resumen con la cantidad de pagos y el monto total por resolver en el período. Permite acotar por rango de fechas y por búsqueda de pedido, correo o referencia.
Permisos requeridos
reports.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
| dateFrom | string | No |
max:30
|
| dateTo | string | No |
max:30
|
Paginación
| defaultLimit | 25 |
| maxLimit | 100 |
| allowedSorts | settledAt, amountInCents, orderCode |
| defaultSort | settledAt |
| defaultDir | desc |
| withTotal | true |
Ejemplo de request
curl -X POST https://restofy.pro/api/reports/list-orphan-payments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.