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

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

Описание#

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

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

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

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

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

  1. Получите bookingId бронирования для отмены
  2. Проверьте условия отмены через /api/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
VALIDATION_ERRORОшибка валидации запроса (HTTP 400)Проверьте обязательные поля и форматы значений
NO_TARGETSПод запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запросаПроверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
SUPPLIER_ERRORПоставщик вернул ошибку. Причина — текстом поставщика в поле messageРазберите message; при необходимости повторите запрос позже
SYSTEM_ERRORВнутренняя ошибка Travel APIПовторите запрос позже; при повторении обратитесь в поддержку с errorId

Помимо перечисленных TAPI-кодов, при ошибке на стороне поставщика в ответе может быть возвращён код ошибки поставщика без изменений (проброс) — набор таких кодов зависит от поставщика и не фиксирован.

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

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