Описание

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

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

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

  • qrshares_merchants – таблица для конфигурации в формате JSON
  • qrshares_stores – таблица соответствия для магазинов и конфигураций
  • qrshares_terminals – таблица конфигураций для терминалов (касс) формате JSON
  • qrshares_transactions – журнал транзакций

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

  • В таблице qrshares_stores находится связка между идентификатором магазина из запроса и его конфигурацией. Если магазина нет в таблице, то по умолчанию merchant = 0:
НазваниеЗначениеОписание
StoreID
Идентификатор магазина в торговой системе
merchant
Идентификатор конфигурации из qrshares_merchants
  • В таблице qrshares_merchants находятся настройки интеграции в формате JSON:
НазваниеЗначениеОписание
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
  • В таблице qrshares_terminals находятся настройки терминалов в формате 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-код покупателя:

Настройки необходимо сохранить.

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

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

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