Ticketnet пушкинская карта

Наша компания Цифровая фабрика, по одному из заказов, работала по программированию и настройке передачи данных в билетный реестр из существующего интернет магазина. Это материалы собранные к данному проекту.

• переработали механизм продажи по Пушкинской карте, возможность покупки есть только одного билета;
• дописали логирование передачи данных в реестр с полной записью передаваемых данных, полученных данных, а также полученных данных о кодах обмена (успешно, неуспешно и тд);
• дописали передачу не переданной информации о проданных билетах программными средствами, т.е. анализ обмена дает информацию, и досылаем в автоматическом режиме если что-то не было передано;

UPDATE 13.01.2022:
Опубликованы изменения в Правила реализации мер поддержки, добавлены кинотеатры и др. изменения.

Во вторых, Минкультом и Минцифры РФ утверждены методические рекомендации по техническому, технологическому внедрению проекта, это требования и правила, многие другие публикации также объяснения этих требований.

API для передачи информации в реестр сведений о билетах‌‌API для обмена идентификаторами системы «PRO.Культура.РФ»‌‌‌‌Общие рекомендации и ответы на вопросы по проекту «Пушкинская карта» по ссылке. Ссылка на нормативные документы по проекту “ПК” на сайте ПРО.Культура.РФ. ‌‌

И без Postman протестировать будет непросто, это Руководство пользователя Postman: Как использовать инструмент для тестирования API‌

Этапы технической настройки

Текст ниже личный опыт, а курсивом как эти шаги описаны в документе ‌‌Методические рекомендации по организационно-технологической подготовке организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта» ‌‌в разделе 3 ‌‌Порядок организационно-технологической подготовки организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта»

1. Зарегистрируйтесь на ПРО.Культура.РФ

Зарегистрируйтесь на портале. Создайте карточку учреждения. Свяжитесь с технической поддержкой платформы «PRO.Культура.РФ» по номеру 8 (800) 200-37-17, чтобы в карточке вашего учреждения была поставлена специальная отметка “Пушкинская карта” об участии в проекте.

2. Получите от банка-эквайера данные для настройки дополнительного платежного шлюза.

Мы настраивали Сбербанк, готовый плагин Сбербанка позволяет подключить только один платежный шлюз, мы доработали его для возможности создания второго платежного шлюза и дополнительной кнопки оплаты.

Настроить и (или) доработать СПКБ ОК/БО для осуществления продажи билетов на мероприятия, включенные в реестр мероприятий, на сайте (сайтах) в сети Интернет, входящих в состав СПКБ ОК/БО, с использованием кнопки или ссылки «Оплатить «Пушкинской картой»;

3. Получите от банка эквайера данные для раздела Терминалы на ПРО.Культура.РФ

Данные для “белого терминала” это Acquirer ID, Merchant ID, Terminal ID, MCC нового терминала (у нас “правильный” оказался 7991, он прописан был в Почта Банка, если выдадут другой надо уточнять, иначе нервы время).

Получить от банка-эквайера, предоставляющего УТД для ОК/БО,‌‌технические параметры УТД, которые ОК/БО планирует использовать для приема оплаты за билеты на мероприятия, включенные в реестр мероприятий (далее – «белые» УТД);

4. Зарегистрируйте «белый» терминал в разделе «Информация о терминалах».‌

• Название. Любое понятное для Вас
• Идентификатор института эквайера (Acquiring Institution Identification Code) это Acquirer ID
• Идентификатор продавца – владельца терминала (Card Acceptor Identification Code)* это Merchant ID
• Идентификатор терминала (Card Acceptor Terminal Identification) это Terminal ID
• Код вида деятельности терминала (Merchant Type) это MCC ‌‌(тут есть ловушка и проблема, интернет-эквайер может назначить один номер, в Почта Банке будет другой. Платежи не будут проходить)

Внести сведения (в том числе технические параметры) о «белых» УТД в личном кабинете ОК/БО на платформе «РКО.Культура.РФ» в соответствии с разделом «Как создать терминал» руководства пользователя платформы;

5. Создайте событие с подключенным терминалом

Создав мероприятие включив пункт Пушкинская карта и выбрав созданный терминал. приступайте к созданию событий в разделе «События». В анонсе мероприятия, проходящего в рамках программы «Пушкинская карта», необходимо поставить отметку «Участвует в проекте «Пушкинская карта» в специальном поле, заполнить поле «Терминал» и/или поле «Билетная система», указать цену и ссылку на покупку билетов. Затем  нужно отправить событие на модерацию.

6. Пройдите двойную модерацию мероприятия

