Описание
Продукт "Карта жителя" от АО «Расчетные решения» предназначен для реализации социальных программ в виде различных льгот. Льготы предоставляются в виде скидок на перечень товаров, приобретаемых в розничных магазинах торговых предприятий. Как таковой, сервис АО «Расчетные решения» не рассчитывает сами скидки, а только сообщает (в виде кодов категорий) набор льгот, которые есть у участника социальной программы. Участник социальной программы может иметь одновременно несколько льгот. Перечень товаров, на которые распространяется определенная социальная льгота, определяется торговым предприятием и оформляется в виде скидок кассовой программы. Каждой льготе соответствует отдельная скидка. Скидки представляют собой перечень товаров с размером скидки в виде процента, одинакового для всех товаров одной скидки.
ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация может происходить с помощью QR-кода, который предъявляет участник социальной программы. Такой QR-код состоит из фиксированного префикса и шифрованного кода, который должен быть передан в процессинг социальной программы для идентификации ее участника.
Требования и предварительные условия
Версия УКМ 4 – 129 sp 2 или 130.
Лицензия – не требуется.
Операционная система – только Linux.
Настройка на сервере УКМ 4
1. Необходимо создать сервер авторизации Карта жителя от АО «Расчетные решения» в разделе кассового сервера Параметры магазина и настройка операций – Интеграция – Серверы авторизации (вкладка слева) – Программы лояльности (закладка сверху):
Перед сохранением окна с настройками, нужно обязательно указать значения параметров интеграции. Их предоставляет сторона сервиса "Карта жителя":
2. Также, следует создать внутреннюю автоматическую скидку УКМ 4, соответствующую условиям скидки социальной программы для определенной категории участников.
Пример:
Скидка На чек по времени и сумме. В параметрах скидки во вкладке Кому необходимо ввести в поле Категория льгот карты жителя от АО «Расчетные решения» идентификационный код (ID) категории граждан, которой будет предоставляться данная скидка по факту авторизации в чеке:
Примечание. Узнать значение кода категории граждан (ID) можно у представителей сервиса "Карта жителя", либо в логах кассы при считывании карты участника социальной программы.
При создании диапазона скидки, следует указать значения, соответствующие условиям скидки, предоставляемой категории граждан с указанным во вкладке Кому кодом.
Пример: если код категории граждан (ID) равен 01 и для данной категории предусмотрена скидка 10%, то в настройках внутренней скидки необходимо создать диапазон именно в 10%.
Настроенную скидку нужно сохранить.
Кассовые операции
Регистрация УСП возможна при открытом чеке продажи через кассовую операцию "Карта жителя от АО «Расчетные решения»".
При вызове КО отображается список доступных типов авторизации: по 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
Особенности реализации
Включите опцию "Игнорировать ошибки SSL" при работе на кассах с ОС Red Hat.




