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