После создания мероприятия на ПРО.Культура.РФ оно проходит модерацию у редакторов портала (её, теоретически, можно ускорить если позвонить 8 (800) 200-37-17 в поддержку). После прохождения модерация будет отметка о прохождении. Потом вторая модерация у региональных экспертов, ее через региональное Министерство культуры можно ускорить. После прохождения модерация появится вторая отметка.

7. Настройте передачу данных в реестр проданных билетов

Далее пункты в методических рекомендациях, это Методические рекомендации по внесению и получению сведений‌‌из реестра сведений о проданных билетах

Реестр проданных билетов это раздел на портале gosuslugi.ru. Текст инструкций по подготовке и проведению настройки и тестированию ниже, это:

• Инструкция по передаче данных в реестр сведений о проданных билетах
• Приложение 1. Тестирование интеграции с реестром билетов

Инструкции в виде PDF файлов с рабочими ссылками можно получить по звонку +7 495 647 1844 на горячую линию для бизнеса Почта.Банка. Скрыл ссылки на адреса реестров (это базы данных) и реестр тестирования (это гугл таблица онлайн), инструкции не опубликованы, их надо получать индивидуально.

Настроить и (или) доработать СПКБ ОК/БО для внесения и получения сведений из реестра сведений о проданных билетах в соответствии с Методическими рекомендациями по внесению и получению сведений из реестра сведений о проданных билетах;‌‌‌‌Протестировать запросы можно в Postman ‌‌API для передачи информации в реестр сведений о билетах тут

RRN (Reference Retrieval Number) это referenceNumber в обмене по API, ссылочный номер транзакции, присваиваемый платёжным шлюзом после её завершения, N12, 12 знаков.

8. Получите ключ подписи запросов к промышленному реестру (боевой ключ)

9. Отправьте результаты тестирования в Почта.Банк

10. Почта.Банк одобряет проведение платежей по мерчанту проекта «Пушкинская карта»

Всё готово говорит Банк и если платежи идут (не забудьте, в заказе номер телефона должен совпадать с номером телефона владельца Пушкинской карты) открывайте шампанское.‌‌Если нет, это нормально. ‌‌Известные проблемы:

• в заказе указывается не тот номер телефона на который зарегистрирована Пушкинская карта
• MCC не совпадает в Почта Банке и в эквайринге (на PRO.Культура.РФ)

Из личного кабинета банка (интернет эквайера), копируйте в текстом виде детали транзакции и отправляйте в Почта Банк. ‌‌Переписка, переписка и время шампанского всё равно настанет. У нас от начала до конца прошёл месяц.

Заключить с оператором соглашение о взаимодействии. (что делать описано в пункте 3.6)

Ниже тексты инструкций

ИНСТРУКЦИЯ ДЛЯ ПОДКЛЮЧЕНИЯ КАРТОЧНОГО ТЕРМИНАЛА, ПУШКИНСКАЯ КАРТА

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

• 1. Получить у своего банка-эквайера новые идентификаторы: Acquirer ID, Merchant ID, Terminal ID, MCC.
• 2. Провести работы на Вашей онлайн-площадке продажи билетов, внедрив отдельную кнопку оплаты покупки «Пушкинской картой», которая будет использовать полученные идентификаторы.
• 3. Внести данные о событиях и терминале (Acquirer ID, Merchant ID, Terminal ID, MCC) на сайте PRO.Культура.РФ
• 4. Зарегистрироваться в билетном реестре.
• 5. Дождаться завершения модерации на сайте PRO.Культура.РФ и регистрации в билетном реестре.
• 6. Обратиться в «Почта Банк» для проведения тестовых оплат и активации терминала на стороне «Почта Банк» по адресу pk@pochtabank.ru (в письме необходимо указать свой ИНН, а также Acquirer ID, Merchant ID, Terminal ID, MCC нового терминала, к письму необходимо приложить письмо банка-эквайера о выделении нового терминала, описание оплаты покупки билета кнопкой с «Пушкинской картой», скан записи события с новым терминалом на сайте PRO.Культура.РФ).

Рекомендации для участников программы «Пушкинская карта» на сайте ПРО.Культура.РФ

Ответы на вопросы по итогам вебинаров, посвященных проекту «Пушкинская карта» (устарел, нет упоминания о реестре проданных билетов)

Руководство пользователя Postman: Как использовать инструмент для тестирования API

Приложение 1. Тестирование интеграции с реестром билетов

версия 1.0.1 от 25.08.2021

Подготовка к тестированию

