Имя заголовка

Обяз.

Описание

Валидация

Authorization

+

JWT-токен авторизации, уникальный для каждого организатора мероприятия, полученный через интерфейс личного кабинета «PRO.Культура.РФ»

Стандартная проверка JWT-токена

Параметр

Тип

Обяз.

Описание

Пример значения

Валидация в сервисе

online

string

-

Возможные значения: [true, false]

Рекомендуемое значение – false

Параметр «true» используется только в 2 случаях:

1) при тестировании сервиса;

2) при необходимости принудительно запустить все проверки при повторном запросе.

Если на первый запрос покупка билета была одобрена Сервисом оператора, то на повторный запрос будет отказ.

true

Значение входит в набор [true, false]

Параметр

Тип

Обяз.

Описание

Пример значения

Валидация в сервисе

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.