Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление

Описание

ПО "ТБанк" позволяет производить оплаты через Систему быстрых платежей как с помощью кассовой платежной ссылки (см. настройки ниже), так и по динамическим 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
  • Якорь
    term
    term
    В таблице 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