ВСЁ О СОЗДАНИИ САЙТОВ ДЛЯ ПРОДАЖИ БИЛЕТОВ

СТАТЬИ О СОЗДАНИИ САЙТОВ
СОЗДАНИЕ СОБЫТИЯ
ДОСТУП К API, ВЕБ-ФОРМА
ПОДКЛЮЧЕНИЕ ЭКВАЙРИНГА (СБЕР)
ПОДКЛЮЧЕНИЕ ОНЛАЙН-КАССЫ
ОПТИМАЛЬНЫЕ ПУТИ СОЗДАНИЯ САЙТА
ИСПОЛЬЗОВАНИЕ ВИДЖЕТА
РЕАЛИЗАЦИЯ API
РАЗРАБОТЧИКИ

Существует много сайтов для продажи билетов, лучшие из которых позволяют быстро выбрать события и места, легко купить на них билеты. При внешней простоте этих сайтов, за ними стоят сложные взаимосвязанные системы: билетный процессинг, API, эквайринг банка, протокол Оператора Фискальных Данных (ОФД), онлайн касса. Этот “backend” не заметен со стороны покупателя билетов, и мнимая простота существующих сайтов часто вводит в заблуждение как заказчиков, так и разработчиков новых решений.

Вне зависимости от выбора CMS или framework’а для создания сайта (клиентской части), необходимо осознавать наличие сложного функционала на его «серверной стороне», без которого невозможно продавать билеты. Оптимально, когда функции backend’а берет на себя одна из множества билетных платформ. Чтобы не идти сложным путем, не совершать ошибок и не «изобретать велосипед», стоит изучить собранный на этой странице опыт создания сайтов для продажи билетов клиентами платформы BIL24.

СТАТЬИ О СОЗДАНИИ САЙТОВ

Рекомендуем прочитать две статьи о создании сайтов для продажи билетов:

О дрелях, дырках, сайтах и билетах

Классика жанра

«Хочу свой сайт для продажи билетов…»

СОЗДАНИЕ СОБЫТИЯ

Событие (для продажи билетов на сайте) создается в приложении Редактор, там же делаются все необходимые настройки и осуществляется управление (рис.1).


рис. 1

Делать для сайта отдельную панель администратора сайта или dashboard не имеет смысла. Все необходимые функции уже реализованы в приложениях платформы.

В платформе BIL24 есть две зоны: Тестовая и Реальная. Все приложения платформы, включая Редактор, подключаются как к Тестовой, так и к Реальной зоне. Таким образом, можно создавать события в обеих зонах.

Для разработки сайта доступно множество событий в Тестовой зоне платформы:

- на сайте test.bil.cool (события разных видов в разных городах)

- на сайте bil1.pro (события с ценовыми категориями и тарифами)

- на странице Тестирование (события разных видов и конфигураций для тестирования новых сайтов и мобильных приложений)

ДОСТУП К API, ВЕБ-ФОРМА

Доступ к открытому API Тестовой зоны платформы BIL24 описан в документации. Для удобства исследования API можно применять Веб-форму, с помощью которой можно генерировать запросы к серверу и получать ответы в формате JSON (рис.2). Веб-форма реализована на Flutter и может быть установлена на компьютер или мобильный телефон нажатием кнопки "Установить" в браузере Google Chrome.

Рассмотрим работу веб-формы на примере команды GET_ALL_ACTIONS, и получим все события для указанного в документации интерфейса FID=1185 token=2f1173e2b12fd5a111b6 Тестовой зоны (рис.2):


рис. 2

Тело POST-запроса: {"command":"GET_ALL_ACTIONS","fid":"1185","token":"2f1173e2b12fd5a111b6"}.
URL тестовой зоны https://api.bil24.pro:1240/json

1. Выбор зоны: Тестовая или Реальная.

2. Выбор типа интерфейса. Объект Интерфейс (Frontend) необходим для взаимодействия с покупателями и продажи им билетов. Все билеты в платформе продаются через какой-либо интерфейс. Каждый интерфейс принадлежит Агенту и имеет уникальный идентификатор FRONTEND ID (FID, п.5) и соответствующий ему токен (п.6). Тип интерфейса определяет логику взаимодействия Агента и Покупателя билетов, а также набор доступных команд API.

Тип «Билетная система» подразумевает наличие у Агента собственной билетной системы с эквайрингом. Соответственно, для интерфейса типа «Билетная система», например, доступна команда PAY_ORDER, которая делает сформированный агентом заказ оплаченным в BIL24.

Тип «Браузер» подразумевает использование Агентом собственного эквайринга, подключенного в билетной платформе BIL24. В этом случае, заказ становится оплаченным после получения подтверждения из банка (команда PAY_ORDER не доступна интерфейсам типа «Браузер»).

Выбирайте тип «Билетная система», если используете собственную билетную систему. Выбирайте тип «Браузер», если делаете сайт или мобильное приложение, бэкендом которого является непосредственно BIL24.

3. Команда API BIL24, в примере – GET_ALL_ACTIONS.

4. Locale - предпочитаемый язык данных ответа в формате IETF BCP 47. Если не указано, используется значение ru-RU.

5. Frontend ID (FID) – уникальный идентификатор интерфейса (п.2).

6. Токен интерфейса (п.2), соответствующий FID (п.5).

7. По нажатию кнопки «Отправить» сгенерированный веб-формой JSON запрос (п.8) отправляется на URL выбранной зоны (п.1).

8. Тело запроса в формате JSON.

Далее в веб-форме представлен ответ на команду GET_ALL_ACTIONS

9. Список городов (содержит список площадок).

10. Список видов событий.

