Перейти к основному содержанию
Smart-ID и Mobile-ID позволяют пользователям подтверждать свою личность, одобряя запрос на телефоне. Используйте Smart-ID API или Mobile-ID API, чтобы запускать верификацию из собственного приложения без сценария. Оба метода также работают внутри шага сценария Didit Верификация личности, возвращая результат проверки кошелька с уровнем достоверности cryptographic. Для интеграции с размещённым сценарием, описанной ниже, используйте то же создание сессий и интеграцию с webhook, что и для других ваших сценариев Didit.
Smart-ID и Mobile-ID доступны. Smart-ID поддерживает Эстонию, Латвию, Литву и Бельгию. Mobile-ID поддерживает Эстонию и Литву. Выберите кошельки, которые принимает ваш сценарий для каждой страны, в панели управления. Полный список см. в разделе покрытие кошельков и цены.

​
Страны и предварительные требования

Интеграция охватывает Smart-ID в Эстонии (EST), Латвии (LVA), Литве (LTU) и Бельгии (BEL). Mobile-ID охватывает Эстонию (EST) и Литву (LTU); для Латвии Mobile-ID не предлагается. Эти коды стран описывают интегрированные маршруты, а не гарантию того, что каждый маршрут активирован в вашей среде. Для Smart-ID пользователю требуется активная подходящая цифровая личность Smart-ID, её личный идентификационный код и доступ к приложению. Для Mobile-ID пользователю требуется активная цифровая личность Mobile-ID, её личный идентификационный код и связанный с ней номер телефона. Вводите номер телефона Mobile-ID в международном формате: +372 для Эстонии или +370 для Литвы. Выбранная страна должна совпадать с используемой цифровой личностью. Ни один из методов не возвращает портретное фото. Если вашему сценарию требуется селфи, настройте соответствующие шаги Проверка живости и Сравнение лиц отдельно.

​
Что видит пользователь

  1. Пользователь выбирает свою страну и выбирает Smart-ID или Mobile-ID из числа кошельков, принимаемых вашим сценарием.
  2. Сессия верификации запрашивает личный идентификационный код; для Mobile-ID также запрашивается связанный номер телефона.
  3. На странице отображается проверочный код, пока запрос на аутентификацию отправляется на телефон.
  4. Пользователь проверяет, что код на телефоне совпадает с кодом на странице верификации, а затем подтверждает операцию с помощью своего PIN-кода на телефоне.
  5. Didit проверяет подписанный результат идентификации и продолжает сценарий верификации.
Форма идентификации и экран с проверочным кодом используют ту же верстку, что и другие методы верификации. При включённой кастомизации White label они наследуют цвета, типографику, стиль кнопок и логотип клиента из сессии и остаются на домене сессии. Обновление страницы восстанавливает активный проверочный код без запуска повторного запроса на подтверждение. Пользователь никогда не вводит PIN-код своего кошелька на странице верификации. Если коды различаются или пользователь не инициировал запрос, ему следует его отменить. Процесс с проверочным кодом работает в браузере на десктопе или телефоне и не требует QR-кода. Страница автоматически ожидает результат и предоставляет возможность отмены. Подтверждение на телефоне всё равно должно пройти проверки личности и подписи, прежде чем Didit сочтёт верификацию через кошелёк успешной.

​
Настройка сценария

В панели управления откройте узел Верификация личности вашего сценария, выберите Страны и откройте страну, которую хотите настроить. В разделе Принимаемые кошельки выберите доступные кошельки и задайте поведение при сбое. Сохраните и опубликуйте сценарий перед созданием новой сессии. Полный путь в панели управления см. в разделе Методы верификации личности в панели управления.
Ниже приведён фрагмент конфигурации methods, а не полный запрос сценария. Используйте его только тогда, когда оба кошелька smart_id и mobile_id помечены как available для Эстонии в вашей среде. Недоступный кошелёк приведёт к ошибке сохранения всего сценария.
Массив providers представляет собой список разрешённых: пользователи выбирают среди его кошельков, а порядок элементов в массиве не задаёт предпочтительный кошелёк. Для Литвы используйте LTU с теми же идентификаторами кошельков, когда доступны оба. Для Латвии или Бельгии используйте LVA или BEL только со smart_id при условии аналогичной проверки доступности. Для пропущенных стран сохраняется существующее стандартное поведение со сканированием документов. Полный контракт конфигурации описан в разделе Конфигурации функций сценария.

