Age Verification with Yoti для OpenCart — подтверждение возраста покупателя перед оформлением

Age Verification with Yoti для OpenCart 4.x, 3.x и 2.3 просит покупателя подтвердить возраст через сервис Yoti до того, как откроется оформление заказа. Модуль создан для магазинов Великобритании, которые продают товары с возрастным ограничением: алкоголь, вейпы, ножи, товары для взрослых.

Как подтверждается возраст. Возраст определяет Yoti на своём экране: оценка возраста по лицу (селфи), Digital ID в приложении Yoti или документ с селфи. Магазин получает только ответ «достаточно лет или нет» вместе с методом и номером сессии Yoti. Фото, документ и дата рождения в магазин не попадают.

Что видит покупатель

Покупатель нажимает «Checkout» и попадает на страницу «Confirm your age»: почему магазин спрашивает возраст, три коротких пояснения и кнопка «Verify my age». Кнопка открывает экран Yoti, где покупатель сам выбирает способ. После ответа он возвращается в оформление с той же корзиной, а второй заказ в той же сессии проходит без нового запроса. Если Yoti не подтвердил возраст, покупатель закрыл экран или время сессии вышло, страница объясняет это обычными словами и предлагает «Try again»; корзина остаётся на месте. Количество попыток в сутки ограничено (по умолчанию 5).

Что получает админ

Расширения → Модули → Age Verification with Yoti: вкладки «Connection», «Checkout», «Ages», «Methods», «Automation», «Licence». Для подключения нужны SDK ID и API key сервиса Age verification из Yoti Hub. «Save and check the keys» сразу показывает, принимает ли Yoti эти ключи, и объясняет, что именно не так: неизвестный SDK ID или неправильный ключ. API key хранится зашифрованным и в форму не возвращается.

Оформить заказ без подтверждения не получится и в обход страницы: стандартный шаг подтверждения заказа OpenCart закрыт на сервере, вместо кнопки «Confirm Order» покупатель видит сообщение со ссылкой «Verify my age», и заказ не создаётся. Сторонние одностраничные чекауты с собственным шагом подтверждения модуль не блокирует: такой заказ создаётся с отметкой «Age NOT verified», которая видна на странице заказа и в его истории.

На странице заказа появляется блок «Age verification»: итог одной строкой (зелёный, если возраст подтверждён, красный, если нет), возраст, которого требовал магазин, метод, время ответа, номер сессии Yoti и Yoti evidence ID. Тот же итог записывается строкой в историю заказа. На вкладке «Checkout» вы решаете, что делать, когда Yoti недоступен: не пускать покупателя к оформлению или пропустить и отметить заказ как «Age NOT verified». Там же запас лет для оценки по селфи: оценка должна показать на столько лет больше, чем требует магазин; Digital ID и документов это не касается.

В Pro возраст становится гибким. Возраст магазина — 18, 21 или 25; отдельные правила для категорий (вместе с подкатегориями) и товаров, правило товара сильнее правила категории. В режиме «только перечисленные» корзина без товаров из списка проходит без запроса. На вкладке «Methods» вы выбираете, какие способы видит покупатель: оценка по лицу, Digital ID, документ, кредитная карта, мобильный оператор (последние два работают только для возраста 18) и страну документа по умолчанию.

Автоматизация в Pro: Yoti уведомляет магазин о каждом результате, поэтому ответ доходит, даже если покупатель закрыл страницу Yoti и не вернулся; для уведомлений магазин должен работать на HTTPS. Подтверждённый покупатель с аккаунтом запоминается на указанное число дней или навсегда, и второй раз его не спрашивают. Возраст можно спрашивать ещё до создания аккаунта. Журнал «Age checks» в разделе «Продажи» показывает каждую попытку: дату, назначение, возраст, метод, результат, сессию Yoti, покупателя и заказ, с фильтрами и экспортом в CSV.

Как это работает, шаг за шагом

1. Устанавливаете архив для своей версии OpenCart и включаете модуль.
2. В Yoti Hub создаёте сервис Age checks → Age verification и копируете его SDK ID и API key.
3. На вкладке «Connection» вставляете ключи, нажимаете «Save and check the keys» и включаете «Ask buyers to verify their age».
4. На вкладке «Checkout» задаёте количество попыток в сутки и поведение, когда Yoti недоступен.
5. Покупатель подтверждает возраст перед оформлением, результат появляется на странице заказа.
6. В Pro добавляете возраст по категориям и товарам, выбираете методы, включаете уведомления Yoti, память о покупателе и журнал.

Что под капотом

• Возраст определяет Yoti; магазин хранит только результат: метод, время, номер сессии и evidence ID.
• Фото, документ и дата рождения в магазин не передаются и не хранятся.
• Шаг подтверждения заказа закрыт на сервере, а не только кнопкой на странице.
• Результат, пришедший уведомлением, модуль перечитывает в Yoti своим ключом, а не берёт из тела запроса.
• Сессия Yoti, которую открыл один браузер, не подходит другому.
• API key зашифрован; в журнале модуля ключа нет.
• События OpenCart без правок ядра; после удаления и повторной установки настройки и журнал на месте.
• Интерфейс модуля и тексты для покупателя — на английском.

Как установить

1. Расширения → Установка: загрузите архив для своей версии без переименования файла (OpenCart 4 — cc_yoti.ocmod.zip, 3.x — cc_yoti-oc3.ocmod.zip, 2.3 — cc_yoti-oc23.ocmod.zip).
2. Для 3.x и 2.3: Расширения → Модификаторы → Обновить.
3. Расширения → Модули → Age Verification with Yoti: установите и откройте.
4. Вставьте SDK ID и API key, нажмите «Save and check the keys» и включите модуль.
5. Для Pro: вставьте ключ или запустите пробный период на вкладке «Licence».