Настройка оплаты по проекту «Пушкинская карта» в учреждении культуры

Ниже личный опыт настройки приема платежей в интернет-магазине, билетной системе организации культуры (ОК), до выпуска методических рекомендаций, с их выпуском всё описано полно и детально и они самый точный источник информации.

Откройте мир искусственного интеллекта с "Белоснежка | ChatGPT для всех" — сервисом, который делает взаимодействие с AI максимально доступным и удобным!

🚀 БЕЗ РЕГИСТРАЦИИ: Перейдите в Телеграм и погрузитесь в мир AI без лишних формальностей. Экономьте свое время на то, что действительно важно для вас!

📍 ДОСТУП В РОССИИ: Забудьте о VPN! Наш сервис работает в России без ограничений. Наслаждайтесь надежностью и комфортом "Белоснежка | ChatGPT для всех" уже сегодня.

🎙 УДОБНЫЙ ГОЛОСОВОЙ ВВОД: Оперативность и удобство — вот наши приоритеты. Говорите, и Белоснежка выполнит всё за вас!

👥 СПЕЦИАЛЬНО НАСТРОЕННЫЕ ПОМОЩНИКИ: Наши AI-помощники готовы к работе! Они помогут вам сосредоточиться и достичь новых высот в любой задаче.

🤖 ПРОДВИНУТЫЙ AI: Используйте нашу индивидуально настроенную платформу ChatGPT и откройте для себя всё многообразие искусственного интеллекта!

Не упустите шанс — присоединяйтесь к "Белоснежка | ChatGPT для всех" прямо сейчас и откройте для себя новые горизонты возможностей!

UPDATE:

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

Адрес техподдержки Минцифры culture@gosuslugi.ru - настройка и проверка ошибок передачи данных в реестр проданных билетов.‌‌‌‌Адрес техподдержки PRO.Культура.РФ pro@team.culture.ru - проверка ошибок информации о проданных билетах.‌‌‌‌Во первых я бы рекомендовал ознакомиться с Правилами реализации проекта "Пушкинская карта", официальное название документа "Правила реализации мер по социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры" , документ написан простым и понятным языком, насколько это возможно для официального документа. Все другие документы обязательно ссылаются на правила, и фактически трактовка и объяснение правил.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Зарегистрироваться на платформе «PRO.Культура.РФ» в соответствии с разделом «Как зарегистрироваться на платформе» руководства пользователя платформы, в случае если ОК/БО не были зарегистрированы на платформе «PRO.Культура.РФ» ранее;

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. Получите ключ подписи запросов к промышленному реестру (боевой ключ)

НЕ АКТУАЛЬНО. СЕЙЧАС ВСЁ СОГЛАСНО МЕТОДИЧЕСКИМ РЕКОМЕНДАЦИЯМ. ‌‌ГУГЛ ТАБЛИЦЫ БЫЛИ ДО МЕТОДИЧЕСКИХ РЕКОМЕНДАЦИЙ. ‌‌После тестирования заполните Гугл таблицу по пройденным тестам, поставьте галки, заливка в ячейках фиолетово-красным это эксперты похоже делают. ‌‌После выполнения тестов пишите на два адреса сразу pro@team.culture.ru и culture@gosuslugi.ru, или даже три partners@team.culture.ru. ‌‌По результатам тестирования получите боевой ключ для реестра проданных билетов. ‌‌ГУГЛ ТАБЛИЦЫ БЫЛИ ДО МЕТОДИЧЕСКИХ РЕКОМЕНДАЦИЙ. ‌‌Он будет отправлен на почтовый адрес который указали в реестре тестирования (Гугл таблице).

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

Отправьте боевой ключ в Почта.Банк pk@pochtabank.ru, это подтверждение прохождения тестов.

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

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

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

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

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

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

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

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. Реестр билетов накопительным итогом».‌‌Без передачи этих сведений срок ответа службы поддержки может быть увеличен.

Приложение 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 файле ссылка на группу не верная):

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

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

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

• 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.Культура.РФ).

Есть вопросы, мой телеграмм @otinoff

Источники:‌‌ИНСТРУКЦИЯ ДЛЯ ПОДКЛЮЧЕНИЯ КАРТОЧНОГО ТЕРМИНАЛА, ПУШКИНСКАЯ КАРТА на сайте ПОЧТА.БАНК

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

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

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

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

Подписывайтесь на новости Цифровой фабрики в Telegram:
Журнал Цифровая фабрика — всё об использовании новых технологий в жизни, культуре и продажах

Обложка: Midjourney

‌‌