Для подтверждения возраста покупателя через мессенджер 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.*)"

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

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

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

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

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

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

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

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

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

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