Ir al contenido

BookingDelete (Cancel)

DELETE {base_url}/1.0/bookings/{bookingId}

Cancela una reserva confirmada previamente.

Header Valor
Authorization Bearer <access_token>
Accept application/json
Parámetro Tipo Descripción
bookingId int ID de la reserva a cancelar
{
"cancellationPolicies": [
{
"startDate": "2027-05-12T00:00:00Z",
"endDate": "2027-05-15T23:59:59Z",
"amount": 116.00,
"currency": "USD"
}
],
"status": "CANCELLED",
"eventId": "81f900f8-5e24-43bb-b6d6-946ef8beac1f"
}

Una respuesta exitosa de BookingDelete puede omitir la propiedad error; no la exijas.

Status Significado
CANCELLED La cancelación tuvo éxito
CONFIRMED La cancelación falló; la reserva sigue activa
Código HTTP Mensaje Causa Qué hacer
1203 400 Your reservation is currently being created. Please wait a moment before accessing it. Observado al cancelar segundos después de crear la reserva, cuando todavía estaba en status CREATED Espera al menos 90 segundos tras crear la reserva y reintenta el DELETE
3003 500 Cannot get a valid response from the cancellation service Fallo del proveedor/interno Contacta a PriceTravel con el request, el response y el eventId
3005 500 Cancellation in progress but couldn’t be confirmed (timeout) La cancelación excedió el tiempo de espera y no se pudo confirmar Reintenta en unos minutos; verifica con BookingGet

La respuesta del DELETE devuelve las cancellationPolicies de la reserva, pero ningún campo con el importe realmente cobrado. Para saber qué se cobrará:

  1. Llama a BookingGet primero.
  2. Lee cancellationPolicies y calcula la penalización aplicable para la fecha de hoy.
  3. Luego llama a DELETE.
1. BookingGet (read cancellationPolicies)
2. Compute penalty for current date
3. Confirm with user
4. Wait until ≥90 seconds since booking creation (if recent)
5. DELETE /bookings/{bookingId}
6. Verify status === "CANCELLED" in response
7. If response is timeout/3005, retry BookingGet after 1-2 min
  • Cancelar una reserva que ya está CANCELLED devuelve éxito sin cargos adicionales.
  • Cancelar una reserva dentro de la ventana no reembolsable significa que se cobra la tarifa completa, pero el estado de la reserva igualmente pasa a CANCELLED.
  • Algunos proveedores no soportan la cancelación en absoluto — el error 1202 puede indicar esto.