Cobro de órdenes
POST
Asignar caja al cobro en línea
POST /api/pos-payment/set-online-payment-session
Descripción
Deja fijada la caja donde debe registrarse el cobro en línea del pedido antes de enviar el enlace de pago.
Detalles
La caja elegida debe tener una sesión abierta en ese momento. El cobro que llegue por el enlace se registra ahí y suma al cierre de esa caja. Si la sesión se cierra antes de que el cliente pague, el enlace deja de servir y hay que generar otro.
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
|
| cashRegisterId | int | Sí |
min_value:1
|
| paymentMethodId | int | Sí |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/pos-payment/set-online-payment-session \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"orderUuid": "string",
"cashRegisterId": 1,
"paymentMethodId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"orderUuid": "14ffc1b6-312a-4f1c-8f6f-d546bb6ed442",
"cashRegisterId": 1,
"paymentMethodId": 14
}Response
{
"success": true,
"message": "Caja asignada al cobro en línea",
"data": {
"cashRegisterSessionId": 2
}
}