Cobro de órdenes
POST
Pagos registrados de la orden
POST /api/pos-payment/get-order-payments
Descripción
Devuelve los cobros realizados sobre la orden con el método utilizado, monto, referencia y quién los registró.
Detalles
Retorna el listado de pagos asociados a la orden con la información necesaria para identificar cada cobro: monto, referencia, fecha, método de pago empleado y nombre del usuario que lo registró. Cuando el cobro se hizo con una gift card, un anticipo o un saldo a favor, también indica cuál de ellos se usó.
Permisos requeridos
orders.module
orders.integration
El usuario solo necesita uno de los permisos listados.
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| orderUuid | string | Sí |
min:36
max:36
|
Ejemplo de request
curl -X POST https://restofy.pro/api/pos-payment/get-order-payments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"orderUuid": "string"
}'
Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"orderUuid": "7a9b93bf-87d6-4972-899e-9becf4000124"
}
Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"payments": [
{
"paymentId": 1,
"amountCents": 4600000,
"receivedCents": null,
"changeCents": null,
"reference": null,
"paidAt": "2026-09-08T16:34:04.000Z",
"methodCode": "pay.advance",
"methodName": "Anticipo de cliente",
"methodIcon": "fa-solid fa-sack-dollar",
"methodColor": "#84cc16",
"registeredBy": "App Testing",
"prepaidBalanceType": "customer_advance",
"prepaidCode": null,
"prepaidPartyName": "Cliente Crédito"
}
]
}
}