Для работы с сервисами мессенджера 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.*)"

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

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

Для подтверждения возраста через MAX необходимо нажать кнопку "Перейти", на экране будет отображено сообщение:

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

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

Если настроен вывод пользовательской информации на второй монитор, то после нажатия кнопки "Перейти" на втором экране будет отображен информационный баннер MAX:

  • No labels