Reservas de clientes
POST
Crear el depósito de una reserva
POST /api/reservations/create-reservation-advance
Descripción
Recibe el depósito de una reserva con el medio de pago elegido y la deja confirmada.
Detalles
* Registra el dinero recibido para asegurar la reserva y la confirma si estaba esperando ese pago. * Según lo definido al reservar, el dinero le queda al cliente como saldo a su favor o entra como ingreso del negocio. * Se recibe siempre desde una caja con sesión abierta, para que el dinero quede en el cierre de esa caja. * En efectivo el dinero entra a la caja; con los demás medios entra a la cuenta del medio elegido. * Falla si la reserva ya tiene un depósito, si no admite uno en su estado actual o si no tiene contacto asociado.
Permisos requeridos
reservations.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| reservationId | int | Sí |
min_value:1
|
| amountCents | int | Sí |
min_value:1
|
| mode | string | Sí |
enum:customer_advance,income
|
| paymentMethodId | int | Sí |
min_value:1
|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| notes | string | No |
max:300
|
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://restofy.pro/api/reservations/create-reservation-advance \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"reservationId": 1,
"amountCents": 1,
"mode": "string",
"paymentMethodId": 1,
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"reservationId": 4,
"amountCents": 5000000,
"mode": "customer_advance",
"paymentMethodId": 1,
"cashRegisterSessionId": 2,
"notes": "Depósito en caja"
}Response
{
"success": true,
"message": "Depósito registrado",
"data": {
"reservationId": 4,
"status": "confirmed"
}
}