> ## 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): guida all'integrazione

> Verifica l'identità in Finlandia con Finnish Trust Network e Didit: login bancario, configurazione del workflow e fallback su documenti.

Finnish Trust Network (FTN) consente agli utenti idonei di verificare la propria identità con un'identità bancaria finlandese o un certificato mobile supportato.
Usa l'[API Finnish Trust Network](https://docs.didit.me/it/api-reference/digital-id-wallets/ftn.md) per avviare l'autenticazione bancaria dalla tua applicazione senza un workflow.
FTN funziona anche all'interno del passaggio **Verifica dell'identità** del workflow di Didit, utilizzando l'identificatore di wallet `ftn` e il codice paese `FIN`.
Per l'integrazione ospitata descritta di seguito, usa le stesse modalità di creazione delle sessioni, gli stessi risultati delle sessioni e gli stessi webhook degli altri tuoi workflow Didit.

> [!NOTE]
>
> **Finnish Trust Network è disponibile per la Finlandia.**
> Abilita `ftn` nei wallet accettati del tuo workflow per `FIN`.
> Il prezzo pubblicato è di **\$0.25 per verifica completata**.
> Consulta [copertura e prezzi dei wallet](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md#prezzi) per tutti i wallet supportati.

## Percorso utente

1. L'utente sceglie la Finlandia e Finnish Trust Network tra i metodi di identità accettati dal tuo workflow.
2. Seleziona una banca aderente o un certificato mobile supportato.
3. Si autentica con quel servizio e autorizza la verifica dell'identità.
4. Ritorna alla sessione Didit, che convalida il risultato dell'identità e prosegue il workflow.

La persona deve disporre di un'identità attiva con il servizio selezionato e dell'accesso al relativo metodo di autenticazione.
Inserisce le credenziali bancarie e i codici di approvazione solo nell'esperienza di autenticazione di quel servizio.
Didit non richiede password bancarie nel proprio modulo di verifica.

Il selettore del metodo e le schermate di ritorno di Didit utilizzano le impostazioni di branding e dominio personalizzato della sessione.
La banca o il servizio di identità selezionato controlla le proprie schermate di autenticazione.

## Configurare il workflow

Apri il passaggio **Verifica dell'identità** del tuo workflow nella console, scegli **Paesi** e apri **Finlandia**.
Sotto **Wallet accettati**, abilita Finnish Trust Network quando disponibile.
Mantieni abilitata la verifica dei documenti se gli utenti devono poter utilizzare un documento in alternativa.
Salva e pubblica il workflow prima di creare una nuova sessione.

Quello che segue è un frammento di configurazione di `methods`, non una richiesta di workflow completa:

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

Il salvataggio del workflow viene rifiutato se il wallet non è disponibile.
Consulta le [configurazioni delle funzionalità del workflow](https://docs.didit.me/it/management-api/workflows/feature-configs.md#ocr-/-verifica-dell’identità) per il contratto API completo e la [configurazione della console](https://docs.didit.me/it/console/id-verification-methods.md) per la configurazione visiva.

## Risultato verificato

Un controllo FTN completato restituisce un risultato di verifica del wallet con livello di garanzia `cryptographic`.
L'identità verificata include il nome dell'utente, la data di nascita e l'identificativo personale, se restituiti dal metodo di identità selezionato.
FTN non restituisce un'immagine del volto.
Ispeziona il risultato effettivo anziché dare per scontato che ogni campo facoltativo di identità sia presente.

La scheda **Credenziale** della sessione mostra il wallet selezionato e le prove verificate associate.
Consulta il [modello dati per la verifica dell'identità](https://docs.didit.me/it/reference/data-models.md#verifica-dell’identità) per lo schema dei risultati.
L'autenticazione FTN riuscita completa il passaggio Verifica dell'identità; i controlli rimanenti determinano comunque la decisione finale della sessione.
Mantieni configurati passaggi separati di rilevamento della vitalità e confronto facciale quando il tuo workflow lo richiede.

## Annullamento e fallback su documento

Se l'utente annulla, la richiesta scade o la verifica fallisce, Didit applica l'impostazione `wallet.on_failure` del paese.
`fallback_to_document` avvia l'acquisizione del documento quando la verifica dei documenti è abilitata per la Finlandia.
`decline` rifiuta il passaggio Verifica dell'identità.
Un metodo documentale disabilitato non può fungere da fallback.
Per indirizzare gli utenti prima a Finnish Trust Network e mostrare l'acquisizione del documento solo dopo un fallimento, imposta `document.fallback_only` su `true`.
Consulta [Offrire l'acquisizione del documento solo come fallback](https://docs.didit.me/it/core-technology/id-verification/verification-methods.md#offrire-l’acquisizione-del-documento-solo-come-fallback).

Un reindirizzamento o un selettore bancario visualizzato non costituisce una verifica dell'identità riuscita.
Attendi il risultato verificato della sessione o il webhook prima di concedere l'accesso.
Gestisci la consegna duplicata dei webhook utilizzando la stessa elaborazione idempotente del resto della tua integrazione.

## Test e lancio

Testa il wallet nell'ambiente in cui è abilitato.
Testa un ritorno riuscito, l'annullamento da parte dell'utente, la scadenza, l'identità incompleta e il fallback su documento.
Testa anche i dispositivi e i contesti browser utilizzati dai tuoi utenti.
Un risultato simulato in sandbox non dimostra un'autenticazione bancaria reale né un'attivazione in produzione.

FTN costa **\$0.25 per verifica completata** secondo la tariffa base pubblicata.
I tentativi di utilizzo del wallet annullati, scaduti e non riusciti non comportano alcun addebito per verifica del wallet completata.
Un fallback su documento completato viene addebitato separatamente in base ai prezzi della verifica dei documenti.
Consulta i [prezzi dei wallet](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md#prezzi) per le regole di fatturazione vigenti.

## Guide correlate

* [Copertura e prezzi dei wallet di identità digitale](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md)
* [Integrazione di Smart-ID e Mobile-ID](https://docs.didit.me/it/core-technology/id-verification/smart-id-mobile-id.md)
* [Metodi di verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/verification-methods.md)
* [Integrazione webhook](https://docs.didit.me/it/integration/webhooks.md)


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