программы «Пушкинская карта» —
Нормативные документы
1. получает с применением платформы «PRO.Культура.РФ» уникальный произвольный набор символов, с применением которых обеспечивается идентификация и аутентификация для использования метода одобрения реализации билета (далее – ключ доступа к сервису оператора). Ключ доступа к сервису оператора не должен содержать персональные данные и не должен является электронной подписью;
2. дорабатывает информационную систему продавца билетов для использования и учета результатов использования метода одобрения реализации билета в процессе продажи билетов согласно следующему алгоритму:
1) получить сведения об операции покупки билета с использованием устройства терминального доступа ;
2) исключить оформление билета и отправку сведений о билете в реестр сведений о проданных билетах до получения ответа от сервиса оператора;
3) использовать метод одобрения реализации билета согласно описанию;
4) если метод одобрения реализации билета вернул статус «одобрено»:
продолжить оформление билета в соответствии с установленным в рамках деятельности продавца билетов порядком;
передать сведения о билете в реестр сведений о проданных билетах;
5) если метод одобрения реализации билета вернул статус «отклонено», выполнить следующие действия:
- незамедлительно выполнить с использованием устройства терминального доступа операцию отмены покупки (не допускается вместо операции отмены покупки выполнять операцию возврата денежных средств);
- уведомить покупателя билета о невозможности покупки билета по причине, указанной в детализации ответа от метода одобрения реализации билета в соответствии со описанием такого метода;
- отменить оформление билета, направление билета покупателю и отправку сведений о билете в реестр сведений о проданных билетах;
- действовать в соответствии с установленным в рамках деятельности участника программы «Пушкинская карта» порядком.
Метод прикладного программного интерфейса электронного сервиса оператора обращается в систему АО «Почта Банк» и предоставляет ответ в виде «одобрения» / «не одобрения» на запрос учреждения культуры, билетного оператора (агрегатора) и лица, предоставляющего доверенные информационные системы, о реализации билета клиенту.
- Требуемый HTTP-метод: POST
- URL для вызова: https://guc.pochtabank.ru/dbo/cultureantifraudservice/api/v1/validation
- Входные данные:
Имя заголовка | Обяз. | Описание | Валидация |
Authorization | + | JWT-токен авторизации, уникальный для каждого организатора мероприятия, полученный через интерфейс личного кабинета «PRO.Культура.РФ» | Стандартная проверка JWT-токена |
2. Параметры строки запроса
Параметр | Тип | Обяз. | Описание | Пример значения | Валидация в сервисе |
online | string | - | Возможные значения: [true, false] Рекомендуемое значение – false Параметр «true» используется только в 2 случаях: 1) при тестировании сервиса; 2) при необходимости принудительно запустить все проверки при повторном запросе. Если на первый запрос покупка билета была одобрена Сервисом оператора, то на повторный запрос будет отказ. | true | Значение входит в набор [true, false] |
3. Параметры JSON тела запроса
Параметр | Тип | Обяз. | Описание | Пример значения | Валидация в сервисе |
buyer | string | + | SHA-512 хеш от Ф. И. О. покупателя. Расчет хеша ведется от значения, полученного по следующему алгоритму: конкатенация фамилии, имени, отчества (при наличии) клиента, оформившего билет. Полученная строка приводится к нижнему регистру. Из полученной строки удаляются символы, не подпадающие под диапазон [а-яё]. Хеш является уникальным. | ДО расчета хеша (подготовленная строка): ивановиваниванович ПОСЛЕ расчета хеша (то, что необходимо передать в значении параметра): 466bf4097102b968852ecfd2b8b96009dc6a13286399c3b417eb4ea1ad6e11fc87f7c2c72645e2e7209ed7e7b72c2d4c314f31bc0dbd60e9ea047d9ab7a66869 | Параметр должен быть передан. Значение не должно быть пустым. Значение должно содержать только латинские буквы в нижнем регистре и цифры. |
termInstId | string | + | Идентификатор банка-эквайера в платежной системе НСПК. Если эквайринг Почта Банка, необходимо передать 100220 | 70372200101 | Параметр должен быть передан. Значение не должно быть пустым. Значение должно содержать только цифры. |
rrn | string | + | RRN транзакции покупки билета, который передается в реестр сведений о проданных билетах в параметре payment_rrn | 412368398448 | Параметр должен быть передан. Значение не должно быть пустым. Значение должно содержать только цифры. Минимальная длина 11 знаков. Максимальная длина 12 знаков. |
eventId | string | + | Идентификатор мероприятия из «PRO.Культура.РФ» | 41234 | Параметр должен быть передан. Значение не должно быть пустым.
Значение должно содержать только цифры. |
placeId | string | + | Идентификатор места проведения мероприятия из «PRO.Культура.РФ» | 2341 | Параметр должен быть передан. Значение не должно быть пустым.
Значение должно содержать только цифры. |
organizationId | string | + | Идентификатор организатора мероприятия из «PRO.Культура.РФ» | 342 | Параметр должен быть передан. Значение не должно быть пустым.
Значение должно содержать только цифры. |
eventSessionTimestamp | string | + | Дата-время начала сеанса мероприятия в формате UNIX timestamp. Значение необходимо формировать с точностью до секунды (миллисекунды не нужно, итоговая длина 10 цифр). Если мероприятие не разделяется на сеансы (например, посещение музея), то передать дату-время продажи билета.
Если мероприятие продолжительное и не разделяется на сеансы (например, посещение музея), то: - при продаже билетов в течение интервала времени проведения мероприятия, в параметре eventSessionTimestamp передать дату и время продажи билета; - при продаже билетов до начала проведения мероприятия (дата продажи меньше даты начала сеанса мероприятия), в параметре eventSessionTimestamp передать дату и время начала интервала проведения мероприятия. | 1628427600 | Параметр должен быть передан. Значение не должно быть пустым.
Значение должно содержать только цифры. Минимальная длина – 10 цифр. Максимальная длина – 13 цифр. |
clientBuyIpAddress | string | + | IP-адрес устройства, с которого производится покупка. Для офлайн-продаж, когда отсутствует IP-адрес, указать адрес 0.0.0.0 | 192.168.0.254 | Параметр должен быть передан. Значение не должно быть пустым.
Значение должно соответствовать формату IPv4 или IPv6. |
