Перейти к основному содержанию
Метод Redirect отправляет пользователей на страницу верификации, размещённую Didit, а затем возвращает их в ваше приложение через URL обратного вызова.

Когда использовать Redirect

  • Верификация на нескольких устройствах: начните на компьютере, завершите на телефоне
  • Максимальная совместимость: работает во всех браузерах, включая старые версии
  • Простая интеграция: не требуется настройка iframe
  • Проблемы с камерой: когда доступ к камере в iframe работает некорректно

Реализация

Шаг 1: создание сессии (бэкенд)

В ответе на создание сессии есть поле с именем url. Передайте это значение в браузер.

Шаг 2: перенаправление пользователя (фронтенд)

HTML:
React:
Vue:

Обработка обратного вызова

Когда верификация завершена, Didit перенаправляет пользователя на ваш URL обратного вызова с параметрами запроса:

Пример для Next.js

Пример для Express.js

Пример для Vue Router


Открытие в новой вкладке

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

Рекомендации по безопасности

Проверяйте обратный вызов на стороне сервера

Относитесь к параметрам запроса verificationSessionId и status как к ненадёжным подсказкам для интерфейса. Всегда подтверждайте итоговое решение на бэкенде: либо обрабатывая webhook (предпочтительно), либо повторно запрашивая решение через API:

Используйте webhook

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

Сценарий с несколькими устройствами

Метод redirect естественным образом поддерживает верификацию на нескольких устройствах:
  1. Пользователь нажимает «Верифицировать» на компьютере
  2. Пользователь перенаправляется на страницу верификации
  3. При необходимости пользователь может отсканировать QR-код, чтобы продолжить на телефоне
  4. После завершения пользователь перенаправляется на ваш URL обратного вызова. Какое устройство выполняет перенаправление, определяется параметром callback_method (initiator, completer или both)

Устранение неполадок

Обратный вызов не получен

  1. Убедитесь, что URL обратного вызова правильно указан при создании сессии
  2. Убедитесь, что ваш URL обратного вызова доступен из интернета
  3. Проверьте, что в URL нет опечаток и проблем с кодировкой

Статус всегда «Declined»

  1. Проверьте настройки сценария в Didit Console
  2. Убедитесь, что используемые тестовые документы действительны
  3. Изучите детали сессии через API, чтобы узнать конкретные причины отказа

Бесконечный цикл перенаправлений

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

Репозиторий с примерами

Репозиторий GitHub

Исходный код и примеры смотрите на GitHub
Последнее изменение 7 ноября 2026 г.