Skip to content

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.

  1. Посетитель
  2. Верификация телефона через WhatsApp
  3. Проверка возраста у провайдера
  4. Результат проверки возраста
  5. Ваше приложение

Эти два шага отвечают на два разных вопроса и остаются раздельными на всём протяжении. Отправка сообщения в 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.