¶ Шаг 1.
При использовании собственного виджета для онлайн-продаж вам потребуется самостоятельно доработать его и добавить новую кнопку оплаты по Пушкинской карте.
Новые запросы по оплате заказа (в запросе добавлены дополнительные поля):
- RRN (Reference Retrieval Number) – это уникальный идентификатор банковской транзакции, который назначается банком-эквайером при инициализации платежа;
- terminal_id – номер терминала оплаты, через который осуществляется продажа/отмена платежа по Пушкинской карте;
- terminal_owner – ИНН владельца терминала (компания, зарегистрированная в PRO.Культура.РФ);
- event_id – код события, выданный в личном кабинете PRO.Культура.РФ при его создании.
По возврату заказа (в запросе добавлены дополнительные поля: RRN, terminal_id, terminal_owner, event_id).
¶ Шаг 2.
Доработайте внешний протокол по работе с билетной системой, чтобы передавать поля
"pro_culture_settings" :
{ "rrn": "", "terminal_id": "", "terminal_owner": "" }
¶ API Кинокасса
1. Новые параметры (опциональные поля rrn, terminal_id, terminal_owner)
ожидаемые в body запроса на роуте -> /api/v1/order/:order_id/approve Подтверждение заказа
"pro_culture_settings": {
"rrn": "",
"terminal_id": "",
"terminal_owner": ""
}2. Новые параметры (опциональные поля rrn, terminal_id, terminal_owner)
ожидаемые в body запроса на роуте -> /api/v1/order/:order_id/cancel Отмена заказа
@apiParamExample \{json} Request-body:
"pro_culture_settings": {
"rrn": "",
"terminal_id": "",
"terminal_owner": ""
}3. Новые параметры (опциональные поля rrn, terminal_id, terminal_owner)
ожидаемые в body запроса на роуте -> /api/v1/user/order/:order_id/cancel Отмена заказа клиентом
@apiParamExample \\{json} Request-body:
"pro_culture_settings": {
"rrn": "",
"terminal_id": "",
"terminal_owner": ""
}
¶ API Премьера
¶ Для Агентов и сайтов интернет продаж
С стороны Внешнего протокола доработаны запросы:
GetSessions
В ответе на запрос будет выводиться блок ProKult, если он присутствует у сеанса, то возможна оплата на данный сеанс по Пушкинской картой.
SaleApproved
Добавлены значения [type=pushkin;terminal_id=XXX;terminal_owner=YYY;rrn=ZZZ] для параметра PayByBonus.
SalePayReturn
Добавлен параметр PayByCard со значениями [type=pushkin;terminal_id=XXX;terminal_owner=YYY;rrn=ZZZ] .
¶ Шаг 3.
Получите от банка-эквайера технические параметры:
- Acquirer ID – идентификатор банка-эквайера;
- Merchant ID – идентификатор продавца/владельца терминала;
- Terminal ID – идентификатор продающего устройства или ТИД;
- MCC – категория продавца (строго 7832).
¶ Шаг 4.
В личном кабинете на сайте PRO.Культура.РФ заведите терминалы.
Внесите в поля информацию о терминале. Поля со звездочкой (*) обязательны для заполнения.
После заполнения полей нажмите кнопку Сохранить.
¶ Шаг 5.
В личном кабинете на сайте PRO.Культура.РФ заведите места – площадки, на которых проводятся события вашего учреждения.
Добавьте изображение, внесите в поля информацию о месте. Поля со звездочкой (*) обязательны для заполнения.
Для получения подсказки наведите курсор на значок
При заполнении поля Категория выберите из выпадающего списка нужный вариант:
После заполнения полей нажмите на кнопку Отправить на модерацию.
Более подробная информация в памятке от PRO.Культура.РФ: правила оформления места.
¶ Шаг 6.
Заведите события – анонсы культурных мероприятий.
Внесите в поля информацию о событии. Поля со звездочкой (*) обязательны для заполнения.
В поле Категория выберите из выпадающего списка Кино:
Данными из шаблона автоматически заполнятся следующие поля:
- изображение;
- название;
- возрастное ограничение;
- краткое описание;
- описание.
Если эти поля были заполнены вручную – они будут изменены.
Поставьте галочку напротив пункта Участвует в проекте «Пушкинская карта» :
В поле Шаблон выберите из выпадающего списка фильм:
В поле Терминал впишите название вашего терминала:
После заполнения полей нажмите на кнопку Отправить на модерацию.
Более подробная информация в памятках от PRO.Культура.РФ:
правила оформления кино в рамках «Пушкинской карты».
¶ Шаг 7.
После создания события ему будет присвоен идентификатор:
Идентификатор необходимо перенести в релиз в Букинге только после прохождения модерации.
В разделе Пушкинская карта нажмите Изменить и введите идентификатор в поле:
¶ Шаг 8.
Для тестирования терминала и включения его в «белый список» на стороне «Почта Банк» направьте на адрес pk@pochtabank.ru заполненную заявку и подписанное гарантийное письмо.
Бланк гарантийного письма:
Если файл не отображаеnся: ссылка на файл
Алгоритм описан в инструкции для подключения карточного терминала («Пушкинская карта»).
Правила заполнения заявок на включение в боевой режим терминала:
- Заявки необходимо направлять, предварительно убедившись, что события прошли полную модерацию, участвуют в проекте «Пушкинская карта» и в событиях указан подключаемый терминал (привязать свой терминал к тестовым событиям №1612506, 1612520 через Екатерину Рыбакову: telegram @e_rybakova, e-mail rybakova@team.culture.ru).
- Заявку необходимо направлять в виде заполненного excel-файла.
- В заявке не должно быть незаполненных полей.
- Данные о терминале необходимо копировать с сайта PRO.Культура.РФ из раздела Терминалы.
- Тестовые операции должны проводиться любой картой Почта Банка платежной системы МИР.