1. Изучите документацию по интеграции: https://docs.culture.ru/tickets/
2. Получите ключ для подписи запросов к тестовому реестру. Для этого:‌‌• Разместите заявку в реестре тестирования. Укажите название вашей организации, ее тип (БС – билетная система, БО – билетный оператор, ОК – организация культуры), ИНН, контакты ответственных за тестирование.‌‌• Специалисты предоставят токен для работы с тестовым реестром.
3. Реализуйте методы, необходимые вашим бизнес-процессам.‌‌Например, всем участникам необходимо реализовать метод передачи сведений о билете. Но билетным операторам, которые не участвуют в контроле посещений, необязательно реализовывать методы гашения билетов.

Проведение тестирования

При тестировании мы проверяем попадание информации в реестр по трем сценариям. Рекомендуем под каждый сценарий добавлять отдельный билет, не использовать ранее созданный.

1.Передача в реестр сведений о покупке‌‌Метод API: Добавление билета в реестр. ‌‌‌‌Действия:‌‌• Добавить билет‌‌• Получить номер билета в ответе от API

Проверяется прохождение аутентификации в реестре, наличие обязательных полей в запросе «создание билета». Ключевые поля — сведения о покупке (идентификатор покупателя, сумма покупки, идентификатор мероприятия, RRN – номер транзакции в НСПК). Статус билета «Создан» (В API «active»).

2. Передача в реестр сведений о возврате билета. ‌‌Метод API: Вернуть билет ‌‌‌‌Действия: ‌‌• Добавить билет ‌‌• Получить номер билета в ответе от API‌‌• Выполнить возврат билета

Проверяется изменение статуса билета на “возвращен” (в API «refunded»).

3. Передача в реестр сведений о гашении билета* ‌‌Метод АPI: Погасить билет‌‌‌‌Действия: ‌‌• Добавить билет ‌‌• Получить номер билета в ответе от API‌‌• Выполнить гашение билета.

Проверяется изменение статуса билета на «погашен» (в API «visited»).

*Только для билетных систем и организаций, самостоятельно реализующих билеты.

Остальные необходимые вашей организации методы вы можете протестировать самостоятельно.

Результаты тестирования

После проведения тестирования самостоятельно занесите в реестр тестирования сведения о методах и сценариях, которые вы протестировали.‌‌Ежедневно (по рабочим дням) проводится проверка реестра тестирования и сверка с результатами теста в тестовом реестре билетов. При подтверждении корректности прохождения основных тестовых сценариев предоставляется токен к промышленному контуру реестра билетов. Токен предоставляется контактному лицу, указанному в реестре тестирования.

Информационная поддержка

При возникновении проблем/вопросов участник тестирования может адресовать их в группу Telegram «Пушкинская карта: Билеты» узнать можно у коллег или региональном Министерстве культуры (в PDF файле ссылка на группу не верная):

• ‌Ниже инструкция по подключению от Почта.Банка, выше пункты разобраны подробно, тут кратко.

Часто задаваемые вопросы

Это можно сделать с 14 лет. «Пушкинская карта» — совместный проект Минкультуры, Минцифры и Почта Банка. Он позволяет молодым людям бесплатно посещать участвующие в программе театры, кинотеатры, музеи, выставки, филармонии и другие учреждения культуры за счет средств федерального бюджета.

• Участвовать могут молодые люди от 14 до 22 лет включительно.
• Деньги на покупку билетов поступают на карту «Мир».
• Номинал карты в 2022 году — 5000 ₽, до 2000 ₽ из которых можно потратить на билеты в кино — на фильмы, включенные в программу.
• В программе участвуют около 4000 организаций культуры.

Открыть Пушкинскую карту можно в специальном мобильном приложении «Госуслуги.Культура» или в отделении банка — участника программы. В 2022 году это можно сделать в отделении Почта Банка.

Приложение «Госуслуги.Культура» доступно в App Store и Google Play. QR-код для скачивания приложения размещен на Госуслугах.

• Зарегистрируйтесь на Госуслугах и подтвердите учетную запись. Это можно сделать с 14 лет, после получения паспорта.
• Установите мобильное приложение «Госуслуги.Культура». Оно доступно в App Store и Google Play. QR-код для скачивания приложения размещен на Госуслугах.
• Подтвердите выпуск Пушкинской карты. Вы можете оформить виртуальную карту «Мир» прямо в приложении или получить пластиковую карту в отделении Почта Банка, предъявив паспорт и СНИЛС.
• Выберите мероприятие из афиши в приложении или на сайте «Культура.РФ» и оплатите билет картой. При покупке билетов на сайте культурной организации или через кассу убедитесь, что организация участвует в программе. При покупке на сайте ищите кнопку «Оплатить Пушкинской картой».

