Отмена бронирования (Cancel Booking)#

Отмена существующего бронирования отеля.

Описание#

Эндпоинт: POST /hotels/cancel_booking

Отменяет бронирование и возвращает информацию о штрафах и возврате средств.

Использование#

Используйте этот запрос для отмены бронирования. Перед отменой рекомендуется проверить условия отмены через /hotels/view_booking.

Основной сценарий#

  1. Получите bookingId бронирования для отмены
  2. Проверьте условия отмены через /hotels/view_booking (поле bookingInfo.isCancellable)
  3. Отправьте запрос на отмену
  4. Получите информацию о штрафах и возврате

Базовый пример#

1{
2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66"
3}

Ответ содержит:

1{
2  "canceledAtUtc": "2025-11-25T14:30:00+00:00",
3  "amounts": {
4    "original": { "amount": 15000.00, "currency": "RUB" },
5    "refunded": { "amount": 10000.00, "currency": "RUB" },
6    "penalty": { "amount": 5000.00, "currency": "RUB" }
7  }
8}

Детальная документация#

Типичные ошибки#

Код ошибкиПричинаРешение
BOOKING_NOT_FOUNDБронирование не найденоПроверьте bookingId
BOOKING_NOT_CANCELLABLEБронирование нельзя отменитьПроверьте условия через view_booking
BOOKING_ALREADY_CANCELLEDУже отмененоБронирование было отменено ранее

Связанные операции#

Backward Структура ответа Параметры запроса Forward