История страницы

Введение

В 130 версии УКМ4 реализована система "Социального процессинга" через новый тип сервера авторизации для программы лояльности "Социальная карта жителя Камчатки".

Описание

Продукт "Карта жителя" от АО «Расчетные решения» предназначен для реализации социальных программ в виде различных льгот. Льготы предоставляются в виде скидок на перечень товаров, приобретаемых в розничных магазинах торговых предприятий. Как таковой, сервис АО «Расчетные решения» не рассчитывает сами скидки, а только сообщает (в виде кодов категорий) набор льгот, которые есть у участника социальной программы. Участник социальной программы может иметь одновременно несколько льгот. Перечень товаров, на которые распространяется определенная социальная льгота, определяется торговым предприятием и оформляется в виде скидок кассовой программы. Каждой льготе соответствует отдельная скидка. Скидки представляют собой перечень товаров с размером скидки в виде процента, одинакового для всех товаров одной скидки.

ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация также может происходить с помощью QR-кода, который предъявляет участник социальной программы. Такой QR-код состоит из фиксированного префикса и шифрованного кода, который должен быть передан в процессинг социальной программы для идентификации ее участника.

...

Требования и предварительные условия

130 версия УКМ4

Версия УКМ 4 – 129 sp 2 или 130.

Лицензия – Специальный модуль лицензии - не требуется.

Только ОС LinuxОперационная система – только Linux и Red Hat. Функционал не поддерживается для операционной системы Windows.

Настройка на сервере

...

УКМ 4

1. Создайте Необходимо создать сервер авторизации "Социальная карта жителя Камчатки" в разделе  Карта жителя от АО «Расчетные решения» в разделе кассового сервера Параметры магазина и настройка операций /– Интеграция /– Серверы авторизации/Программы лояльности

Image Removed

2. Создайте внутреннюю автоматическую скидку УКМ4.

(вкладка слева) – Программы лояльности (закладка сверху):
Image Added

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

Image Added 

Примечание. При работе на кассах о операционной системой Red Hat необходимо включить опцию Игнорировать ошибки SSL.

2. Также, следует создать внутреннюю автоматическую скидку УКМ 4, соответствующую условиям скидки социальной программы для определенной категории участников.

Пример:

Пример: скидка "Скидка На чек по времени и сумме". В параметрах скидки во вкладке "Кому" введите id значение Кому необходимо ввести в поле "Категория льгот социальной карты жителя Камчатки".карты жителя от АО «Расчетные решения» идентификационный код (ID) категории граждан, которой будет предоставляться данная скидка по факту авторизации в чеке:

Image Added

Примечание. Узнать значение кода категории граждан (ID) можно у представителей сервиса "Карта жителя", либо в логах кассы при считывании карты участника социальной программы.

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

Пример: если социальный код категории граждан (ID) равен 01 и для данной категории предусмотрена скидка 10%, то в настройках внутренней скидки необходимо создать диапазон именно в 10%.

Узнать значение ID можно в логах кассы при считывании карты УСП.

Image Removed

Кассовые операции

Регистрация УСП возможна при открытом чеке продажи через кассовую операцию "Социальная карта жителя Камчатки".

При вызове КО отображается список доступных типов авторизации: по QR-коду и по банк.карте.

Image Removed

Image Removed

Настройка Банковского терминала

Сбербанк. Соц. процессинг

Тестовые данные

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

kamchatka_social

Настройки авторизации

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^{Image Removed} / Maxuk130595!!
• в Приложении внизу "Мои карты" - там нажимаем на QR-код
• (доступен только в моб.приложении, если открывать в браузере, то qr-кода не будет).

Вариант 2:

• на свой телефон устанавливаем приложение "Карта жителя" - http://rcard-qa1-lk.secgw.ru
  • далее, все как в Варианте 1.
• после отладки сносим приложение.

Мониторинг:

Доступ в ЛКО : https://test-sp-portal.secgw.ru/     

Логин: ngorn 

 Пароль: rt2026

Наш магазин "001", остальные не трогать!

"Список покупок" - фильтруем по магазину 001

Особенности реализации

Настроенную скидку нужно сохранить.

3. Авторизация участника социальной программы осуществляется через кассовую операцию Карта жителя от АО «Расчетные решения». Вызов данной кассовой операции на кассе УКМ-клиент осуществляется путем нажатия запрограммированной клавиши. Настройка клавиши осуществляется на кассовом сервере УКМ 4 по адресу: Настройка сервера и оборудования – Оборудование ККМ – Раскладки клавиатуры (вкладка слева):

Image Added

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

Image Added

В появившемся окне введите (целиком или частично) название функции Карта жителя от АО «Расчетные решения» и выберите верное соответствие из выпадающего списка:

Image Added

Откроется следующее окно. В данном окне можно развернуть блок Права и настроить в нем права на пользование добавляемым функционалом, после чего необходимо кликнуть Применить:

Image Added

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

Image Added

В окне подтверждения выполненных настроек нажмите Да:

Image Added

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

На touch-кассе Lillo функция возврата по чеку вызывается нажатием специально запрограммированной кнопки:

При вызове кассовой операции, на экране терминала отображается список доступных типов авторизации: по QR-коду или по банковской карте:

Image Added

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

resident_cardВключите опцию "Игнорировать ошибки SSL" при работе на кассах с ОС Red Hat.