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

Возвращает идентификатор созданного заказа.

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

POST https://api.tickets.yandex.net/api/agent/\
 ? action=order.create\
 & auth=<string>\
 & uid=<string>\
 & city_id=<number>\
 & name=<string>\
 & phone=<string>\
 & [email=<string>]\
 & [address=<string>]\
 & [customer_id=<number>]\
 & [utm_source=<string>]\
 & [promocode=<string>]\
 & [amount=<number>]\
 & [lang=<string>]\
 & [payment_id=<number>]\
 & [delivery_id=<number>]\
 & [delivery_day=<number>]\
 & [loyalties=\[\{"type":<string>,["discount": \{"price": <number>,"fee": <number>,"total": <number>\}]\}\]]\
 & fan_ids=\{"ticket-id-1": fan-id-1, "ticket-id-2": fan-id-2, ...\}\
 & spectators[0][user_id]=<string>\
 & spectators[0][ticket_id]=<number>\
 & spectators[0][name]=<string>\
 & spectators[0][surname]=<string>\
 & spectators[0][middle_name]=<string>\
 & spectators[1][user_id]=<string>\
 & spectators[1][ticket_id]=<number>\...

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

Query-параметр Описание
action string
Идентификатор запроса.
auth string
Идентификатор внешней системы.
uid string
Идентификатор сессии (не менее 20 случайных символов). Введите их самостоятельно и используйте для всей сессии с заказом.
city_id number
Идентификатор города.
name string
Имя покупателя.
phone string
Номер телефона покупателя.
email string
Электронный адрес покупателя.
address string
Адрес доставки заказа.
customer_id string
Идентификатор покупателя.
utm_source string
UTM-метка.
promocode string
Промокод.
amount string
Сумма номинальной стоимости билетов.
lang string
Язык покупателя.
Возможные значения:
  • ru — русский (по умолчанию);
  • en — английский;
  • ee — эстонский.
    payment_id string
    Идентификатор способа оплаты.
    delivery_id string
    Идентификатор варианта доставки.
    delivery_day string
    Дата доставки в формате yyyy-mm-dd.
    loyalties Массив объектов. Каждый объект содержит:
    • type * — string — тип.
      Если type = pushkin-card, тогда этот объект рассматривается как Пушкинская карта.
    • discount — object — расчет скидки. Если используется, то discount содержит следующие поля:
      • price * — number — цена.
      • fee * — number — размер скидки.
      • total * — number — общая стоимость с учетом скидки.
    * — Обязательное поле.
    fan_ids object
    Список номеров карт болельщика для прохода на футбольные матчи Российской Премьер Лиги.
    Объект содержит сопоставление одного или нескольких билетов с номерами карт болельщика:
    • ticket-id-n  — string — номер билета.
    • fan-id-n  — number — номер карты болельщика.

    Важно

    Для участников программы ЕБС действует правило передачи полей с данными зрителей spectators[][].

    Query-параметр Описание
    spectators[0][user_id]* string
    Идентификатор первого зрителя в заказе. Если в заказе есть второй, третий и далее зрители, в запрос необходимо добавить параметры spectators[1][user_id], spectators[2][user_id] и т.д.
    spectators[0][ticket_id]* number
    Идентификатор первого билета в заказе. Если в заказе есть второй, третий и далее билеты, в запрос необходимо добавить параметры spectators[1][ticket_id], spectators[2][ticket_id] и т.д.
    spectators[0][name]* string
    Имя первого зрителя в заказе. Если в заказе есть второй, третий и далее зрители, в запрос необходимо добавить параметры spectators[1][name], spectators[2][name] и т.д.
    spectators[0][surname]* string
    Фамилия первого зрителя в заказе. Если в заказе есть второй, третий и далее зрители, в запрос необходимо добавить параметры spectators[1][surname], spectators[2][surname] и т.д.
    spectators[0][middle_name] string
    Отчество первого зрителя в заказе. Если в заказе есть второй, третий и далее зрители, в запрос необходимо добавить параметры spectators[1][middle_name], spectators[2][middle_name] и т.д.

    * — Обязательное поле.

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

    JSON

    {
  "status": string,
  "result": {
    "id": number
  }
}

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

    Параметр Описание
    status string
    Статус выполнения запроса.
    Возможные значения:
    • 0 — запрос выполнен;
    • 1 — произошла ошибка.
      result object
      Результат выполнения запроса.
      result.id number
      Идентификатор созданного заказа.
      Предыдущая
      Отмена брони
      Следующая
      Проверка промокода