Описание

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

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

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

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

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

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

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

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

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

login  логин

password  пароль

partner_id  идентификатор торговой точки

key  ключ к подписи запросов

secret секрет для ключа к подписи запросов

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

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

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

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

payload шаблон построения кассовой ссылки, где %1 место, куда подставится автоматом partner_id, %2  место, куда подставится автоматом qr_id (см. настройки терминала ниже). Применяется, если не настроено на терминале

Конфигурация в формате JSON
НазваниеЗначениеОписание
TerminalID
Идентификатор терминала из запроса. Если запрос идет от УКМ 4, то соответствует cash_id идентификатор кассы в торговой системе
value

payload ссылка на QR

qr_id QR id; если отсутствует, то в качестве qr_id берется TerminalID

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

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

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

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

sudo systemctl stop qrpayd.service

sudo systemctl start qrpayd.service

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

________________________________________________

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

________________________________________________

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

ALTER TABLE `qrshares_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 оплата создается стандартным образом.

Специфическими являются только следующие настройки:

В поле Модуль оплаты необходимо указать значение qrshares.

Также нужно отключить чек-бокс Сканировать QR-код покупателя:

Настройки следует сохранить.

4. Необходимо настроить вывод QR-кода на консоль или дисплей покупателя:

Если от на стороне Универсального интегратора настроен payload и для кассы настроена консоль, то QR-код будет выводиться на консоль; на киоске QR-код будет выводиться на основной дисплей, во всех остальных случаях QR-код выводиться не будет.

Метки протоколирования

RabbitMQ – Работа с сервером RabbitMQ.

QR_PAYMENT – Средство оплаты QR оплата.