Для подтверждения возраста покупателя через мессенджер MAX файл лицензии должен содержать модуль max. Подробнее об этом можно прочитать в разделе "Формат лицензии Artix .li4".

1 мая 2026 года пилотная версия API для интеграции с мессенджером MAX будет отключена. Устаревший плагин верификации будет выведен из эксплуатации и принудительно удален из состава программного обеспечения Artix.

Для перехода на расширенную версию API необходимо:

  1. Обновить версию кассового ПО.
  2. Отключить старый плагин.
  3. Настроить новый плагин "Сервисы мессенджера MAX".

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

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

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

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

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

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

serverUrl

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

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

timeout

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

apiKey

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

mask

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

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

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

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

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

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

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

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

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

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

  • No labels