> ## 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) : guide d'intégration

> Vérifiez l'identité en Finlande avec le Finnish Trust Network via Didit : connexion bancaire, workflows et recours documentaire.

Finnish Trust Network (FTN) permet aux utilisateurs éligibles de vérifier leur identité à l'aide d'une identité bancaire finlandaise ou d'un certificat mobile pris en charge.
Utilisez l'[API Finnish Trust Network](https://docs.didit.me/fr/api-reference/digital-id-wallets/ftn.md) pour lancer l'authentification bancaire depuis votre propre application sans passer par un workflow.
FTN fonctionne également au sein de l'étape de workflow **Vérification d'identité** de Didit, en utilisant l'identifiant de portefeuille `ftn` et le code pays `FIN`.
Pour l'intégration hébergée décrite ci-dessous, utilisez le même processus de création de session, les mêmes résultats de session et les mêmes webhooks que vos autres workflows Didit.

> [!NOTE]
>
> **Finnish Trust Network est disponible pour la Finlande.**
> Activez `ftn` dans les portefeuilles acceptés de votre workflow pour `FIN`.
> Le prix publié est de **\$0.25 par vérification effectuée**.
> Consultez la [couverture et les tarifs des portefeuilles](https://docs.didit.me/fr/core-technology/id-verification/digital-id-wallets.md#tarifs) pour l'ensemble des portefeuilles pris en charge.

## Parcours utilisateur

1. L'utilisateur choisit la Finlande et Finnish Trust Network parmi les méthodes d'identité acceptées par votre workflow.
2. Il sélectionne une banque participante ou un certificat mobile pris en charge.
3. Il s'authentifie auprès de ce service et autorise la vérification d'identité.
4. Il revient sur la session Didit, qui valide le résultat d'identité et poursuit le workflow.

La personne doit disposer d'une identité active auprès du service qu'elle sélectionne et d'un accès à sa méthode d'authentification.
Elle ne saisit ses identifiants bancaires et ses codes de validation que dans l'expérience d'authentification de ce service.
Didit ne demande aucun mot de passe bancaire dans son formulaire de vérification.

Le sélecteur de méthode et les écrans de retour Didit utilisent les paramètres de marque et de domaine personnalisé de la session.
La banque ou le service d'identité sélectionné gère ses propres écrans d'authentification.

## Configurer le workflow

Ouvrez l'étape **Vérification d'identité** de votre workflow dans la console, choisissez **Pays**, puis ouvrez **Finland**.
Sous **Portefeuilles acceptés**, activez Finnish Trust Network lorsqu'il est disponible.
Laissez la vérification de document activée si les utilisateurs doivent pouvoir utiliser un document à la place.
Enregistrez et publiez le workflow avant de créer une nouvelle session.

Ce qui suit est un extrait de configuration de `methods`, et non une requête complète de workflow :

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

Un portefeuille non disponible entraîne le rejet de l'enregistrement du workflow.
Consultez les [configurations des fonctionnalités de workflow](https://docs.didit.me/fr/management-api/workflows/feature-configs.md#vérification-d’identité-ocr) pour le contrat complet de l'API et la [configuration dans la console](https://docs.didit.me/fr/console/id-verification-methods.md) pour la configuration visuelle.

## Résultat vérifié

Une vérification FTN réussie renvoie un résultat de vérification de portefeuille avec un niveau de garantie `cryptographic`.
L'identité vérifiée comprend le nom, la date de naissance et l'identifiant personnel de l'utilisateur lorsqu'ils sont renvoyés par la méthode d'identité sélectionnée.
FTN ne renvoie pas de portrait.
Inspectez le résultat réel plutôt que de supposer que chaque champ d'identité optionnel est présent.

La carte **Justificatif** de la session affiche le portefeuille sélectionné et ses éléments de preuve vérifiés.
Consultez le [modèle de données de vérification d'identité](https://docs.didit.me/fr/reference/data-models.md#vérification-d’identité) pour le schéma du résultat.
Une authentification FTN réussie termine l'étape Vérification d'identité ; les vérifications restantes déterminent toujours la décision finale de la session.
Conservez des étapes distinctes de détection du vivant et de comparaison faciale configurées si votre workflow les requiert.

## Annulation et repli sur document

Si l'utilisateur annule, si la requête expire ou si la vérification échoue, Didit applique le paramètre `wallet.on_failure` du pays.
`fallback_to_document` lance la capture de document lorsque la vérification de document est activée pour la Finlande.
`decline` refuse l'étape Vérification d'identité.
Une méthode de document désactivée ne peut pas servir de solution de repli.
Pour orienter d'abord les utilisateurs vers Finnish Trust Network et n'afficher la capture de document qu'après un échec, définissez `document.fallback_only` sur `true`.
Consultez [Proposer la capture de document uniquement comme solution de repli](https://docs.didit.me/fr/core-technology/id-verification/verification-methods.md#proposer-la-capture-de-document-uniquement-comme-solution-de-repli).

Une redirection ou l'affichage d'un sélecteur de banque ne constitue pas une vérification d'identité réussie.
Attendez le résultat de session vérifié ou le webhook avant d'accorder l'accès.
Gérez la livraison de webhooks en double à l'aide du même traitement idempotent que le reste de votre intégration.

## Tester et lancer

Testez le portefeuille dans l'environnement où il est activé.
Testez le retour réussi, l'annulation par l'utilisateur, l'expiration, l'identité incomplète et le repli sur document.
Testez également les appareils et les contextes de navigateur sur lesquels vos utilisateurs s'appuient.
Un résultat simulé en sandbox ne prouve pas qu'une authentification bancaire réelle a eu lieu ni que l'activation en production est effective.

FTN coûte **\$0.25 par vérification effectuée** au tarif de base publié.
Les tentatives de portefeuille annulées, expirées et échouées n'entraînent pas de facturation pour une vérification de portefeuille terminée.
Un repli sur document mené à son terme est facturé séparément selon les tarifs de vérification de document.
Consultez les [tarifs des portefeuilles](https://docs.didit.me/fr/core-technology/id-verification/digital-id-wallets.md#tarifs) pour connaître les règles de facturation en vigueur.

## Guides associés

* [Couverture et tarifs des portefeuilles d'identité numérique](https://docs.didit.me/fr/core-technology/id-verification/digital-id-wallets.md)
* [Intégration de Smart-ID et Mobile-ID](https://docs.didit.me/fr/core-technology/id-verification/smart-id-mobile-id.md)
* [Méthodes de vérification d'identité](https://docs.didit.me/fr/core-technology/id-verification/verification-methods.md)
* [Intégration des webhooks](https://docs.didit.me/fr/integration/webhooks.md)


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