Просмотреть исходный

ПО банка "Хлынов" позволяет производить оплаты через Систему быстрых платежей как с помощью кассовой платежной ссылки (см. настройки ниже), так и по подписке.

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

Процесс проверки кассовой ссылки описан здесь.

Процесс привязки кассовой ссылки описан здесь.

Настройки Универсального интегратора

Описание таблиц

qrbankhlynov_merchants – таблица для мерчантов в формате JSON
qrbankhlynov_stores – таблица конфигураций для магазинов
qrbankhlynov_terminals – таблица конфигураций для терминалов (касс) формате JSON
qrbankhlynov_transactions – журнал транзакций

Структура таблиц

В таблице qrbankhlynov_stores находится связка между идентификатором магазина из запроса и его конфигурацией. Если магазина нет в таблице, то по умолчанию, merchant = 0:

Название	Значение	Описание
StoreID		Идентификатор магазина в торговой системе
merchant		Идентификатор конфигурации из qrbankhlynov_merchants

В таблице qrbankhlynov_merchants находятся настройки мерчантов в формате JSON:

Название

Значение

Описание

id

Идентификатор конфигурации

value

url – адрес отправки запросов

ca – корневой сертификат

cert – сертификат мерчанта

pkey – ключ мерчанта

extEntityId – параметры для регистрации кассовой ссылки

merchantId – идентификатор зарегистрированного ТСП в СБП

account – номер счета: если у ТСП есть счет по умолчанию, то можно не указывать счет/синоним счета в запросе

accAlias – ID счета: применяется, чтобы не использовать фактическое значение номера счета; альтернатива указанию account

qrTtl – время жизни ссылки в минутах; по умолчанию, 5 минут

interval – интервал между опросами в секундах; по умолчанию, 5 секунд

return_interval – интервал между запросами во время отмены; по умолчанию, 3 минуты

timeout – тайм-аут ожидания http-ответа в секундах; по умолчанию, 30 секунд

cancel_lifetime – время жизни отмены платежа в часах; по умолчанию, 0 – бесконечно

Конфигурация в формате JSON

В таблице qrbankhlynov_terminals находятся настройки терминалов в формате JSON:

Название

Значение

Описание

TerminalID

Идентификатор терминала из запроса. Если запрос идет от УКМ, то соответствует cash_id – идентификатор кассы в торговой системе

value

payload – ссылка на QR: если есть, то высвечивается на кассе

qrcId – идентификатор QR: если нет, то вычисляется из payload

qrTtl – переопределяет из конфигурации merchant

Конфигурация в формате JSON

Дополнительная информация

После заполнения данных в БД демона необходим перезапуск:

sudo systemctl stop qrpayd.service

sudo systemctl start qrpayd.service

RabbitMQ перезапускать не надо.

________________________________________________

Название очереди RabbitMQ – qrbankhlynov.

________________________________________________

Удобный просмотр поля `id` в `qrbankhlynov_transactions`:

ALTER TABLE `qrbankhlynov_transactions` ADD COLUMN `RequetsID` char(38) GENERATED ALWAYS AS (LOWER(CONCAT( '{', HEX(LEFT(`id`, 4)), '-', HEX(MID(`id`, 5, 2)), '-', HEX(MID(`id`, 7, 2)), '-', HEX(MID(`id`, 9, 2)), '-', HEX(RIGHT(`id`, 6)), '}' ))) VIRTUAL AFTER `id`;

Настройки на сервере УКМ 5

Стандартные, а также специфические для использования кассовой ссылки.