> ## 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.

# Finnish Trust Network (FTN): руководство по интеграции

> Настройте верификацию личности в Финляндии через Finnish Trust Network с Didit: вход через банк, сценарии и запасной документ.

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

> [!NOTE]
>
> **Finnish Trust Network доступна в Финляндии.**
> Включите `ftn` в принимаемых кошельках сценария для `FIN`.
> Опубликованная цена составляет **\$0.25 за завершённую верификацию**.
> Все поддерживаемые кошельки представлены в разделе [покрытие и цены цифровых кошельков](https://docs.didit.me/ru/core-technology/id-verification/digital-id-wallets.md#цены).

## Пользовательский путь

1. Пользователь выбирает Финляндию и Finnish Trust Network среди способов подтверждения личности, принимаемых вашим сценарием.
2. Он выбирает банк-участник или поддерживаемый мобильный сертификат.
3. Он проходит аутентификацию в этой службе и даёт согласие на верификацию личности.
4. Он возвращается в сессию Didit, которая проверяет результат идентификации и продолжает сценарий.

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

Экран выбора способа Didit и экраны возврата используют настройки брендинга и кастомного домена сессии.
Выбранный банк или сервис идентификации полностью контролирует собственные экраны аутентификации.

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

Откройте шаг **Верификация личности** вашего сценария в консоли, выберите **Страны** и откройте **Финляндия**.
В блоке **Принимаемые кошельки** включите Finnish Trust Network, если она доступна.
Оставьте верификацию документов включённой, если у пользователей должна быть возможность использовать документ вместо этого.
Сохраните и опубликуйте сценарий перед созданием новой сессии.

Ниже приведён фрагмент конфигурации `methods`, а не полный запрос на создание сценария:

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["ftn"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

При указании недоступного кошелька сохранение сценария отклоняется.
Полный контракт API см. в разделе [конфигурации функций сценария](https://docs.didit.me/ru/management-api/workflows/feature-configs.md#ocr-/-верификация-личности), а визуальную настройку см. в разделе [настройка в консоли](https://docs.didit.me/ru/console/id-verification-methods.md).

## Результат верификации

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

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

## Отмена и резервная проверка документов

Если пользователь отменяет процесс, срок действия запроса истекает или верификация завершается ошибкой, Didit применяет настройку страны `wallet.on_failure`.
Значение `fallback_to_document` запускает захват документа, если для Финляндии включена верификация документов.
Значение `decline` отклоняет шаг верификации личности.
Отключённый способ проверки документов не может служить резервным.
Чтобы сначала направлять пользователей в Finnish Trust Network и показывать захват документа только после сбоя, установите для `document.fallback_only` значение `true`.
См. раздел [Предложение захвата документов только в качестве резервного варианта](https://docs.didit.me/ru/core-technology/id-verification/verification-methods.md#предложение-захвата-документов-только-в-качестве-резервного-варианта).

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

## Тестирование и запуск

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

Опубликованная базовая цена FTN составляет **\$0.25 за завершённую верификацию**.
Отменённые, истёкшие и неудачные попытки верификации через кошелёк не облагаются платой за завершённую верификацию кошелька.
Завершённая резервная проверка документов оплачивается отдельно по тарифам верификации документов.
Актуальные правила биллинга см. в разделе [цены для кошельков](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)
* [Интеграция Smart-ID и Mobile-ID](https://docs.didit.me/ru/core-technology/id-verification/smart-id-mobile-id.md)
* [Способы верификации личности](https://docs.didit.me/ru/core-technology/id-verification/verification-methods.md)
* [Интеграция webhook'ов](https://docs.didit.me/ru/integration/webhooks.md)


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