Дерево страниц

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

Ключ

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

Оглавление

Описание

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

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

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

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

  • qrrsbqralpha_variable_configurationstores – таблица с общими настройками
  • qrrsb_merchant_configuration – таблица конфигураций для разных магазинов/юр. лиц
  • qrrsb_cash_configuration – с соответствием номера магазина в настройках Универсального интегратора и торговой системы
  • qralpha_variable_merchants – таблица с настройками параметров соединения и взаимодействия с банком для каждого магазина
  • qralpha_variable_terminals таблица конфигураций для терминалов (касс)
  • qrrsbqralpha_store_configuration – таблица с настройкой конфигураций (qrrsb_merchant_configuration) к конкретному магазину/юр. лицу
  • qrrsb_transaction – журнал транзакций

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

  • Общие настройки хранятся в таблице qrrsb_configurationvariable_transactions – таблица для хранения данных по транзакциям

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

  • qralpha_variable_stores:

Название

Значение

Описание

enabled

0 – нет

1 – да

Включить/выключить интеграциюoperation_wait_timeoutunsigned intВремя ожидания изменения статуса оплаты (в сек.)request_periodunsigned intПериод опроса статуса оплатыrsb_timeoutunsigned int

Время ожидания ответа на запрос к серверу банка (в мсек.)

rsb_urlstringАдрес обработки запросов к банку (https://212.46.217.150:7601/eis-app/eis-rs/businessPaymentService)write_log_to_file

0 – нет

1 – да

Включить/выключить запись запросов и отладочной информации в лог (информация об ошибках пишется даже при выключенной настройке)input_src

0 – по решению кассы

16 – только печатать

32 – только отображать

Способ отображения QR-кода на кассе

Если настройка отсутствует, то выставляется значение по умолчанию – 32.

Данное поле по умолчанию отсутствует.

  • Настройки для магазина хранятся в таблице qrrsb_merchant_configuration.

В контексте данной статьи, под "конфигурацией" понимается перечень настроек для магазина, объединенных одним идентификатором (поле id таблицы).

Конфигурация с id = 0 считается конфигурацией по умолчанию.

Если данные отсутствуют в текущей конфигурации, то они будут браться из конфигурации по умолчанию (с id = 0).

Если и в конфигурации по умолчанию данные отсутствуют, то будет использоваться значение по умолчанию (пустая строка), что приведет к ошибке в работе.

...

StoreID

string(128)

Идентификатор магазина в торговой системе
merchantintИдентификатор конфигурации из таблицы qralpha_variable_merchants
  • qralpha_variable_merchants:

Название

Значение

Описание

idint

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:

Название

Значение

Описание

ca_cert
TerminalIDstring
Сертификат УЦ банкаlocal_certstringКлиентский сертификатprivate_keystringПриватный ключsign_private_keystring

Приватный ключ для возвратов

rsb_accountstringРасчётный счет юридического лица, открытого в Банке Русский Стандартrsb_loginstringРегистрационный номер карточки клиента, зарегистрированной в информационных системах Банка Русский Стандартrsb_merchant_idstringИдентификатор ТСП в СБП
  • Задать конфигурацию для магазина можно в таблице qrrsb_store_configuration.

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

...

Название

...

Значение

...

Описание

...

(128)

 ID кассы в торговой системе

valuestring в формате JSONХранит настройки в формате JSON:


payload

Ссылка для отображения

qrcId

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

Идентификатор терминала в системе СБП

  • qralpha_variable_transactions:

Название

Значение

Описание

cash
op_
id
date
stringID кассы, приходящее в запросе от кассы (тэг TerminalID)qr_idstringID QR-кода, выдается при регистрации кассы в Банке Русский Стандартsource_idstringID запроса на регистрацию кассы, выдается при регистрации кассы в Банке Русский СтандартpayloadstringCсылка на СБП-оплату (содержимое QR-кода), выдается при регистрации кассы в Банке Русский Стандарт
datetime

 Дата обновления данных

idbin

Уникальный идентификатор операции в системе Универсального интегратора в двоичном виде

cancelbin

Уникальный идентификатор отмены операции в системе Универсального интегратора в двоичном виде

datastring в формате JSON

Данные по транзакции; фактически хранит ответ от банка без поля message и прочих ненужных полей

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

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

sudo systemctl stop qrpayd.service

sudo systemctl start qrpayd.service

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

________________________________________________

Название очереди RabbitMQ – qrrsb.очереди 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:

Image Modified

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

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

Image Modified

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

Image Modified

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

Image Modified

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

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

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

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

Image Modified

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

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

Image RemovedImage Added

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

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

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

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

Image Modified

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

Image Modified

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

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

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

Image Added

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

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

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

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

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

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

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

Image Modified

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

Image Modified

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

Image Modified

Откроется следующее окно:

Image Modified

В данном окне можно настроить права на пользование кассовой операцией, после чего необходимо кликнуть Применить.

В окне с раскладкой нужно нажать кнопку кнопку Сохранить:

Image Modified

В окне подтверждения выполненных настроек следует выбрать опцию Да:

Image Modified

Клавиша запуска проверки кассовой ссылки настроена.

На touch-кассе Lillo проверка кассовой ссылки вызывается из интерфейса самой кассы:

Image Modified

Якорь
onpos
onpos
На кассе УКМ 4 проверка статической ссылки происходит следующим образом:

Касса УКМ-клиентTouch-касса Lillo

1. Операция проверки ссылки вызывается нажатием специально запрограммированной клавиши, после чего открывается следующее диалоговое окно:

Image Modified

2. Как только QR-код будет считан сканером, появится сообщение о результатах проверки: 

Image Modified

либо:

Image Modified

1. Операция проверки ссылки вызывается нажатием специальной кнопки:

Image Modified

2. Откроется следующее диалоговое окно:

Image Modified

3. Как только QR-код будет считан сканером, появится сообщение о результатах проверки: 

Image Modified

либо:

Image Modified