11. Список событий.

12. Результат запроса.

13. Описание результата запроса.

14. Время выполнения команды.

ПОДКЛЮЧЕНИЕ ЭКВАЙРИНГА (СБЕР)

Использование собственного интернет-эквайринга позволяет организаторам и агентам продавать билеты наиболее оптимально. Деньги от продажи каждого билета сразу поступают на собственный расчетный счет клиента BIL24 в банке. Преимущества такой схемы работы изложены на странице Интернет-эквайринг.

Платформа BIL24 в настоящий момент работает с интернет-эквайрингом Сбербанка. Чтобы подключить собственный эквайринг в платформе необходимо:

1. Обратится в банк и заключить договор на интернет-эквайринг. При заключении договора выбрать ОФД, с которым будет работать онлайн-касса.

2. Сначала, банк предложит тестовый доступ к своему эквайрингу, на электронную почту придет письмо следующего содержания:

Здравствуйте!

Авторизационные данные учетной записи TXXXX на тестовой среде платежного шлюза ПАО Сбербанк:

Для интеграции по API используйте следующие данные:
логин/пароль: TXXXX-api / TXXXX

Для авторизации в личном кабинете используйте следующие данные:
логин/пароль: TXXXX-operator / TXXXX


Данные для подключения тестового эквайринга (TXXXX-api / TXXXX) необходимо отправить на адрес support@bil24.pro. В течение 2-х рабочих дней этот эквайринг будет подключен к тестовой зоне платформы BIL24.

3. Используя тестовую зону BIL24 с подключенным эквайрингом (п.2), можно создать сайт, протестировать на нем покупку и возврат билетов. На сайте должно быть размещено пользовательское соглашение (договор-оферта), в котором указан порядок использования эквайринга (пример соглашения).

4. После успешных тестов и проверки сайта со стороны банка, Сбер выдаст «боевой» доступ для реального использования. Данные придут в письме следующего содержания:

Здравствуйте!

Авторизационные данные созданной учетной записи PXXXX на боевой среде платежного шлюза ПАО Сбербанк:

Для интеграции по API используйте следующие данные:
логин/пароль: PXXXX-api / XXX1
Потребуется смена пароля (Подробнее в разделе "Переключение в боевой режим" по ссылке)

Для авторизации в личном кабинете используйте следующие данные:
логин/пароль: PXXX-operator / XXX1
Потребуется смена пароля(Подробнее в разделе "Переключение в боевой режим" по ссылке)


Необходимо обязательно выполнить инструкции банка по смене паролей, и, после этого, отправить только учетные данные для интеграции по API на адрес support@bil24.pro. Данные для авторизации в личном кабинете не нужно никому сообщать.

«Боевой» эквайринг будет подключен в реальную зону платформы BIL24 в течение 2-х рабочих дней.

ПОДКЛЮЧЕНИЕ ОНЛАЙН-КАССЫ

Онлайн-касса необходима для продажи билетов, подробнее на странице Как принимать платежи в интернете.

Согласно 54-ФЗ, все платежи должны проходить через онлайн-кассу с фискальным накопителем. Вы обязаны подключиться к Оператору Фискальных Данных (ОФД) и направлять покупателям чеки в электронном виде.

Для интернет-продаж используйте облачную, или цифровую ККТ, которую можно интегрировать с системами обработки заказов и оплаты. Такая касса будет понимать, когда происходит покупка, и автоматически пробивать чек. То есть контролировать её работу в режиме живого времени, например, ночью, не придётся.

Выбирайте кассу, поддерживающую формат документов ФФД 1.2 — его обязаны использовать продавцы маркированных товаров. Если в вашем ассортименте таких товаров нет, вы вправе применять любой формат фискальных данных — 1.05, 1.1 или 1.2, но и касса, и фискальный накопитель всё равно должны поддерживать ФФД 1.2.

В форму заказа включите запрос электронной почты или телефона покупателя, чтобы направить ему электронный чек.

Сайт, касса и ОФД в этом случае взаимодействуют так:

Клиент оформляет и оплачивает заказ на сайте.

Платёж обрабатывается оператором (в зависимости от того, что вы подключили).

В случае успешной транзакции оператор передаёт данные о заказе онлайн-кассе.

Онлайн-касса отправляет чек покупателю и передаёт данные о заказе ОФД, а ОФД — в налоговую. Если касса не умеет делать это автоматически, придётся пробивать чеки вручную и направлять покупателям, причём не позднее следующего рабочего дня, но до момента, когда клиент получит заказ.


Заявить о желании использовать ОФД и онлайн-кассу необходимо при заключении договора интернет-эквайринга, так как Сбер имеет удобную интеграцию с различными ОФД.

ОПТИМАЛЬНЫЕ ПУТИ СОЗДАНИЯ САЙТА

Наиболее простой и эффективный способ создать сайт для продажи билетов – это использовать в качестве backend’а какую-либо билетную платформу. BIL24 предлагает для этого три основных варианта:

1. Интегрировать в создаваемый сайт виджет для продажи билетов (в нем уже реализован API BIL24).

2. Реализовать на создаваемом сайте API BIL24 самостоятельно, создав собственное решение от начала и до конца.

3. Комбинация первого и второго варианта: для получения информации о событии использовать API, а для продажи билетов – виджет.

Первый путь – самый быстрый и простой. Второй путь сложнее, но позволяет создать более гибкое и кастомизированное решение. Третий путь – это комбинация первых двух.

ИСПОЛЬЗОВАНИЕ ВИДЖЕТА

РЕАЛИЗАЦИЯ API

РАЗРАБОТЧИКИ