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

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

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

Обновить версию кассового ПО.
Отключить старый плагин.
Настроить новый плагин "Сервисы мессенджера 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.*)"

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

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

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

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

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

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

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

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

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

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