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».