> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart-ID и Mobile-ID: руководство по интеграции

> Настройте верификацию личности Smart-ID и Mobile-ID в Didit: охват стран, аутентификация, подтверждённые атрибуты и fallback.

Smart-ID и Mobile-ID позволяют пользователям подтверждать свою личность, одобряя запрос на телефоне.
Используйте [Smart-ID API](https://docs.didit.me/ru/api-reference/digital-id-wallets/smart-id.md) или [Mobile-ID API](https://docs.didit.me/ru/api-reference/digital-id-wallets/mobile-id.md), чтобы запускать верификацию из собственного приложения без сценария.
Оба метода также работают внутри шага сценария Didit **Верификация личности**, возвращая результат проверки кошелька с уровнем достоверности `cryptographic`.
Для интеграции с размещённым сценарием, описанной ниже, используйте то же создание сессий и интеграцию с webhook, что и для других ваших сценариев Didit.

> [!NOTE]
>
> **Smart-ID и Mobile-ID доступны.**
> Smart-ID поддерживает Эстонию, Латвию, Литву и Бельгию.
> Mobile-ID поддерживает Эстонию и Литву.
> Выберите кошельки, которые принимает ваш сценарий для каждой страны, в панели управления.
> Полный список см. в разделе [покрытие кошельков и цены](https://docs.didit.me/ru/core-technology/id-verification/digital-id-wallets.md#цены).

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

Интеграция охватывает Smart-ID в Эстонии (`EST`), Латвии (`LVA`), Литве (`LTU`) и Бельгии (`BEL`).
Mobile-ID охватывает Эстонию (`EST`) и Литву (`LTU`); для Латвии Mobile-ID не предлагается.
Эти коды стран описывают интегрированные маршруты, а не гарантию того, что каждый маршрут активирован в вашей среде.

Для Smart-ID пользователю требуется активная подходящая цифровая личность Smart-ID, её личный идентификационный код и доступ к приложению.
Для Mobile-ID пользователю требуется активная цифровая личность Mobile-ID, её личный идентификационный код и связанный с ней номер телефона.
Вводите номер телефона Mobile-ID в международном формате: `+372` для Эстонии или `+370` для Литвы.
Выбранная страна должна совпадать с используемой цифровой личностью.

Ни один из методов не возвращает портретное фото.
Если вашему сценарию требуется селфи, настройте соответствующие шаги [Проверка живости](https://docs.didit.me/ru/core-technology/liveness/overview.md) и [Сравнение лиц](https://docs.didit.me/ru/core-technology/face-match/overview.md) отдельно.

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

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

Форма идентификации и экран с проверочным кодом используют ту же верстку, что и другие методы верификации.
При включённой кастомизации White label они наследуют цвета, типографику, стиль кнопок и логотип клиента из сессии и остаются на домене сессии.
Обновление страницы восстанавливает активный проверочный код без запуска повторного запроса на подтверждение.

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

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

В панели управления откройте узел **Верификация личности** вашего сценария, выберите **Страны** и откройте страну, которую хотите настроить.
В разделе **Принимаемые кошельки** выберите доступные кошельки и задайте поведение при сбое.
Сохраните и опубликуйте сценарий перед созданием новой сессии.
Полный путь в панели управления см. в разделе [Методы верификации личности в панели управления](https://docs.didit.me/ru/console/id-verification-methods.md#включение-smart-id-или-mobile-id).

> [!WARNING]
>
> Ниже приведён фрагмент конфигурации `methods`, а не полный запрос сценария.
> Используйте его только тогда, когда **оба** кошелька `smart_id` и `mobile_id` помечены как `available` для Эстонии в вашей среде.
> Недоступный кошелёк приведёт к ошибке сохранения всего сценария.

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

Массив `providers` представляет собой список разрешённых: пользователи выбирают среди его кошельков, а порядок элементов в массиве не задаёт предпочтительный кошелёк.
Для Литвы используйте `LTU` с теми же идентификаторами кошельков, когда доступны оба.
Для Латвии или Бельгии используйте `LVA` или `BEL` только со `smart_id` при условии аналогичной проверки доступности.
Для пропущенных стран сохраняется существующее стандартное поведение со сканированием документов.
Полный контракт конфигурации описан в разделе [Конфигурации функций сценария](https://docs.didit.me/ru/management-api/workflows/feature-configs.md#ocr-/-верификация-личности).

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

Получите данные завершённой сессии через [API решения по сессии](https://docs.didit.me/ru/sessions-api/retrieve-session.md) или вашу [интеграцию с webhook](https://docs.didit.me/ru/integration/webhooks.md).
Успешная проверка кошелька фиксирует `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-код кошелька не возвращаются.

В панели управления карточка сессии **Учётные данные** показывает кошелёк и его проверенные подтверждения.
Успешная проверка кошелька завершает шаг верификации личности; последующие проверки в вашем сценарии по-прежнему определяют итоговое решение по сессии.
Типы полей и различия между результатом проверки и общим решением по сессии см. в разделе [Модель данных верификации личности](https://docs.didit.me/ru/reference/data-models.md#верификация-личности).

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

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

Плата за верификацию через кошелёк списывается только за завершённую, успешно верифицированную проверку через кошелёк.
За отменённые, истёкшие и неудачные попытки через кошелёк плата не взимается.
Завершённая резервная проверка по документу считается отдельной проверкой согласно [ценам на верификацию документов](https://docs.didit.me/ru/getting-started/pricing.md).
Ознакомьтесь с [таблицей цен на кошельки](https://docs.didit.me/ru/core-technology/id-verification/digital-id-wallets.md#цены) для получения опубликованных тарифов; метод без опубликованного тарифа не должен считаться бесплатным.

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

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

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

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

[Каталог кошельков цифровой идентификации](https://docs.didit.me/ru/core-technology/id-verification/digital-id-wallets.md) Didit содержит информацию о доступности в продакшне и планируемых кошельках, включая доступную сеть Finnish Trust Network и предстоящие интеграции с BankID и EUDI Wallet.
Наличие кошелька в списке, опубликованная цена или заполненная форма онбординга сами по себе не активируют аутентификацию в продакшне.
Используйте каталог и консоль вашей среды, чтобы определить, что вы можете активировать уже сегодня.

См. также [Finnish Trust Network для Финляндии](https://docs.didit.me/ru/core-technology/id-verification/finnish-trust-network.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.