Описание
Cервис "Социальный процессинг" обеспечивает выдачу льготным категориям граждан электронных социальных сертификатов, привязанных к карте МИР, которые они могут использовать в магазинах для оплаты социально-значимых категорий товаров. Какие карты будут относиться к ряду социальных, а также какие товары и на какую сумму можно будет с их помощью приобрести, определяет сервис "Социальный процессинг".
Со стороны УКМ 4, платежи через "Социальный процессинг" представляют собой специфический вид оплаты, работающий через Универсальный интегратор. Данный функционал в обязательном порядке требует наличия настроенной и корректно работающей оплаты через Сбербанк, так как для считывания социальных карт используется пин-пад Сбербанка.
Особенности:
- В одном чеке категорически не допускается более одной оплаты через сервис "Социальный процессинг". За соблюдением этого требования строго следит Универсальный интегратор.
- В ответе, передаваемым на кассу, товарные позиции, считающиеся социальными, помечаются свойством с кодом SOC_PROC и значением в формате "[номер позиции],[соц. стоимость позиции]".
- Частичный возврат социальных товаров невозможен, так как сторона сервиса "Социальный процессинг" не отвечает за вычисления цен и количества товаров.
- Если в возврате по чеку присутствуют социальные товары, то возврат через сервис "Социальный процессинг" должен быть выполнен первым, чтобы избежать коллизий при возврате смешанных товаров, оплаченных несколькими средствами оплаты.
Настройки Универсального интегратора
Описание таблиц
- soc_processing_stores – задается соответствие номера магазина в настройках Универсального интегратора и торговой системы
- soc_processing_merchants – настройки параметров соединения и взаимодействия с сервисом "Социальный процессинг" для каждого магазина
- soc_processing_terminals – настройки для кассы
- soc_processing_transactions – таблица для хранения данных по транзакциям
Структура таблиц
- В таблице soc_processing_stores находится связка между идентификатором магазина из запроса и его конфигурацией:
Название | Значение | Описание |
|---|---|---|
| StoreID | string(128) | Идентификатор магазина в торговой системе |
| merchant | int | Идентификатор конфигурации из soc_processing_merchants |
- В таблице soc_processing_merchants находятся настройки магазинов в формате JSON:
Название | Значение | Описание |
|---|---|---|
| id | int | Идентификатор конфигурации |
| value | string в формате JSON url – адрес взаимодействия с банком qrTtl – время жизни запроса на оплату (в минутах), по умолчанию = 5 interval – интервал повторения запроса (например, запроса статуса) (в секундах), по умолчанию = 5 timeout – таймаут сетевого соединения с банком cancel_lifetime – время жизни запроса на отмену транзакции (в часах), по умолчанию = 0 – бесконечно enterprise_id – идентификатор торгового предприятия, выдается при регистрации на сервисе "Социальный процессинг" merchant_id – идентификатор магазина, выдается при регистрации на сервисе "Социальный процессинг" sp_code – код социальной программы, выдается при регистрации на сервисе "Социальный процессинг" | Конфигурация в формате JSON |
- В таблице qralpha_variable_terminals находятся настройки терминалов в формате JSON:
Название | Значение | Описание |
|---|---|---|
| TerminalID | string(128) | ID кассы в торговой системе |
| value | string в формате JSON qrTtl – время жизни запроса на оплату (в минутах), по умолчанию = 5 TerminalNo – идентификатор терминала, выдается при регистрации на сервисе "Социальный процессинг" | Конфигурация в формате JSON |
- qralpha_variable_transactions – таблица для хранения данных по транзакциям:
Название | Значение | Описание |
|---|---|---|
| op_date | datetime | Дата обновления данных |
| id | bin | Уникальный идентификатор операции в системе Универсального интегратора в двоичном виде |
| cancel | bin | Уникальный идентификатор отмены операции в Универсальном интеграторе в двоичном виде |
| data | string в формате JSON | Данные по транзакции: фактически хранит данные из ответа от сервиса "Социальный процессинг", требуемые для возврата, отмены или просто идентификации операции |
Дополнительная информация
После заполнения данных в БД демона необходим перезапуск:
sudo systemctl stop qrpayd.service sudo systemctl start qrpayd.service |
|---|
RabbitMQ перезапускать не надо.
________________________________________________
Название очереди RabbitMQ – soc_processing.
________________________________________________
Настройки авторизации на кассовом сервере УКМ 4
Настройка оплаты на сервере УКМ 4
1. В настройках магазина нужно указать путь для параметра RabbitMQ сервер как amqp://ukm:xxxxxx@192.168.25.xxx:
Измененные параметры магазина надо сохранить.
2. Необходимо создать сервер авторизации QR оплата:
