SetRetail SCO v.3◾Подтверждение возраста покупателя по биометрии через MAX

Публичное пространство

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 до актуальной версии (не ниже указанных выше).

Инструкция для получения токена:

Описание

Ранее продажа товаров категории 18+ (а также 16+, например, книги с возрастным ограничением) - алкоголь, табачная продукция, энергетические напитки - через кассы самообслуживания без участия консультанта была невозможна, поскольку отсутствовал легальный и безопасный способ автоматической проверки возраста покупателя.

Это влекло за собой следующие последствия:

  • Потеря части продаж: покупатели, которые хотят приобрести товары 18+ вместе с остальными покупками, вынуждены обращаться к консультанту для подтверждения возраста, тратить дополнительное время, создавать очереди или вовсе отказываться от покупки при отсутствии документа, удостоверяющего личность.

  • Снижение качества клиентского опыта: процесс покупки становится менее удобным и вызывает негативные эмоции. Также снижается скорость обслуживания покупателей.

  • Риски нарушений: проведение возрастного контроля кассиром на зоне самообслуживания может привести к ошибкам и продаже товаров несовершеннолетним.

Начиная с версии кассового ПО 10.4.20.13 появилась возможность автоматизировать проверку возраста покупателя с помощью идентификации через сервис MAX.

Ценность

  1. Рост продаж и снижение потерь выручки: автоматизированная проверка возраста позволит покупателям свободно приобретать товары с возрастным ограничением на кассах самообслуживания без ожидания консультанта.

  2. Улучшение клиентского опыта: функциональность делает процесс покупки быстрее, удобнее и понятнее. Повышается удовлетворённость пользователей кассами самообслуживания, ускоряется обслуживание и уменьшаются очереди.

  3. Повышение уровня безопасности и минимизация рисков нарушений: автоматическая система проверки возраста исключает человеческий фактор и снижает вероятность ошибок при продаже товаров с возрастным ограничением.

  4. Оптимизация работы персонала: доработка позволит снизить нагрузку на кассиров и консультантов, так как необходимость вручную подтверждать возраст покупателя исчезает или сокращается.

Пример работы успешного сценария

Возраст покупателя подтвержден (товар 18+)

  1. Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.

image-20251117-105917.png
image-20251117-111112.png

 

  1. КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:

    1. Не подтверждаю;

    2. Подтвердить через биометрию.

  2. Покупатель нажимает Подтвердить через биометрию.

image-20251117-111612.png
image-20251117-130510.png

 

  1. КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.

image-20251117-130614.png
image-20251117-130638.png

 

  1. Покупатель сканирует на КСО QR-код цифрового ID из приложения.

  2. КСО отправляет отсканированный QR-код в сервис подтверждения возраста MAX.

  3. Касса получает результат → возраст подтвержден: "is_adult": true.

image-20251117-130712.png
image-20251117-130732.png

 

  1. КСО отправляет в SetPrisma событие 126 (“Возраст покупателя подтвержден”) → в событии указан сервис подтверждения возраста: "ageConfirmationMethod": { "method": "plugin", "pluginId": "max.age.confirmation.plugin"}.

  2. КСО переходит на экран выбора типов оплат → покупатель выбирает способ оплаты и оплачивает покупку.

  3. Касса регистрирует чек.

  4. В выгрузке чека в плагинные свойства сохранен результат проверки возраста:

    1. <plugin-property key="AGE_VERIFICATION_VALIDATION_SERVICE value="max.setvice";

    2. <plugin-property key="AGE_VERIFICATION_RESULT value=":"{"is_adult": true, "timestamp": 1751558379}";

    3. <plugin-property key="AGE_VERIFICATION_SESSION_ID" value=":"GXo4szIiQL2bBQchr8fjLw".

В чеке есть товар с ограничением возраста 16+

  1. Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 16+ → покупатель нажимает Перейти к оплате.

image-20251117-133523.png
image-20251117-133628.png

 

  1. КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:

    1. Не подтверждаю;

    2. Подтвердить через биометрию.

image-20251117-133743.png
image-20251117-133830.png

 

  1. Покупатель нажимает Подтвердить через биометрию.

  2. КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.

  3. Далее повторяются шаги из сценария 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 доступно одноэтапное подтверждение возраста на КСО. Функциональность позволяет ускорить время обслуживание покупателя за счёт подтверждения возраста на одном экране.

  • включено на сервере.png Одноэтапное подтверждение возраста на КСО;

  1. Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.

  2. КСО блокируется → на экране отображается окно с инструкцией и с QR-кодом для быстрого перехода в приложение и одна кнопка Не подтверждаю.

image-20260316-151402.png
image-20260316-151437.png

 

  1. Далее повторяются шаги из сценария 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.

Пример работы отрицательного сценария

Сервис подтверждения возраста по биометрии не отвечает

  1. Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.

  2. КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:

    1. Не подтверждаю;

    2. Подтвердить через биометрию.

  3. Покупатель нажимает Подтвердить через биометрию.

  4. КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.

  5. Покупатель сканирует на КСО QR-код цифрового ID из приложения.

  6. КСО отправляет отсканированный QR-код в сервис подтверждения возраста MAX.

  7. Сервис подтверждения возраста по биометрии не отвечает в течении заданного в настройке таймаута.

  8. КСО возвращается на окно с запросом подтверждения возраста и двумя кнопками:

    1. Не подтверждаю;

    2. Подтвердить через биометрию.

  9. На экране отображается уведомление Сервис подтверждения возраста недоступен.

image-20251117-135629.png

