Описание
ПО АО "Банк Русский Стандарт" позволяет производить оплаты через Систему быстрых платежей как по протоколу для цифрового рубля (см. настройки ниже), так и с помощью кассовой платежной ссылки.
Настройки Универсального интегратора
Описание таблиц
- handlers – таблица для подключения QR-оплат
- merchants – таблица для мерчантов в формате JSON
- stores – таблица конфигураций для магазинов
- terminals – таблица конфигураций для терминалов (касс) формате JSON
- transactions – журнал транзакций
Структура таблиц
- В таблице handlers находится соответствие между названием очереди, типом QR-оплаты и идентификатором оплаты в Универсальном интеграторе:
| Название | Значение | Описание |
|---|---|---|
id | Идентификатор оплаты внутри Универсального интегратора | |
efts | 3 | Тип QR-оплаты |
queue | Название очереди |
- В таблице stores находится связка между идентификатором магазина из запроса и его конфигурацией. Если магазина нет в таблице, то, по умолчанию, merchant = 0:
| Название | Значение | Описание |
|---|---|---|
| handler | Идентификатор оплаты внутри Универсального интегратора | |
| StoreID | Идентификатор магазина в торговой системе | |
| merchant | Идентификатор конфигурации из merchants |
- В таблице merchants находятся настройки мерчантов в формате JSON:
| Название | Значение | Описание |
|---|---|---|
| handler | Идентификатор оплаты внутри Универсального интегратора | |
| id | Идентификатор конфигурации | |
| value | Url MerchantID qrTtl Login Account ca_cert local_cert sign_pkey | Конфигурация в формате JSON |
- В таблице terminals находятся настройки терминалов в формате JSON:
| Название | Значение | Описание |
|---|---|---|
| handler | Идентификатор оплаты внутри Универсального интегратора | |
| TerminalID | Идентификатор терминала из запроса. Если запрос идет от УКМ 4, то соответствует cash_id – идентификатор кассы в торговой системе | |
| value | qrcId – идентификатор QR-кода (32 символа) | Конфигурация в формате JSON |
Дополнительная информация
После заполнения данных в БД демона необходим перезапуск:
sudo systemctl stop qrpayd.service sudo systemctl start qrpayd.service |
|---|
RabbitMQ перезапускать не надо.
________________________________________________
Название очереди RabbitMQ – любое, заполняется в таблице handlers.
________________________________________________
Удобный просмотр поля id в transactions:
ALTER TABLE `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`;
Настройки авторизации на кассовом сервере УКМ 4
Настройка оплаты на сервере УКМ 4
1. В настройках магазина нужно указать путь для параметра RabbitMQ сервер как amqp://ukm:xxxxxx@192.168.25.xxx:
Измененные параметры магазина надо сохранить.
2. Необходимо создать сервер авторизации QR оплата:
Добавление сервера авторизации QR оплата происходит стандартным образом на странице Параметры магазина и настройка операций – Интеграция – Серверы авторизации (вкладка слева), закладка Оплаты:
В настройках требуется указать следующие обязательные для заполнения параметры:
Название – наименование сервера авторизации подставляется системой автоматически при его добавлении, однако его можно изменить вручную.
Таймаут ожидания ответа, сек – время ожидания ответа от сервера указывается вручную, в секундах. Минимальное значение (оно же – значение по умолчанию) составляет 310 секунд. Так как касса является конечным звеном в цепочке узлов, участвующих в процессе проведения транзакции оплаты, значение данного таймаута ожидания должно быть строго больше, чем значение таймаута ожидания ответа от процессинга Банка Русский Стандарт.
Таймаут соединения, сек – общая продолжительность соединения с сервером Универсального интегратора (указывается вручную, в секундах).
Настройки нужно сохранить.
3. Затем надо создать вид оплаты QR оплата:
Вид оплаты для сервера авторизации QR оплата создается стандартным образом.
В поле Модуль оплаты следует указать название очереди из поля queue таблицы handlers интегратора. Данное название может быть произвольным; главное, чтобы в типе QR-оплаты на сервере УКМ 4 было указано такое же название в поле Модуль оплаты. Ниже приведен пример совпадения названия для сервиса оплаты Яндекс:
Также нужно отключить чек-бокс Сканировать QR-код покупателя:
Настройки необходимо сохранить.
4. Опциональная настройка для вывода QR-кода на консоль или дисплей покупателя:
Если получателем QR-кода является ID-касса с консолью, то QR-код выводится на консоль, если киоск – то QR-код выводится на основной дисплей; во всех остальных случаях QR-код печатается на ККТ.
Метки протоколирования
RabbitMQ – Работа с сервером RabbitMQ.
QR_PAYMENT – Средство оплаты QR оплата.