Публичное пространство
SetRetail SCO v.3◾Подтверждение возраста покупателя по биометрии через MAX
Работа с MAX поддерживается только на кассах, работающих на Java 21.
Кассы, работающие на Java 8, не поддерживают работу с MAX.
Информируем о переходе на обновленный протокол API MAX. Для корректной работы сервиса необходимо обновить кассовое ПО до версий 10.4.23.21, 10.4.24.6, 10.4.25.6, 10.4.26.0 и выше.
Важно: С 1 мая 2026 года поддержка старого протокола будет прекращена, и сервис MAX перестанет функционировать на более ранних версиях.
Особенности работы с токенами, необходимыми для работы MAX, после обновления:
Если токен получен через Бизнес-портал: сервис продолжит работу в штатном режиме.
Если токен получен напрямую от MAX (через почту, Telegram и т.д.): старый токен станет недействительным. Для восстановления функционала подтверждения возраста необходимо пройти официальную процедуру получения токена.
Рекомендуемый порядок действий:
Чтобы избежать простоя сервиса подтверждения возраста, соблюдайте строгую последовательность:
Получение токена: Заблаговременно получите официальный токен через Бизнес-портал MAX (по инструкции).
Настройка: Внесите новый токен в параметры системы (если ранее использовался полученный не по инструкции).
Обновление ПО: Произведите обновление SetRetail10 до актуальной версии (не ниже указанных выше).
Инструкция для получения токена:
- 1 Описание
- 2 Ценность
- 3 Пример работы успешного сценария
- 4 Пример работы отрицательного сценария
- 5 Ограничения
- 6 Дополнительная информация
- 7 Описание поддерживаемого оборудования
- 7.1 Оборудование CSI
- 7.1.1 Стационарные сканеры
- 7.1.2 Ручные сканеры
- 7.2 Оборудование вендоров/партнёров
- 7.2.1 NCR
- 7.2.1.1 Стационарные
- 7.2.1.2 Ручные
- 7.2.2 Diebold Nixdorf
- 7.2.2.1 Стационарные
- 7.2.2.2 Ручные
- 7.2.3 HiStone
- 7.2.4 Станция оплаты на базе FEC
- 7.2.1 NCR
- 7.1 Оборудование CSI
- 8 Настройка
- 9 Статьи по теме
Описание
Ранее продажа товаров категории 18+ (а также 16+, например, книги с возрастным ограничением) - алкоголь, табачная продукция, энергетические напитки - через кассы самообслуживания без участия консультанта была невозможна, поскольку отсутствовал легальный и безопасный способ автоматической проверки возраста покупателя.
Это влекло за собой следующие последствия:
Потеря части продаж: покупатели, которые хотят приобрести товары 18+ вместе с остальными покупками, вынуждены обращаться к консультанту для подтверждения возраста, тратить дополнительное время, создавать очереди или вовсе отказываться от покупки при отсутствии документа, удостоверяющего личность.
Снижение качества клиентского опыта: процесс покупки становится менее удобным и вызывает негативные эмоции. Также снижается скорость обслуживания покупателей.
Риски нарушений: проведение возрастного контроля кассиром на зоне самообслуживания может привести к ошибкам и продаже товаров несовершеннолетним.
Начиная с версии кассового ПО 10.4.20.13 появилась возможность автоматизировать проверку возраста покупателя с помощью идентификации через сервис MAX.
Ценность
Рост продаж и снижение потерь выручки: автоматизированная проверка возраста позволит покупателям свободно приобретать товары с возрастным ограничением на кассах самообслуживания без ожидания консультанта.
Улучшение клиентского опыта: функциональность делает процесс покупки быстрее, удобнее и понятнее. Повышается удовлетворённость пользователей кассами самообслуживания, ускоряется обслуживание и уменьшаются очереди.
Повышение уровня безопасности и минимизация рисков нарушений: автоматическая система проверки возраста исключает человеческий фактор и снижает вероятность ошибок при продаже товаров с возрастным ограничением.
Оптимизация работы персонала: доработка позволит снизить нагрузку на кассиров и консультантов, так как необходимость вручную подтверждать возраст покупателя исчезает или сокращается.
Пример работы успешного сценария
Возраст покупателя подтвержден (товар 18+)
Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.
КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:
Не подтверждаю;
Подтвердить через биометрию.
Покупатель нажимает Подтвердить через биометрию.
КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.
Покупатель сканирует на КСО QR-код цифрового ID из приложения.
КСО отправляет отсканированный QR-код в сервис подтверждения возраста MAX.
Касса получает результат → возраст подтвержден:
"is_adult": true.
КСО отправляет в SetPrisma событие 126 (“Возраст покупателя подтвержден”) → в событии указан сервис подтверждения возраста:
"ageConfirmationMethod": { "method": "plugin", "pluginId": "max.age.confirmation.plugin"}.КСО переходит на экран выбора типов оплат → покупатель выбирает способ оплаты и оплачивает покупку.
Касса регистрирует чек.
В выгрузке чека в плагинные свойства сохранен результат проверки возраста:
<plugin-property key="AGE_VERIFICATION_VALIDATION_SERVICE value="max.setvice";<plugin-property key="AGE_VERIFICATION_RESULT value=":"{"is_adult": true, "timestamp": 1751558379}";<plugin-property key="AGE_VERIFICATION_SESSION_ID" value=":"GXo4szIiQL2bBQchr8fjLw".
В чеке есть товар с ограничением возраста 16+
Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 16+ → покупатель нажимает Перейти к оплате.
КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:
Не подтверждаю;
Подтвердить через биометрию.
Покупатель нажимает Подтвердить через биометрию.
КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.
Далее повторяются шаги из сценария https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/edit-v2/5583831117#%D0%92%D0%BE%D0%B7%D1%80%D0%B0%D1%81%D1%82-%D0%BF%D0%BE%D0%BA%D1%83%D0%BF%D0%B0%D1%82%D0%B5%D0%BB%D1%8F-%D0%BF%D0%BE%D0%B4%D1%82%D0%B2%D0%B5%D1%80%D0%B6%D0%B4%D0%B5%D0%BD-(%D1%82%D0%BE%D0%B2%D0%B0%D1%80-18%2B), начиная с п. 5.
Одноэтапное подтверждение возраста
С версии кассового ПО 10.4.25.0 доступно одноэтапное подтверждение возраста на КСО. Функциональность позволяет ускорить время обслуживание покупателя за счёт подтверждения возраста на одном экране.
Одноэтапное подтверждение возраста на КСО;
Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.
КСО блокируется → на экране отображается окно с инструкцией и с QR-кодом для быстрого перехода в приложение и одна кнопка Не подтверждаю.
Далее повторяются шаги из сценария https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/edit-v2/5583831117#%D0%92%D0%BE%D0%B7%D1%80%D0%B0%D1%81%D1%82-%D0%BF%D0%BE%D0%BA%D1%83%D0%BF%D0%B0%D1%82%D0%B5%D0%BB%D1%8F-%D0%BF%D0%BE%D0%B4%D1%82%D0%B2%D0%B5%D1%80%D0%B6%D0%B4%D0%B5%D0%BD-(%D1%82%D0%BE%D0%B2%D0%B0%D1%80-18%2B), начиная с п. 5.
Пример работы отрицательного сценария
Сервис подтверждения возраста по биометрии не отвечает
Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.
КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:
Не подтверждаю;
Подтвердить через биометрию.
Покупатель нажимает Подтвердить через биометрию.
КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.
Покупатель сканирует на КСО QR-код цифрового ID из приложения.
КСО отправляет отсканированный QR-код в сервис подтверждения возраста MAX.
Сервис подтверждения возраста по биометрии не отвечает в течении заданного в настройке таймаута.
КСО возвращается на окно с запросом подтверждения возраста и двумя кнопками:
Не подтверждаю;
Подтвердить через биометрию.
На экране отображается уведомление Сервис подтверждения возраста недоступен.
Сервис подтверждения возраста вернул ошибку
Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.
КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:
Не подтверждаю;
Подтвердить через биометрию.
Покупатель нажимает Подтвердить через биометрию.
КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.
Покупатель сканирует на КСО QR-код цифрового ID из приложения.
КСО отправляет отсканированный QR-код в сервис подтверждения возраста MAX.
Сервис подтверждения возраста вернул ошибку (например,
http code 401илиhttp code 400).На экране отображается уведомление Ошибка сервиса подтверждения возраста. Обновите QR-код и попробуйте еще раз или обратитесь консультанту.
Покупатель выполняет одно из двух действий:
Обновляет QR-код и повторно сканирует его → КСО повторно обращается в сервис подтверждения возраста;
Нажимает
→ КСО возвращается на окно с запросом подтверждения возраста и двумя кнопками:
Не подтверждаю;
Подтвердить через биометрию.
Ограничения
Для использования функциональности у (пользователя) покупателя должно быть:
подтвержденная учетная запись в ЕСИА (Госуслуги);
сданы биометрические данные в ЕБС (единую биометрическую систему);
установлен мессенджер MAX;
подключен Цифровой ID.
Для работы функциональности клиенту (торговой сети) требуется получить токен авторизации у MAX.
Если в чеке присутствует товар с возрастным ограничением выше 18+ (например, 21+), тогда использование биометрических сервисов подтверждения возраста будет недоступно. В этом случае подтверждение возможно только путём предъявления документа, удостоверяющего личность (стандартный процесс подтверждения возраста на КСО).
При переходе к оплате касса запрашивает проверку возраста каждый раз. Т. е., после подтверждения возраста и возвращения к корзине, при повторном переходе в режим расчёта касса снова потребует подтверждение возраста.
Требуется перепрошить и настроить сканер для корректного считывания ссылок (QR-кода с цифровым ID покупателя). Подробнее ограничение описано в главе https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5583831117/SetRetail+SCO+v.3+MAX#%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D0%BE%D0%B3%D0%BE-%D0%BE%D0%B1%D0%BE%D1%80%D1%83%D0%B4%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F.
Требуется обеспечить выполнение GET-запроса к https://ext-api.max.ru/esia/age-verification по стандартному порту 443.
Дополнительная информация
Для подтверждения возраста по биометрии роли покупателя не требуется привилегия Подтверждение возраста покупателя.
Покупатель может пройти процедуру подтверждения возраста как на экране подтверждения возраста, так и на экране добавления товаров:
На экране подтверждения возраста: если в чеке есть товар с возрастным ограничением, тогда КСО заблокируется и предложит выполнить проверку возраста с помощью биометрии → после выполнения всех шагов касса вернется в режим покупателя на экран выбора типов оплаты.
На экране добавления товаров: покупатель может не дожидаться блокировки кассы, а сразу отсканировать QR-код своего цифрового ID при добавлении товаров в чек. В этом случае, при нажатии на кнопку Перейти к оплате, КСО не будет блокироваться, а сразу перейдет на экран выбора типов оплат.
В версии 10.4.21.5 добавлена возможность кастомизации текста кнопки для перехода на экран подтверждения возраста через биометрию. Ключ локализации для текста на кнопке -
pos.age.confirmation.biometry.label.
Инструкция по кастомизации текстов и список всех доступных ключей в статьях https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5021302937 и SetRetail SCO v.3◾Ключи локализации.С версии 10.4.25.0 доступна кастомизация дефолтного баннера при одноэтапном подтверждении возраста на КСО. Требования для загрузки изображения описаны в статье SetRetail SCO v.3◾Синхронизация медиаконтента на КСО с SetSync | Требования к медиаконтенту.
Описание поддерживаемого оборудования
Как указано в главе SetRetail SCO v.3◾Подтверждение возраста покупателя по биометрии через MAX | Ограничения для корректной работы функциональности (а именно считывания QR-кода с экрана телефона покупателя) сканер должен поддерживать считывание ссылок (QR-кода).
Ниже приведена таблица по всем поддерживаемым (для работы с КСО SetSCO v.3) моделям сканеров.
Оборудование CSI
Стационарные сканеры
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
CSI K 32" (Scan Heart) | Поддерживается | Требует включения считывания QR-кодов |
CSI K 32" (Datalogic Magellan 1500) | Не поддерживается | Требует комплект модернизации стационарного сканера, запрашивайте через вашего менеджера в CSI |
CSI K 27" (Scan Heart) | Поддерживается | Требует включения считывания QR-кодов |
CSI s.kit (Scan Heart) | Поддерживается | Требует включения считывания QR-кодов |
CSI k.lite (Scan Heartlet) | Поддерживается | Требует включения считывания QR-кодов |
Ручные сканеры
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
CSI Scan Alpha/Alpha HD | Поддерживается | Требует включения считывания-QR кодов |
На ранних моделях КСО могут встречаться сканеры вендоров:
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
Datalogic QW2400 | Ожидает тестирования на стороне CSI | - |
Datalogic QD2400 | Ожидает тестирования на стороне CSI | - |
Zebra DS2208 | Ожидает тестирования на стороне CSI | - |
Honeywell Voyager 1470g | Ожидает тестирования на стороне CSI | - |
CSI Scan S36M | Ожидает тестирования на стороне CSI | - |
Sunlux XL-3610 | Ожидает тестирования на стороне CSI | - |
Оборудование вендоров/партнёров
NCR
Стационарные
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
NCR ss90 (касса) |
|
|
стационарные сканеры | Ожидает тестирования на стороне CSI | - |
NCR r5, r6 (касса) |
|
|
NCR 7878 | Не поддерживается | - |
NCR 7879 | Ожидает тестирования на стороне CSI | - |
Ручные
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
Zebra DS2208 | Ожидает тестирования на стороне CSI | - |
Diebold Nixdorf
Стационарные
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
iScanEasy (касса) |
|
|
Datalogic Magellan 8xxx | Не поддерживается | - |
Datalogic Magellan 9xxx | Ожидает тестирования на стороне CSI | - |
ExPress (касса) |
|
|
Datalogic Magellan 34xx | Ожидает тестирования на стороне CSI | - |
Ручные
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
Datalogic QW2400 | Ожидает тестирования на стороне CSI | - |
Datalogic QD2400 | Ожидает тестирования на стороне CSI | - |
HiStone
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
HS210 (касса) |
|
|
Newland FM60 | Ожидает тестирования на стороне CSI | - |
Станция оплаты на базе FEC
Модель | Сканирование QR с биометрией MAX | Комментарий |
|---|---|---|
CSI Scan S23 | Ожидает тестирования на стороне CSI | - |
Настройка
Войдите на сервер SetCentrum/SetRetail10 → перейдите в раздел Интеграция → вкладка Внешние процессинги → кликните на + для добавления нового процессинга.
Выберите тип плагинов Плагины подтверждения возраста → выберите
Подтверждение возраста через MAX → кликните СОХРАНИТЬ.
После сохранения откроется экран с добавленными процессингами → в поисковой строке введите название процессинга подтверждения возраста → кликните по нему для перехода к настройке.