Restofy Docs
Cobro de órdenes POST

Caja para el cobro en línea del pedido

POST /api/pos-payment/get-online-payment-setup

Descripción

Indica si el cobro en línea de un pedido ya tiene caja resuelta o si hay que elegir una entre las que están abiertas.

Detalles

Antes de generar un enlace de pago informa si el cobro puede liquidarse sin más datos. Cuando no puede, devuelve las cajas del local con sesión abierta para que quien atiende elija dónde cae el cobro. No modifica el pedido ni genera el enlace.

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-online-payment-setup \
  -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": "91213217-6eae-41c3-9a28-8442e42af8ed"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "needsCashRegister": true,
        "cashRegisters": [
            {
                "cashRegisterId": 1,
                "name": "Caja Principal",
                "location": "Principal",
                "cashSessionId": 2,
                "activeSessionOpenedAt": "2026-09-08T16:33:45.000Z",
                "activeSessionOpenedByActorName": "App Testing"
            }
        ],
        "selectedCashRegisterId": null,
        "electronicMethods": [
            {
                "paymentMethodId": 13,
                "name": "Wompi"
            }
        ],
        "selectedPaymentMethodId": null,
        "customerName": "",
        "customerPhone": ""
    }
}