Сервис подтверждения возраста вернул ошибку

  1. Покупатель сканирует в чек произвольные товары, а том числе товар с возрастным ограничением 18+ → покупатель нажимает Перейти к оплате.

  2. КСО блокируется и открывает окно с запросом подтверждения возраста и двумя кнопками:

    1. Не подтверждаю;

    2. Подтвердить через биометрию.

  3. Покупатель нажимает Подтвердить через биометрию.

  4. КСО переходит к окну подтверждения возраста → отображается стандартное окно с инструкцией и с QR-кодом для быстрого перехода в приложение.

  5. Покупатель сканирует на КСО QR-код цифрового ID из приложения.

  6. КСО отправляет отсканированный QR-код в сервис подтверждения возраста MAX.

  7. Сервис подтверждения возраста вернул ошибку (например, http code 401 или http code 400).

  8. На экране отображается уведомление Ошибка сервиса подтверждения возраста. Обновите QR-код и попробуйте еще раз или обратитесь консультанту.

image-20251117-135507.png
  1. Покупатель выполняет одно из двух действий:

    1. Обновляет QR-код и повторно сканирует его → КСО повторно обращается в сервис подтверждения возраста;

    2. Нажимает крестик.png→ КСО возвращается на окно с запросом подтверждения возраста и двумя кнопками:

      1. Не подтверждаю;

      2. Подтвердить через биометрию.

Ограничения

  • Для использования функциональности у (пользователя) покупателя должно быть:

    • подтвержденная учетная запись в ЕСИА (Госуслуги);

    • сданы биометрические данные в ЕБС (единую биометрическую систему);

    • установлен мессенджер 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.

Дополнительная информация

  1. Для подтверждения возраста по биометрии роли покупателя не требуется привилегия Подтверждение возраста покупателя.

  2. Покупатель может пройти процедуру подтверждения возраста как на экране подтверждения возраста, так и на экране добавления товаров:

    1. На экране подтверждения возраста: если в чеке есть товар с возрастным ограничением, тогда КСО заблокируется и предложит выполнить проверку возраста с помощью биометрии → после выполнения всех шагов касса вернется в режим покупателя на экран выбора типов оплаты.

    2. На экране добавления товаров: покупатель может не дожидаться блокировки кассы, а сразу отсканировать QR-код своего цифрового ID при добавлении товаров в чек. В этом случае, при нажатии на кнопку Перейти к оплате, КСО не будет блокироваться, а сразу перейдет на экран выбора типов оплат.

  3. В версии 10.4.21.5 добавлена возможность кастомизации текста кнопки для перехода на экран подтверждения возраста через биометрию. Ключ локализации для текста на кнопке - pos.age.confirmation.biometry.label.
    Инструкция по кастомизации текстов и список всех доступных ключей в статьях https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5021302937 и SetRetail SCO v.3◾Ключи локализации.

  4. С версии 10.4.25.0 доступна кастомизация дефолтного баннера при одноэтапном подтверждении возраста на КСО. Требования для загрузки изображения описаны в статье SetRetail SCO v.3◾Синхронизация медиаконтента на КСО с SetSync | Требования к медиаконтенту.

image-20260316-153613.png
image-20260316-153653.png

 

Описание поддерживаемого оборудования

Как указано в главе SetRetail SCO v.3◾Подтверждение возраста покупателя по биометрии через MAX | Ограничения для корректной работы функциональности (а именно считывания QR-кода с экрана телефона покупателя) сканер должен поддерживать считывание ссылок (QR-кода).

Ниже приведена таблица по всем поддерживаемым (для работы с КСО SetSCO v.3) моделям сканеров.

Оборудование CSI

Стационарные сканеры

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование 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

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

CSI Scan Alpha/Alpha HD

Поддерживается

Требует включения считывания-QR кодов

На ранних моделях КСО могут встречаться сканеры вендоров:

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование 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

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

NCR ss90 (касса)

 

 

стационарные сканеры

Ожидает тестирования на стороне CSI

-

NCR r5, r6 (касса)

 

 

NCR 7878

Не поддерживается

-

NCR 7879

Ожидает тестирования на стороне CSI

-

Ручные

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

Zebra DS2208

Ожидает тестирования на стороне CSI

-

Diebold Nixdorf

Стационарные

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

iScanEasy (касса)

 

 

Datalogic Magellan 8xxx

Не поддерживается

-

Datalogic Magellan 9xxx

Ожидает тестирования на стороне CSI

-

ExPress (касса)

 

 

Datalogic Magellan 34xx

Ожидает тестирования на стороне CSI

-

Ручные

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

Datalogic QW2400

Ожидает тестирования на стороне CSI

-

Datalogic QD2400

Ожидает тестирования на стороне CSI

-

HiStone

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

HS210 (касса)

 

 

Newland FM60

Ожидает тестирования на стороне CSI

-

Станция оплаты на базе FEC

Модель

Сканирование QR с биометрией MAX

Комментарий

Модель

Сканирование QR с биометрией MAX

Комментарий

CSI Scan S23

Ожидает тестирования на стороне CSI

-

Настройка

  1. Войдите на сервер SetCentrum/SetRetail10 → перейдите в раздел Интеграция → вкладка Внешние процессинги → кликните на + для добавления нового процессинга.

image-20251114-142040.png
  1. Выберите тип плагинов Плагины подтверждения возраста → выберите включено на сервере.png Подтверждение возраста через MAX → кликните СОХРАНИТЬ.

image-20251114-142348.png
  1. После сохранения откроется экран с добавленными процессингами → в поисковой строке введите название процессинга подтверждения возраста → кликните по нему для перехода к настройке.