Restofy Docs
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
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"
            }
        ]
    }
}