...
ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация также может происходить с помощью QR-кода, который предъявляет участник социальной программы. Такой QR-код состоит из фиксированного префикса и шифрованного кода, который должен быть передан в процессинг социальной программы для идентификации ее участника.
Ограничения
...
1. Авторизация участника социальной программы по банковской карте возможна только с помощью кассовой операции, вызываемой вручную (по кнопке) на киосках/КСО и на линейных кассах.
2. Если участник социальной программы был авторизован по банковской карте и оплата покупки будет происходить по банковской карте, то при оплате карту необходимо будет повторно аутентифицировать в банковском терминале.
Как это выглядит на кассовом терминале
...
1. Покупатель добавляет товары в чек.
2. Если покупка оформляется на линейной кассе, то кассир вызывает кассовую операцию Социальная карта, если на киоске/КСО – то покупатель нажимает эту кнопку сам:
...
3. Касса предлагает меню авторизации участника программы лояльности из двух пунктов (по QR-коду/по банковской карте):
...
3.1. Если выбирается опция по QR-коду, то касса предлагает его ввести (возможно только путём считывания сканером) и самостоятельно выделяет из него шифрованную часть кода карты.:
3.2. Если выбирается опция по банковской карте, то касса делает обращение к банковскому терминалу Сбербанка с операцией получения закодированного кода карты.:
4. Касса обращается с полученным кодом карты или с шифрованной частью QR-кода в социальный процессинг.
5. Касса получает в ответе перечень кодов льгот, которые имеет данный участник программы лояльности и выводит на экран сообщение о том, что социальная карта добавлена в чек:
...
6. При нажатии кнопки Продолжить социальная скидка (с указанием категории льгот) применяется в чеке6. Касса рассчитывает скидки, соответствующие полученным категориям льгот, и оставляет в чеке одну с максимальным значением.:
7. Кассир/покупатель переходит к оплате чека.
...
9. Касса отравляет в социальный процессинг информацию о сумме скидок по социальной программе, предоставленных ее участнику (если они не равны нулю).
Особенности реализации
1. В чеке может быть авторизован только один участник социальной программы. Повторная авторизация участника социальной программы в чеке заменяет предыдущую.
2. Социальная скидка предоставляется до списания баллов бонусных программ.
3. В чеках с рассчитанными социальными скидками сохраняется код аутентификации участника социальной программы.
4. После оформления чека, касса передает в социальный процессинг информацию о сумме предоставленной скидки, если она не равна 0. Если в момент завершения чека социальный процессинг не доступен, то касса передает данную информацию в отложенном режиме.
5. Код аутентификации участника социальной программы выгружается в составе чека в торговую систему.
6. При возврате товаров участником социальной программы, взаимодействия с социальным процессингом не происходит.
Настройки
На стороне УКМ 5
1. Взаимодействие между кассовой системой и сервисом социального процессинга происходит в открытой сети (Интернет).
- Используется протокол HTTPS, TLS v1.0/v1.1/v1.2
- Обмен данными между КС и «Социальным процессингом» инициирует КС с помощью POST запросов.
На кассовом сервере по адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:
В конфигурационном файле sale.conf (applications\sale\sale.conf) в блоке UI необходимо выставить значение параметра socialCardEnabled как true, после чего – сохранить файл:
2. В этом же файле в блоке BL нужно раскомментировать (или добавить, если ее нет) следующую строку, после чего – сохранить файл:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
include file("conf/applications/sale/social_processing.conf") |
3. После этого, необходимо выполнить настройки в файле social_processing.conf (applications\sale\social_processing.conf):
| Блок кода | ||||
|---|---|---|---|---|
| ||||
# Настройка взаимодействия с соц.процессингом (социальная карта жителя Камчатки).
socialProcessing: {
baseUrl = "https://test-sp-terminal-v4.secgw.ru" # URL шлюза СП
# --- Заголовки запросов к СП ---
x-social-program-key = "socialprogramkey" # Ключ соцпрограммы торгового предприятия
x-merchant-key = "merchantkey" # API-key торгового предприятия
x-shop-id = "001" # Код магазина. Если не указан — внешний id-магазина, затем id-магазина в КС.
timeout = 10 seconds # Таймаут ожидания ответа от СП
include file("conf/misc/social_processing.conf")
} |
Значения перечисленных ниже параметров следует получить у представителей сервиса социального процессинга:
baseUrl – URL-адрес шлюза социального процессинга;
- x-social-program-key – ключ соцпрограммы торгового предприятия;
- x-merchant-key – API-key торгового предприятия;
- x-shop-id – код магазина; если он не указан, то используется внешний ID магазина; если и он не указан – то ID магазина в кассовой системе;
- x-terminal-id – номер кассового терминала; если он не указан, то используется GUID кассы.
Примечание. Если данный файл отсутствует в иерархическом древе, то его (с указанным выше содержимым) следует разместить по адресу: applications\sale:
4. Для обеспечения возможности авторизации участника социальной программы в чеке по банковской карте, необходимо на кассовом сервере по адресу: Магазин – Кассы выбрать нужную кассу и нажать кнопку Оборудование:
В конфигурационном файле sbrf_lin.conf (hardware\bank\sbrf_lin.conf) нужно раскомментировать (или добавить, если отсутствует) следующую строку, после чего – сохранить файл:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
sbPilotKey = "SERT" # Ключ шифрования для команды sb_pilot 104 (формирование HMAC карты жителя). Строка от 3 до 12 символов. |
5. Далее, необходимо вернуться по адресу: Магазин – Типы касс, выбрать тип кассы и нажать кнопку Настройки:
6. В разделе socialProcessing конфигурационного файла offline.conf (services\offline.conf) можно выполнить настройку тайм-аутов взаимодействия кассовой системы с социальным процессингом:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
socialProcessing: {
sendLimit = 20 # количество попыток отправки запроса
restRetryErrors = ["200", "90001"] # массив статус-кодов, по которым сервис будет понимать, переотправлять запрос или нет
connectTimeout = 10 seconds # таймаут подключения
readTimeout = 15 seconds # таймаут получения ответа
} |
Примечание. Если раздел socialProcessing отсутствует в файле offline.conf (services\offline.conf), то его (с указанным выше содержимым) следует в нем разместить:
Все выполненные настройки в файле необходимо сохранить.
7. В файле loya.conf (services\marketing\loya.conf) надо указать значение параметра useOffline как true, после чего – сохранить файл:
На стороне LOYA
Для каждой льготы Для каждой льготы в кассовой системе настраивается скидка с механикой Оффлайн скидка на перечень товаров:
...
- коды льгот, полученные от социального процессинга (сервис АО «Расчетные решения»), регистрируются в кассе УКМ 5 как дисконтные карты;
- в момент расчета скидок, зарегистрированные карты приводят к расчету соответствующих скидок.
...
- каждая скидка не должна содержать более 50 SKU;
- общее количество социальных скидок не должно превышать 10.
Особенности реализации:
...
- .