---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.ru/dev/travel-partners-api/doc/ru/booking-createOrder.md
---
# Создание заказа

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

## Формат запроса {#input}

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

```json
{
  "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)"]
}
```

## Параметры запроса {#input-params}

#|
||**Параметр**|**Тип**|**Описание**||
||`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
```

```json
{
  "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"]
}
```

## Формат ответа {#output}

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

## Параметры ответа {#output-params}

#|
||**Параметр**|**Тип**|**Описание**||
||`order_id`|string|Идентификатор заказа.||
||`status`|string|Статус заказа.
Возможные значения:
* `IN_PROGRESS` — в обработке;
* `RESERVED` — забронирован;
* `CONFIRMED` — подтверждено;
* `CANCELLED` — отменено (не было мест при бронировании).||
|#

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

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

<!-- source: ru/_includes/yellow-button.md -->
<a href="../support">
<span style="border: none; display: inline-block; ext-align: center; font-size: 15px;font-family: var(--yc-text-body-font-family); padding: 12px 30px; border-radius: 10px; color: black; background-color: #ffdb4d; margin-top: 20px;">Написать в службу поддержки</span>
</a>
<!-- endsource: ru/_includes/yellow-button.md -->