...
ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация также может происходить с помощью QR-кода, который предъявляет участник социальной программы. Такой QR-код состоит из фиксированного префикса и шифрованного кода, который должен быть передан в процессинг социальной программы для идентификации ее участника.
Требования и предварительные условия
Версия УКМ 4 – 129 sp 2 или 130.
Лицензия – не требуется.
Операционная система – только Linux и Red Hat. Функционал не поддерживается для операционной системы Windows.
Настройка на сервере УКМ 4
1. Необходимо создать сервер авторизации Карта жителя от АО «Расчетные решения» в разделе кассового сервера Параметры магазина и настройка операций – Интеграция – Серверы авторизации (вкладка слева) – Программы лояльности лояльности (вкладка слевазакладка сверху):
Настройка на сервере УКМ4
2. Создайте внутреннюю автоматическую скидку УКМ4.
Перед сохранением окна с настройками, нужно обязательно указать значения параметров интеграции. Их предоставляет сторона сервиса "Карта жителя":
Примечание. При работе на кассах о операционной системой Red Hat необходимо включить опцию Игнорировать ошибки SSL.
2. Также, следует создать внутреннюю автоматическую скидку УКМ 4, соответствующую условиям скидки социальной программы для определенной категории участников.
Пример:
Пример: скидка "Скидка На чек по времени и сумме". В параметрах скидки во вкладке "Кому" введите id значение Кому необходимо ввести в поле " Категория льгот карты жителя от АО «Расчетные решения» идентификационный код (ID) категории граждан, которой будет предоставляться данная скидка по факту авторизации в чеке:
Примечание. Узнать значение кода категории граждан (ID) можно у представителей сервиса "Карта жителя", либо в логах кассы при считывании карты участника социальной программы.
При создании диапазона скидки, следует указать значения, соответствующие условиям скидки, предоставляемой категории граждан с указанным во вкладке Кому кодом.Создайте диапазон скидки, значение которого соответствует коду социальной группы.
Пример: если социальный код категории граждан (ID) равен 01 и для данной категории предусмотрена скидка 10%, то в настройках внутренней скидки необходимо создать диапазон именно в 10%.
Узнать значение ID можно в логах кассы при считывании карты УСП.
Кассовые операции
Настроенную скидку нужно сохранить.
3. Авторизация участника социальной программы осуществляется Регистрация УСП возможна при открытом чеке продажи через кассовую операцию "Карта жителя от АО «Расчетные решения»".
При вызове КО отображается список доступных типов авторизации: по QR-коду и по банк.карте.
Настройка Банковского терминала
Тестовые данные
Метка протоколирования
resident_card
Настройки авторизации
| Блок кода |
|---|
URL: https://test-sp-terminal-v4.secgw.ru/
Ключ соцпрограммы: OJ3shD/HRlwZ70nz8vGtaUaoycN0fSVaJkuSt6sARSk=
API-key: teaQScWOn8qKcnxhOYuKdU0M+gZtNh7+jT7+rmuSB3o=
Код магазина: 001
Таймаут запросов, c: 30
Код терминала: 1 |
Для запроса к терминалу для получения HMAC - префикс "SERT"
sb_pilot 104 /h=SERT
Тестовые карты
5469 3800 4161 1327 (УКМ5)
5570 0050 7129 7350 (УКМ5) - id 01
2202 2008 2829 2621 (УКМ4) - id 02
Способ получения QR-кода:
Вариант 1:
- берем наш тестовый телефон
- идем на последнюю страницу с иконками и находим "Карта жителя"
- запускаем, авторизуемся через Госуслуги (не переживать, это тестовые Госуслуги!):
- lenin.2027@bk.ru
/ Maxuk130595!! - в Приложении внизу "Мои карты" - там нажимаем на QR-код
- (доступен только в моб.приложении, если открывать в браузере, то qr-кода не будет).
Вариант 2:
- на свой телефон устанавливаем приложение "Карта жителя" - http://rcard-qa1-lk.secgw.ru
- далее, все как в Варианте 1.
- после отладки сносим приложение.
Мониторинг:
Доступ в ЛКО : https://test-sp-portal.secgw.ru/
Логин: ngorn
Пароль: rt2026
Наш магазин "001", остальные не трогать!
"Список покупок" - фильтруем по магазину 001
Особенности реализации
. Вызов данной кассовой операции на кассе УКМ-клиент осуществляется путем нажатия запрограммированной клавиши. Настройка клавиши осуществляется на кассовом сервере УКМ 4 по адресу: Настройка сервера и оборудования – Оборудование ККМ – Раскладки клавиатуры (вкладка слева):
Кликнув на название используемой раскладки, можно перейти к окну с ее настройками, где необходимо выбрать клавишу, которая будет вызывать функцию возврат по чеку, и в строке Функциональный под раскладкой нажать кнопку Поиск:
В появившемся окне введите (целиком или частично) название функции Карта жителя от АО «Расчетные решения» и выберите верное соответствие из выпадающего списка:
Откроется следующее окно. В данном окне можно развернуть блок Права и настроить в нем права на пользование добавляемым функционалом, после чего необходимо кликнуть Применить:
В окне с раскладкой нажмите кнопку Сохранить:
В окне подтверждения выполненных настроек нажмите Да:
Клавиша вызова функции настроена.
На touch-кассе Lillo функция возврата по чеку вызывается нажатием специально запрограммированной кнопки:
При вызове кассовой операции, на экране терминала отображается список доступных типов авторизации: по QR-коду или по банковской карте:
Метка протоколирования
resident_cardВключите опцию "Игнорировать ошибки SSL" при работе на кассах с ОС Red Hat.