УКМ 4. Альфа-Банк. Кассовая платежная ссылка

Описание

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

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

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

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

qralpha_variable_stores – таблица с соответствием номера магазина в настройках Универсального интегратора и торговой системы
qralpha_variable_merchants – таблица с настройками параметров соединения и взаимодействия с банком для каждого магазина
qralpha_variable_terminals – таблица конфигураций для терминалов (касс)
qralpha_variable_transactions – таблица для хранения данных по транзакциям

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

qralpha_variable_stores:

Название	Значение	Описание
StoreID	string(128)	Идентификатор магазина в торговой системе
merchant	int	Идентификатор конфигурации из таблицы qralpha_variable_merchants

qralpha_variable_merchants:

Название	Значение	Описание
id	int	ID настройки для магазина. 0 – общая настройка для всех магазинов; значение зарезервировано
value	string в формате JSON	Хранит настройки в формате JSON:
		url	Адрес взаимодействия с банком
		pkey_alias	Алиас ключа для подписи запроса
		pkey	Ключ для подписи запроса
		ssl_local_cert	Локальный сертификат для организации соединения
		ssl_pkey	Закрытый ключ для организации соединения
		qrTtl	Время жизни запроса на оплату в минутах; значение по умолчанию = 5
		interval	Интервал повторения запроса (например, запроса статуса) в секундах; значение по умолчанию = 5
		timeout	Таймаут сетевого соединения с банком
		cancel_lifetim	Время жизни запроса на отмену транзакции в часах; значение по умолчанию = 0 (бесконечно)

qralpha_variable_terminals:

Название	Значение	Описание
TerminalID	string(128)	ID кассы в торговой системе
value	string в формате JSON	Хранит настройки в формате JSON:
		payload	Ссылка для отображения
		qrcId	ID ссылки
		qrTtl	Время жизни запроса на оплату в минутах; значение по умолчанию = 5
		TerminalNo	Идентификатор терминала в системе СБП

qralpha_variable_transactions:

Название	Значение	Описание
op_date	datetime	Дата обновления данных
id	bin	Уникальный идентификатор операции в системе Универсального интегратора в двоичном виде
cancel	bin	Уникальный идентификатор отмены операции в системе Универсального интегратора в двоичном виде
data	string в формате JSON	Данные по транзакции; фактически хранит ответ от банка без поля message и прочих ненужных полей

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

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

sudo systemctl stop qrpayd.service

sudo systemctl start qrpayd.service

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

________________________________________________

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

Важно! В связи с нестабильностью тестовой среды на стороне банка, на сервере интегратора единоразово потребуется прописать значение -i в следующей строке:

ExecStart=/usr/local/qrpay/qrpayd -d qrpayd -u qrpay -p xxxxxx

sudo mcedit /etc/systemd/system/qrpayd.service

ExecStart=/usr/local/qrpay/qrpayd -d qrpayd -u qrpay -p xxxxxx -i

sudo systemctl daemon-reload

sudo systemctl restart qrpayd.service

Настройки авторизации на кассовом сервере УКМ 4

Настройка оплаты на сервере УКМ 4

1. В настройках магазина нужно указать путь для параметра RabbitMQ сервер как amqp://ukm:xxxxxx@192.168.25.xxx:

Измененные параметры магазина надо сохранить.

2. Необходимо создать сервер авторизации QR оплата:

Добавление сервера авторизации QR оплата происходит стандартным образом на странице Параметры магазина и настройка операций – Интеграция – Серверы авторизации (вкладка слева), закладка Оплаты:

В настройках требуется указать следующие обязательные для заполнения параметры:

Название – наименование сервера авторизации подставляется системой автоматически при его добавлении, однако его можно изменить вручную.

Таймаут ожидания ответа, сек – время ожидания ответа от сервера указывается вручную, в секундах. Минимальное значение (оно же – значение по умолчанию) составляет 310 секунд. Так как касса является конечным звеном в цепочке узлов, участвующих в процессе проведения транзакции оплаты, значение данного таймаута ожидания должно быть строго больше, чем значение таймаута ожидания ответа от процессинга Альфа-Банка (на 10 секунд больше, чем значение operation_wait_timeout).

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

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

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

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

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

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

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

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

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

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

Примечание. Поддержка печати QR-кода на чековой ленте осуществляется только для ККТ СП 802 и Пирит.

6. Для привязки драфта кассовой ссылки необходимо использовать кассовую операцию QR-Оплата - проверка статической ссылки:

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

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

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

Проверка кассовой платёжной ссылки

Для осуществления QR-оплат, некоторые банки используют многоразовую платёжную ссылку СБП.

Считав сгенерированный QR-код, можно проверить соответствие считанной ссылки и ссылки в настройках Универсального интегратора, через который осуществляется взаимодействие с УКМ 4.

Проверка ссылки является специальной кассовой операцией и настраивается в разделе кассового сервера по адресу: Настройка сервера и оборудования – Оборудование ККМ – Раскладки клавиатуры (вкладка слева):

Кликнув на название используемой раскладки, можно перейти к окну с ее настройками, где необходимо выбрать клавишу, которая будет инициировать проверку кассовой ссылки, и в строке Функциональный под раскладкой нажать кнопку Поиск:

В появившемся окне нужно ввести (целиком или частично) название кассовой операции QR-оплата - проверка статической ссылки и выбрать верное соответствие из выпадающего списка: