Создание заказа

Создает заказ на бронирование номера отеля. В запросе передается booking_token — токен резервирования, который вернулся при вызове метода hotels/booking/offers/{offer_id} на получение предложений от отеля.

Формат запроса

POST https://whitelabel.travel.yandex-net.ru/hotels/booking/orders

{
  "booking_token": "(string)",
  "use_deferred_payments": (boolean),
  "customer_email": "(string)",
  "customer_phone": "(string)",
  "guests": [
    {
      "first_name": "(string)",
      "last_name": "(string)",
      "is_child": (boolean),
      "age": (integer),
    }
  ],
  "comment": "(string)",
  "promo_codes": ["(array of string)"]
}

Параметры запроса

Параметр	Тип	Описание
`booking_token`*	string	Токен резервирования, который вернулся в ответе метода `hotels/booking/offers/{offer_id}` на получение предложений от отеля.
`use_deferred_payments`	boolean	Признак того, что следует использовать рассрочку при заказе.
`customer_email`*	string	Электронная почта клиента, которая будет использоваться для связи с ним по заказу. Максимальная длина — 40 символов.
`customer_phone`*	string	Телефон клиента, который будет использоваться для связи с ним по заказу.
`guests`*	object	Информация о гостях.
`comment`	string	Комментарий к заказу. Параметр можно передать только для предложений, у которых при вызове метода `GET hotels/booking/offers/{offer_id}` вернулся признак `"can_send_comment_to_hotel": true`.
`promo_codes`	array	Список промокодов, которые нужно применить при создании заказа.
guests object
`first_name`*	string	Имя.
`last_name`*	string	Фамилия.
`is_child`	boolean	Признак того, является ли гость ребенком.
`age`	integer	Возраст ребенка.

* Обязательный параметр

Пример запроса

POST https://whitelabel.travel.yandex-net.ru/hotels/booking/orders

{
  "booking_token": "5DKLZ6eubchxwF...LilabAVGhtqSt7s96Ys",
  "use_deferred_payments": false,
  "customer_email": "customer@mail.ru",
  "customer_phone": "+79121234567",
  "guests": [
    {
      "first_name": "Иван",
      "last_name": "Иванов"
    },
    {
      "first_name": "Екатерина",
      "last_name": "Иванова",
      "is_child": true,
      "age": 3
    }
  ],
  "comment": "Был у вас в отеле. Пожалуйста, только не номер 123.",
  "promo_codes": ["SPRING-2023-XDKSJNHHSD"]
}

Формат ответа

{
  "order_id": "(string)",
  "status": "(string)"
}

Параметры ответа

Параметр

Тип

Описание

order_id

string

Идентификатор заказа.

status

string

Статус заказа. Возможные значения:

IN_PROGRESS — в обработке;
RESERVED — забронирован;
CONFIRMED — подтверждено;
CANCELLED — отменено (не было мест при бронировании).

Пример ответа

{
  "order_id": "21123ab4-0121-4fca-bdea-38fcd777b5c3",
  "status": "IN_PROGRESS"
}

Написать в службу поддержки

Была ли статья полезна?

Расчет цены заказа

Получение информации о статусе заказа