Для работы с сервисами мессенджера MAX необходима лицензия версии 5.0 с модулем maxservices. Подробнее об этом можно прочитать в разделе "Формат лицензии Artix .li4".

Если в текущем файле лицензии кассового ПО в поле version указана версия продукта 4.6, то необходимо обновить лицензию до версии 5.

  • Начиная с версии кассового ПО Artix 4.6.301-X реализована поддержка расширенной версии API для мессенджера MAX.
  • На период перехода интеграции с мессенджером MAX на расширенную версию API для лицензии версии 5 поддержана обратная совместимость с кассовым ПО версии 4.6.

Подробнее о переходе на расширенную версию API для мессенджера MAX можно прочитать в разделе "Интеграция с MAX. Переход на расширенную версию API".

Для корректной работы сервисов мессенджера MAX старый плагин max должен быть выключен.

Конфигурирование модуля

Активация сервисов мессенджера MAX определяется параметром maxservices, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/maxservices.ini в секции [plugins].

НаименованиеТип данныхВозможные значенияОписаниеПримечания
maxservicesстроковый
  • on
  • off
Сервисы мессенджера MAXПо умолчанию off
Пример настройки
[plugins] 
; Плагин для работы с сервисами мессенджера Max 
;maxservices = off

Настройка сервиса верификации возраста покупателя производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/maxservices.ini в секции [Max.Service.AgeVerification].

НаименованиеТип данныхВозможные значенияОписаниеПримечания

serverUrl

строковый"https://ext-api.max.ru/esia"Адрес сервера верификации возраста покупателя

По умолчанию "http://localhost" 

timeout

целочисленный
Таймаут запроса к серверу в секундахПо умолчанию 30 секунд

apiKey

строковый
Ключ доступа к API-интерфейсу фронт-офиса сервера верификации MaxКлюч доступа к API-интерфейсу предоставляет сервис MAX

mask

строковый
Маска для распознавания стенографического QR-кода из приложения клиентаПо умолчанию "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)" 
Пример настройки
[Max.Service.AgeVerification]
; Сервис верификации возраста покупателя

; Адрес сервера
; По умолчанию "http://localhost" 
;serviceUrl = "http://localhost" 

; Таймаут запроса к серверу в секундах
; По умолчанию 30
;timeout = 30

; Ключ доступа к API-интерфейсу фронт-офиса сервера
; По умолчанию "" 
;apiKey = "" 

; Маска для распознавания стенографического QR-кода из приложения клиента
; По умолчанию "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)" 
;mask = "(?<maxServicesQrMask>https://www.gosuslugi.ru/m.*)"

Подтверждение возраста при формировании чека

Для подтверждения возраста необходимо поднести QR-код цифрового ID из мессенджера MAX к сканеру.

При сканировании QR-кода цифрового ID будет отправлен запрос на верификацию возраста. Если статус совершеннолетия:

  • подтвержден, то на экран будет выведено сообщение "Возраст подтвержден. Можете продолжать делать покупки". Вызов консультанта не будет выполнен. После закрытия сообщения будет произведено возвращение в режим формирования.
  • не подтвержден, то на экран будет выведено сообщение об ошибке "Проверка возраста не пройдена. Сервис верификации не смог подтвердить статус совершеннолетия покупателя". После закрытия ошибки необходимо подтверждение возраста при переходе в подытог.

Подтверждение возраста при переходе в подытог

В режиме подытога будет отображено сообщение о вызове консультанта с интеграцией MAX:

Если QR-код цифрового ID был отсканирован в режиме формирования чека и статус совершеннолетия был подтвержден, то при переходе в подытог не требуется повторное подтверждение возраста.

23-Проверка возраста MAX. При переходе к оплате.png

При сканировании QR-кода цифрового ID будет отправлен запрос на верификацию возраста. Если статус совершеннолетия:

  • подтвержден, то на экран будет выведено сообщение "Возраст подтвержден. Можете продолжать делать покупки". Вызов консультанта не будет выполнен. После закрытия сообщения будет произведен переход в режим оплаты.
  • не подтвержден, то на экран будет выведено сообщение об ошибке "Проверка возраста не пройдена. Повторите попытку или дождитесь консультанта". После закрытия ошибки будет отображено сообщение о вызове консультанта с интеграцией MAX.
  • No labels