Описание

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

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

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

  • qrsberbank_dynamic_merchants – таблица для мерчантов в формате JSON
  • qrsberbank_dynamic_stores – таблица конфигураций для магазинов
  • qrsberbank_dynamic_transactions – журнал транзакций

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

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

Название

Значение

Описание

StoreID
Идентификатор магазина в торговой системе
merchant
Идентификатор конфигурации из qrsberbank_dynamic_stores
  • В таблице qrsberbank_dynamic_merchants находятся настройки мерчантов в формате JSON:

Название

Значение

Описание

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

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

userName – логин

password – пароль

clientId – номер (идентификатор) плательщика в системе партнера; используется для реализации функционала связок

merchantLogin – логин дочернего партнера (если используется)

sessionTimeoutSecs – продолжительность жизни заказа в секундах; если параметр не задан, будет использовано значение, указанное в настройках партнера или время по умолчанию (1200 секунд)

returnUrl – адрес, на который требуется перенаправить плательщика в случае успешной оплаты, когда партнер использует платёжную страницу платёжного шлюза

failUrl – адрес, на который требуется перенаправить плательщика в случае неуспешной оплаты, когда партнер использует платёжную страницу платёжного шлюза; если не указан, используется returnUrl

Конфигурация в формате JSON
  • В таблице qrsberbank_dynamic_merchants можно указать дополнительно наши настройки мерчантов в формате JSON:

Название

Значение

Описание

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

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

timeout – время (в секундах) ожидания ответа от Сбербанка; по умолчанию, 30 секунд

refund_interval – интервал (в секундах) между попытками возврата; по умолчанию, 1 секунда

refund_timeout – время (в секундах) на возврат; по умолчанию, 60 секунд

cancel_lifetime – время (в часах) для операции отмены; по умолчанию, отсутствует

inputSrc – куда выводить QR; по умолчанию, 0 (INTEGR_INPUTSRC_SHOW_QR_DEFAULT)

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

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

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

sudo systemctl stop qrpayd.service

sudo systemctl start qrpayd.service

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

________________________________________________

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

________________________________________________

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

ALTER TABLE `qrsberbank_dynamic_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 секунд. Так как касса является конечным звеном в цепочке узлов, участвующих в процессе проведения транзакции оплаты, значение данного таймаута ожидания должно быть строго больше, чем значение таймаута ожидания ответа от процессинга Сбербанка (на 10 секунд больше, чем значение timeout).

Таймаут соединения, сек – общая продолжительность соединения с сервером Универсального интегратора (указывается вручную, в секундах).

Настройки нужно сохранить.

3. Затем надо создать вид оплаты QR оплата:

Вид оплаты для сервера авторизации QR оплата создается стандартным образом.

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

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

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

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

4. Для корректной работы печати QR кода на фискальном устройстве, следует использовать стандартный профиль дизайна чеков – Сервис плюс:

5. Опциональная настройка для вывода QR-кода на консоль или дисплей покупателя:

Если получателем QR-кода является ID-касса с консолью, то QR-код выводится на консоль, если киоск – то QR-код выводится на основной дисплей; во всех остальных случаях QR-код печатается на ККТ.

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

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

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