ПЕРЕДАЧА ДАННЫХ ПОКУПАТЕЛЯ БИЛЕТОВ И ПОСЕТИТЕЛЕЙ СОБЫТИЯ ПО API BIL24
краткий гайд
ПЕРЕДАЧА ДАННЫХ ПОКУПАТЕЛЯ БИЛЕТОВ И ПОСЕТИТЕЛЕЙ СОБЫТИЯ ПО API BIL24
краткий гайд
ОБЩАЯ ИНФОРМАЦИЯ
ПРИМЕНЕНИЕ В API BIL24
ИСПОЛЬЗОВАНИЕ FAN ID
API BIL24 позволяет при необходимости передать данные о покупателе билетов и посетителях события. Договоримся о терминах:
Заказ – один или несколько билетов, выбранных покупателем для единовременной оплаты. Один заказ может содержать билеты
на разные события и/или сеансы. Сформированный и переданный на оплату заказ нельзя изменить.
Покупатель - лицо, оплатившее заказ с билетами.
Посетитель - лицо, предъявляющее билет на входном контроле события.
Важно различать покупателя и посетителей. Каждый заказ оплачивает один покупатель, тогда как число посетителей равно числу
билетов в заказе. Данные покупателя (фамилия, имя, телефон, email) обычно используются для связи с ним в случаях отмены или
переноса события, уточнения какой-либо информации или условий. Данные посетителей (ФИО, дата рождения, FanID, документ,
удостоверяющий личность и т.п.) необходимы при проверке каждого билета и каждого человека на входном контроле.
Необходимость передавать данные покупателя и посетителей устанавливается в приложении Редактор событий, в расширенных настройках сеанса (рис.1):
рис.1
Данные покупателя билетов
Если в Редакторе установлены галочки «ФИ на билете обязательны» и «Номер телефона обязателен», то по API BIL24 придут поля
fullNameRequired=true и phoneRequired=true. Соответственно, в командах создания заказов CREATE_ORDER и
CREATE_ORDER_EXT должны передаваться
поля fullName и phone. Если эти поля отсутствуют, то заказ не будет создан. Имя покупателя может размещаться на всех билетах заказа с помощью
якоря $FIO на шаблоне билета.
Данные посетителей
Если данные покупателя билетов – это данный одного человека, оплатившего заказ, то на каждый билет в заказе необходимы данные каждого посетителя,
который будет проходить с билетом через входной контроль мероприятия. Эти данные нужно передать, если установлены галочки «Документ посетителя
обязателен» и/или «Дата рождения посетителя обязательна». В этом случае по API BIL24 приходят поля visitorDocRequired=true и/или
visitorBirthdateRequired=true. Данные передаются в поле visitorDataList (массив) команды CREATE_ORDER или
CREATE_ORDER_EXT.
Информацию о каждом посетителе необходимо собирать в случаях, когда доступ на событие требует проверки документа, удостоверяющего личность посетителя,
или углубленной проверки посетителя до его визита, например, на режимный объект.
Fan ID (или Карта Болельщика) - это электронный документ, который нужен для покупки билетов и посещения некоторых спортивных мероприятий. Если для покупки билетов требуется FAN ID, то по API BIL24 придет поле fanIdRequired=true. В этом случае с командой резервирования каждого места RESERVATION нужно передавать поле fanId (номер карты болельщика, телефон или email). FAN ID необходим только при резервировании конкретных мест на схемах с размещением.