API верифікації віку для сайтів і застосунків
Перевірте, чи відвідувач досяг встановленого вами вікового порогу, без зберігання вашим застосунком документів, що посвідчують особу, чи дат народження.
Перевірте, чи відвідувач досяг потрібного віку
Одна сесія виконує обидві половини: відвідувач доводить контроль над своїм номером телефону через WhatsApp, один раз відповідає на запитання про вік, а ваш застосунок отримує результат — досягнуто порогу чи ні — відносно встановленого вами вікового порогу.
Як працює верифікація віку
Крок перший: верифікуйте телефон. Ви викликаєте POST /start-verification з flow=age і показуєте повернутий deep link у WhatsApp як QR-код на десктопі або кнопку на мобільному. Відвідувач надсилає одне попередньо заповнене повідомлення зі свого акаунта WhatsApp, тож контроль над номером доводиться самим актом надсилання, а не кодом, який ви на нього відправили.
Крок другий: встановіть поріг. Той самий виклик приймає необов’язковий min_age. Якщо його не вказати, застосовується поріг, налаштований у вашому акаунті, — 18, якщо ви його не змінювали. min_age приймається лише з flow=age і має бути додатним цілим числом; будь-що інше повертається як 400.
Крок третій: завершіть перевірку віку. Щойно телефонну частину підтверджено, відповідь містить блок age зі статусом pending і age_verification_url. Відвідувачеві надсилається те саме одноразове посилання через WhatsApp, а ви можете використати його, щоб провести відвідувача далі в тому самому браузері, де він уже перебуває. Він відповідає в провайдера віку, а потім повертається на ваш callback_url із доданими token і age=verified, denied або failed.
Крок четвертий: отримайте результат. Другий webhook, age_verification_result, спрацьовує, щойно провайдер відповідає, а GET /check-verification-status повідомляє те саме. Блок age містить status, verified, required (поріг, який було фактично перевірено), verified_at і provider.
Про одну пастку варто знати, перш ніж писати цикл опитування. Власний статус сесії переходить у verified, щойно номер телефону підтверджено, тоді як age.status ще pending. Сприймайте блок age як сигнал для кроку віку, а не статус сесії.
Верифікація телефону + верифікація віку
Ці два кроки відповідають на два різні запитання, і потік навмисно тримає їх окремо. Надсилання повідомлення у WhatsApp доводить, що відвідувач контролює цей номер. Воно нічого не говорить про те, скільки йому років: номер телефону — не доказ віку, і жодна частина цього потоку не вважає його таким.
Що дає вам крок із телефоном — місце, куди покласти відповідь. Результат перевірки віку сам по собі — це «підвішений» факт: хтось, десь, пройшов поріг. Прив’язаний до номера, який відвідувач щойно наочно використав, він стає тим, що ви можете впізнати під час наступного візиту.
Це також здешевлює повернення відвідувача. Позитивний результат зберігається за номером телефону протягом року, тож той, хто вже пройшов той самий поріг, повторно підтверджує номер і переносить попередню відповідь замість того, щоб знову йти до провайдера. Якщо завершити повідомлення у WhatsApp на #reset, кеш пропускається — це потрібно, коли вам потрібна свіжа відповідь.
Верифікуйте вік, не будуючи бази ідентичностей
Запитання, яке ставить віковий бар’єр, — булеве. Більшість даних, які зазвичай збирають для відповіді на нього, — ні, і саме тому архів документів — така погана угода: ви зрештою зберігаєте паспорти та водійські посвідчення, щоб зберегти «так».
Вашому застосунку потрібно небагато. Результат — verified, denied, failed або ще pending. Поріг, який було перевірено. Коли відповідь було отримано і який провайдер відповів. Ідентифікатор сесії та верифікований номер телефону, що пов’язують відповідь із відвідувачем перед вами. Це весь блок age плюс те, що вже повертає потік верифікації телефону.
Вашому застосунку не потрібні ні дата народження, ні документ, що посвідчує особу, і API не повертає жодного з них, тож немає поля, яке можна випадково записати в лог. Позитивна відповідь зберігається за номером телефону як відповідь, поріг і дата. Облікові дані провайдера живуть у серверних секретах, а те, що провайдер мав переглянути, щоб ухвалити рішення, вам не передається.
Жодне з цього не є твердженням про ваші власні зобов’язання. Що саме ви маєте перевіряти, як довго маєте мати змогу довести, що перевіряли, і який метод вважається прийнятним — це питання до вашого юриста й вашого регулятора, а не до постачальника API.
Верифікація віку та верифікація особи
Верифікація віку відповідає на одне запитання: чи досяг цей відвідувач встановленого вами вікового порогу? Верифікація особи відповідає на інше: хто ця людина? Їх часто продають разом, але вони переміщують дуже різні обсяги даних.
flow=age належить до першого виду. Він не повертає ні імені, ні дати народження, ні нічого з документа. Це не KYC, а позитивний результат — не твердження про особу, на яке можна спиратися деінде. Якщо ваше зобов’язання — знати, хто є клієнтом, цей інструмент не підходить для цієї частини.
Він також успадковує припущення, що лежить в основі будь-якої перевірки через телефон: що номер належить людині, яка ним користується. Доведення контролю надсиланням повідомлення — міцніший ґрунт, ніж отримання SMS, але підліток із доступом до телефону дорослого — сценарій, який жодна дистанційна перевірка не закриває повністю. Стаття про перевірки віку, що не перетворюються на базу посвідчень особи (посилання нижче), докладніше розглядає архітектуру, чотири стани та обмеження.
Інтегруйте верифікацію віку у свій застосунок
Це ті самі два REST-виклики, які використовує кожна інтеграція Phone-Verif, зі зміною одного параметра. Автентифікуйтеся за допомогою свого API-ключа в заголовку x-api-key, відкрийте сесію з flow=age і зчитайте блок age з ендпоінта статусу або з webhook.
- Відвідувач
- Верифікація телефону через WhatsApp
- Перевірка віку в провайдера
- Результат перевірки віку
- Ваш застосунок
Ці два кроки відповідають на два різні запитання й залишаються окремими протягом усього процесу. Надсилання повідомлення у WhatsApp доводить, що відвідувач контролює цей номер; воно ніколи не розглядається як доказ його віку. Саме крок перевірки віку створює результат щодо віку.
curl -X POST "https://api.phone-verif.com/start-verification?flow=age&min_age=18" \
-H "x-api-key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_id": "checkout-4821", "callback_url": "https://your-app.example/age-checked"}'Відкрийте сесію з flow=age. Якщо не вказати min_age, застосовується поріг, налаштований у вашому акаунті, — 18, якщо ви його не змінювали.
{
"status": "verified",
"age": { "status": "pending", "verified": false, "required": 18 },
"age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}Сесія переходить у стан verified, щойно номер телефону підтверджено, поки крок перевірки віку ще не завершено. Для відповіді щодо віку зчитуйте age.status, а не статус сесії — і спрямуйте відвідувача на age_verification_url, щоб він завершив перевірку в тому самому браузері, де вже перебуває.
{
"event": "age_verification_result",
"session_id": "checkout-4821",
"validation_token": "...",
"age": {
"status": "verified",
"verified": true,
"required": 18,
"verified_at": "2026-09-01T22:00:00.000Z",
"provider": "ageverif"
}
}Щойно провайдер відповідає, другий webhook доставляє результат, а ендпоінт статусу повідомляє той самий блок.
Для flow=age у вашому акаунті має бути налаштований провайдер перевірки віку. Якщо запитати без нього, API відповість 503 з кодом age_not_configured, щоб помилку налаштування можна було відрізнити від збою.
Поширені запитання про верифікацію віку
- Чи можу я перевірити, що користувачам понад 18 років?
- Так. Відкрийте сесію з flow=age і не вказуйте min_age: тоді потік перевірятиме відносно порогу, налаштованого у вашому акаунті, — 18, якщо ви не змінили його в налаштуваннях.
- Чи можна використати інший мінімальний вік?
- Так. Передайте min_age у стартовому виклику з потрібним порогом. Він має бути додатним цілим числом, приймається лише з flow=age, а будь-що інше відхиляється з кодом 400. Кожна сесія зберігає поріг, з яким її було відкрито, і цей поріг повертається як required у блоці age, тож той, хто читатиме пізніше, знатиме, що саме було встановлено.
- Чи потрібно мені зберігати дату народження користувача?
- Ні, і навіть якби ви хотіли, не змогли б: API її не повертає. Повертається лише те, чи досягнуто порогу, який це був поріг, коли було отримано відповідь і який провайдер відповів.
- Чи потрібно мені зберігати документи, що посвідчують особу?
- Ні. Провайдеру може знадобитися переглянути документ, щоб сформувати відповідь; ваш застосунок завжди отримує лише відповідь. API не повертає нічого з документа, тож вам нічого зберігати.
- Чи доводить верифікація віку чиюсь особу?
- Ні. flow=age відповідає на те, чи досягла людина, що володіє підтвердженим номером телефону, певного порогу. Це не верифікація особи й не KYC: ні імені, ні дати народження, ні документа.
- Що відбувається, якщо верифікація віку не пройдена?
- denied і failed — різні результати, їх не слід зводити до одного. denied — це рішення провайдера, і повторний запуск не змінить відповіді. failed означає, що з провайдером не вдалося зв’язатися, тож нічого не вирішено й повторна спроба доречна. Відмова чи збій провайдера не тарифікуються; завершена перевірка віку тарифікується як друга одиниця додатково до верифікації телефону.
- Чи можна поєднати верифікацію телефону та верифікацію віку?
- Саме це і є flow=age. Одна сесія підтверджує номер телефону через WhatsApp, а потім виконує крок перевірки віку, і обидва результати надходять у цій самій сесії. Вам не потрібно вести дві інтеграції чи зіставляти два ідентифікатори.
- Чи можна примусово запустити нову перевірку для відвідувача, що повертається?
- Так. Позитивний результат повторно використовується протягом року для того самого номера телефону й того самого порогу. Якщо завершити повідомлення верифікації у WhatsApp на #reset, кешована відповідь пропускається, а відвідувач проходить повну перевірку заново.
Related
Сценарії використання верифікації віку
Контент для дорослих
Там, де самостійно поставлена галочка вже не вважається перевіркою. Результат перевірки віку відкриває доступ до того, як буде показано будь-що, а відвідувача не просять завантажувати вам документ.
Онлайн-гемблінг
Акаунти у букмекерських конторах і казино, які мають не допускати неповнолітніх гравців. Перевірку можна поставити під час реєстрації та ще раз перед чутливою дією, якщо цього вимагають ваші правила.
Алкоголь і товари з віковими обмеженнями
Напої, тютюн, вейпи, ножі, розчинники та феєрверки. Перевірка стоїть перед оформленням замовлення: вона прив’язана до замовлення, а не до сесії перегляду.
Ігри
Ігри з віковим рейтингом, чати та платні механіки, обмежені для молодшого віку. Поріг — це параметр запиту, тож різні функції можуть вимагати різні пороги.
Маркетплейси
Оголошення, обмежені законом або вашою власною політикою. Для покупців і продавців можна встановити різні пороги, відкриваючи сесію з різним min_age.
Соціальні та спільнотні платформи
Правила мінімального віку для акаунтів, особистих повідомлень чи функцій прямих ефірів. Відповідь прив’язана до підтвердженого номера телефону, тож вона зберігається й після завершення сесії.
Build your верифікація віку flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.