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>" \
-H "X-Tenant-Key: <tenantKey>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"payments": [],
"pagination": {
"page": 1,
"limit": 25,
"total": 0,
"totalPages": 0,
"hasNext": false,
"hasPrev": false
},
"totals": {
"orphanCount": 0,
"orphanAmountCents": 0
}
}
}