Cancelar una reserva
POST /api/v1/bookings/{bookingId}/cancel
Cancela una reserva. La franja se libera, el dinero no se mueve: no se elimina ninguna línea de pago, no se recalcula ningún total pagado, no se reescribe ningún estado financiero. Un reembolso es otra operación.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Permitido |
Ejemplo
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/bookings/5b2c…/cancel"Respuesta
200 OK— la reserva,status: "CANCELLED".
Qué rechaza
422 Unprocessable Entity— la reserva ya está cancelada, completada o caducada.401 Unauthorized— clave ausente o no válida, o clave cuyo portador ha dejado la organización.404 Not Found— identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.429 Too Many Requests— más de 120 peticiones en un minuto para esta clave.
Irreversible. Una reserva cancelada no se reabre; hay que volver a reservar para el cliente. Un agente no cancela sin la autorización humana explícita para esa reserva exacta.