​
Чтение подтверждённого результата

Получите данные завершённой сессии через API решения по сессии или вашу интеграцию с webhook. Успешная проверка кошелька фиксирует verification_method: "wallet", assurance: "cryptographic" и wallet_provider: "smart_id" или "mobile_id". Объект wallet_verification определяет кошелёк, страну выдачи, время верификации, уровень достоверности и вердикт по подписи. Результат верификации личности предоставляет нормализованные поля full_name и date_of_birth. Для этих двух кошельков wallet_verification.attributes содержит поля given_name, family_name, birthdate и personal_code из подтверждённой цифровой личности. Страна выдачи указывает на маршрут идентификации; она не определяет гражданство человека. Didit возвращает вердикт по подписи, а не само подписанное утверждение. Портретное фото или PIN-код кошелька не возвращаются. В панели управления карточка сессии Учётные данные показывает кошелёк и его проверенные подтверждения. Успешная проверка кошелька завершает шаг верификации личности; последующие проверки в вашем сценарии по-прежнему определяют итоговое решение по сессии. Типы полей и различия между результатом проверки и общим решением по сессии см. в разделе Модель данных верификации личности.

​
Обработка отмены и сбоев

Если пользователь отменяет процесс, истекает время ожидания или не удаётся пройти аутентификацию, Didit применяет настройку wallet.on_failure для данной страны. fallback_to_document запускает захват документа, если он включён для этой страны. decline отклоняет шаг Верификации личности. Если захват документа отключён, резервный вариант с документом недоступен. Плата за верификацию через кошелёк списывается только за завершённую, успешно верифицированную проверку через кошелёк. За отменённые, истёкшие и неудачные попытки через кошелёк плата не взимается. Завершённая резервная проверка по документу считается отдельной проверкой согласно ценам на верификацию документов. Ознакомьтесь с таблицей цен на кошельки для получения опубликованных тарифов; метод без опубликованного тарифа не должен считаться бесплатным.

​
Тестирование перед переходом в продакшн

Протестируйте каждый кошелёк и страну, которые вы планируете предлагать, в той среде, где они подключены. Убедитесь, что отображаются нужные кошельки, код сравнения виден, после одобрения сценарий продолжается, а результат сессии содержит ожидаемые данные подтверждения от кошелька. Также проверьте отмену, истечение срока действия и поведение выбранного вами резервного варианта. Симуляции в песочнице и тесты в стейджинг-среде отличаются от аутентификации в продакшне. Симулированное одобрение полезно для проверки вашей интеграции, но не доказывает, что реальная личность сможет пройти аутентификацию в продакшне. Перед запуском подтвердите доступность в продакшне в консоли и выполните авторизованную верификацию на реальном устройстве для маршрута, который вы собираетесь использовать.

​
Другие кошельки цифровой идентификации

Каталог кошельков цифровой идентификации Didit содержит информацию о доступности в продакшне и планируемых кошельках, включая доступную сеть Finnish Trust Network и предстоящие интеграции с BankID и EUDI Wallet. Наличие кошелька в списке, опубликованная цена или заполненная форма онбординга сами по себе не активируют аутентификацию в продакшне. Используйте каталог и консоль вашей среды, чтобы определить, что вы можете активировать уже сегодня. См. также Finnish Trust Network для Финляндии.
Последнее изменение 7 ноября 2026 г.