Пушкинская карта — это банковская карта платежной системы «Мир», на которую государство перечислило субсидию, чтобы у молодежи была возможность бесплатно посещать культурные мероприятия.

Этой картой вы сможете оплачивать билеты на культурные мероприятия — все остальные операции по ней невозможны.

Пушкинская карта может быть выпущена в виде виртуальной карты или обычной пластиковой. Получить карту можно в мобильном приложении «Госуслуги.Культура» и в отделении Почта Банка.

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

По ней запрещены любые операции, кроме покупки и возврата ранее купленных билетов.

На билеты в кино, театры, музеи, выставки, концертные залы и другие организации культуры, участвующие в программе. Полный список мероприятий доступен в мобильном приложении «Госуслуги.Культура» и на сайте «Культура.РФ». На билеты в кино можно потратить до 2000 ₽. Приложение «Госуслуги.Культура» доступно в App Store и Google Play. QR-код для скачивания приложения размещен на Госуслугах.

1. Выберите мероприятие в мобильном приложении «Госуслуги.Культура», на сайте «Культура.РФ» или на сайте организации культуры, участвующей в программе. Приложение «Госуслуги.Культура» доступно в App Store и Google Play. QR-код для скачивания приложения размещен на Госуслугах.
2. Оплатите билет онлайн по виртуальной Пушкинской карте или в кассе организатора мероприятия, если получили пластиковую карту. При покупке билетов онлайн выберите кнопку «Оплатить Пушкинской картой».

Реквизиты для оплаты по виртуальной карте вы можете посмотреть в приложении «Госуслуги.Культура» во вкладке «Счет».

Полный список мероприятий можно посмотреть в мобильном приложении «Госуслуги.Культура» и на сайте «Культура.РФ». Приложение «Госуслуги.Культура» доступно в App Store и Google Play. QR-код для скачивания приложения размещен на Госуслугах.

При поиске мероприятий на сторонних ресурсах убедитесь, что организатор участвует в «Пушкинской программе», а на странице покупки билета есть кнопка «Оплатить Пушкинской картой».

Для оформления через мобильное приложение «Госуслуги.Культура» необходима подтвержденная учетная запись на Госуслугах.

Для оформления в банке понадобятся российский паспорт и СНИЛС.

Все граждане РФ, достигшие возраста 14 лет, обязаны получить паспорт по закону. Поэтому необходимо сначала получить паспорт, после чего можно будет оформить Пушкинскую карту.

Родители могут помочь ребенку зарегистрировать подтвержденную учетную запись на Госуслугах, но ребенок оформляет Пушкинскую карту на свое имя, используя свою учетную запись.

• Войдите в приложение под своей учетной записью на Госуслугах. Если вы еще не зарегистрированы, это можно сделать на Госуслугах. Приложение «Госуслуги.Культура» доступно в App Store и Google Play. QR-код для скачивания приложения размещен на Госуслугах
• Дальнейшие действия зависят от вида учетной записи.
• Если у вас подтвержденная учетная запись на Госуслугах, приложение попросит подтвердить выпуск Пушкинской карты.
• Если у вас неподтвержденная учётная запись или вы раньше регистрировались на Госуслугах по загранпаспорту, нужно будет ее подтвердить
• Если вы уже оформили Пушкинскую карту в отделении банка, она появится в приложении «Госуслуги.Культура» после авторизации. Затем вы можете выбирать и оплачивать билеты.
• Если карты еще нет, подтвердите ее выпуск через приложение. После проверки данных к вашему аккаунту будет привязана виртуальная Пушкинская карта и появится доступ к покупке билетов. Также в приложении вы будете видеть остаток по карте и реквизиты для онлайн-оплаты.

Виртуальная и пластиковая карта равнозначны. Пластиковую карту получать необязательно. Ее можно оформить, если нет возможности или неудобно использовать виртуальную. Для этого нужно обратиться в банк.

В 2022 году для выпуска пластиковой карты вы можете обратиться в Почта Банк. При себе необходимо иметь паспорт и СНИЛС.

Базовые технические требования к учреждениям культуры

1. Наличие личного кабинета на платформе PRO.Культура.РФ

• Ответственный сотрудник учреждения культуры заводит личный кабинет‌‌посредством регистрации на платформе PRO.Культура.РФ‌‌(e-mail/пароль/телефон/фио/пол).
• Ответственный сотрудник создает профиль учреждения культуры (в случае отсутствия), каждому учреждению присвоен личный идентификатор.
• Профили учреждений культуры содержат следующие сведения: уровень‌‌подчинения (федеральный, региональный, муниципальный), название и‌‌адрес, принадлежность (какому органу исполнительной власти‌‌подчиняется), тип учреждения.
• Для участия в программе ответственный сотрудник через свой личный‌‌кабинет размещает культурные события, соответствующие настоящим‌‌методическим рекомендациям, или их анонсы с указанием места и‌‌времени проведения, и кратким описанием.
• Соответствие учреждений культуры и мероприятий критериям участия в‌‌программе подтверждается экспертными советами также через платформу PRO.Культура.РФ, где посредством личных кабинетов всех экспертов реализован функционал подтверждения заявок для дальнейшего присвоения идентификатора «Участник программы» и размещения анонса в афише мероприятий программы «Пушкинская карта».

2. Возможность продажи билетов-онлайн

Подключена любая из онлайн-кассовых/билетных систем с обязательной‌‌возможностью оплаты банковской картой платежной системы «Мир».

• Билетная система учреждения должна быть объединена с кассовой‌‌системой (офлайн-билетные кассы) для данного учреждения культуры. (это обязательно, потому-что надо передавать данные в билетный реестр на Госуслуги, иначе оплата не будет работать. Автономные оффлайн кассы сами не будут передавать данные)
• Билетная система должна иметь функционал передачи данных о билетных продуктах, введения и маркировки новых типов билетов, передачи полных отчетных сведений о погашенных и возвращенных билетах и денежных транзакциях (выгрузка из банковской системы). (Одним предложением перечислены требования к передаче информации о покупке, возврате и гашении в билетный реестр, это обязательно, иначе оплата не будет проходить, Почта Банк не одобрит)

3. Наличие специально сканера для считывания QR-кода с билета

• Механизм контроля посещения мероприятия осуществляется посредством считывания специального qr-кода с билета при посещении учреждения культуры и передаваться на цифровые ресурсы Минкультуры России и АО «Почта Банк». Также будет реализована возможность персонификации билета по QR-коду и путем размещения фото гражданина как на виртуальной, так и на пластиковой карте. (Это требование к передаче информации о гашении билетов)

При оплате, номер телефона в заказе должен совпадать с номером телефона владельца Пушкинской карты.

Инструкция по передаче данных в реестр сведений о проданных билетах

1. Для передачи данных в реестр сведений о проданных билетах необходимо выполнить инструкцию, «Приложение 1. Тестирование интеграции с реестром билетов», при этом важно реализовать следующие сценарии:‌‌a. Передача сведений о купленных билетах, включая передачу RRN (уникального номера транзакции в платежной системе МИР);‌‌b. Возврат билета;‌‌c. Гашение билета (для организаций культуры и билетных систем)
2. При тестировании необходимо убедиться, что сведения передаются в тестовый реестр по адресу: скрыто
3. Ежедневно происходит проверка тестов и пройденные тесты отмечаются в реестре тестирования: скрыто‌‌Если вы считаете, что прошли тесты, но данные в реестре тестирования не меняются, проверьте п.2.
4. После прохождения тестирования (самостоятельно или с помощью билетной системы/оператора) будет предоставлен ключ подписи запросов к промышленному реестру. Ключ предоставляется по контактным данным, указанным в реестре тестирования. Убедитесь, что указали адрес электронной почты.
5. Адрес промышленного реестра: скрыто‌‌Убедитесь, что при передаче сведений подписываете запросы ключом, полученным в п.4.
6. Если часть билетов «Пушкинской карты» вы реализовали до подключения к реестру, не забудьте передать сведения о них в реестр.
7. Если после выполнения всех пунктов в вашу организацию обратились представители банков-операторов программы, убедитесь, что не совершили типовые ошибки, описанные ниже. После их исправления см.пункт 6.
8. При необходимости вы можете обратиться в службу технической поддержки мобильного приложения «Госуслуги.Культура» по адресу culture@gosuslugi.ru ‌‌(лучше добавить в копию еще адрес pro@team.culture.ru)

Обращение необходимо заполнить по установленной форме (файл «Приложение 2. Форма подачи заявки»), указав:‌‌• сведения об организации (название и ИНН);‌‌• способ передачи (самостоятельно или через билетную систему/оператора, какую систему/оператора используете);‌‌• дату и время отправки сведений в реестр;‌‌• номера транзакций (RNN);‌‌• номера записей о билетах, полученных при отправке «проблемных» билетов в реестр.‌‌ВАЖНО! К обращению необходимо приложить выгруженный реестр сведений о переданных билетах накопительным итогом, начиная с 31 августа 2021 г., см. файл «Приложение № 3. Реестр билетов накопительным итогом».‌‌Без передачи этих сведений срок ответа службы поддержки может быть увеличен.