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

# Integrazione Smart-ID e Mobile-ID: guida

> Configura la verifica dell'identità con Smart-ID e Mobile-ID su Didit: copertura paesi, codici di confronto, attributi verificati e fallback.

Smart-ID e Mobile-ID consentono agli utenti di verificare la propria identità approvando una richiesta sul proprio telefono.
Usa l'[API Smart-ID](https://docs.didit.me/it/api-reference/digital-id-wallets/smart-id.md) o l'[API Mobile-ID](https://docs.didit.me/it/api-reference/digital-id-wallets/mobile-id.md) per avviare la verifica dalla tua applicazione senza un workflow.
Entrambi i metodi funzionano anche all'interno del passaggio del workflow **Verifica dell'identità** di Didit, restituendo un risultato di verifica del wallet con livello di garanzia `cryptographic`.
Per l'integrazione del workflow ospitato descritta di seguito, usa le stesse procedure di creazione della sessione e di integrazione webhook degli altri tuoi workflow Didit.

> [!NOTE]
>
> **Smart-ID e Mobile-ID sono disponibili.**
> Smart-ID supporta l'Estonia, la Lettonia, la Lituania e il Belgio.
> Mobile-ID supporta l'Estonia e la Lituania.
> Seleziona i wallet che il tuo workflow accetta per ciascun paese nella console.
> Consulta [copertura e prezzi dei wallet](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md#prezzi) per l'elenco completo.

## Paesi e prerequisiti

L'integrazione copre Smart-ID in Estonia (`EST`), Lettonia (`LVA`), Lituania (`LTU`) e Belgio (`BEL`).
Mobile-ID copre Estonia (`EST`) e Lituania (`LTU`); Mobile-ID non è offerto per la Lettonia.
Questi codici paese descrivono i percorsi integrati, non la garanzia che ogni percorso sia attivato nel tuo ambiente.

Per Smart-ID, l'utente ha bisogno di un'identità Smart-ID idonea attiva, del relativo codice identificativo personale e dell'accesso all'app.
Per Mobile-ID, l'utente ha bisogno di un'identità Mobile-ID attiva, del relativo codice identificativo personale e del numero di telefono associato.
Inserisci il numero di telefono Mobile-ID in formato internazionale: `+372` per l'Estonia o `+370` per la Lituania.
Il paese selezionato deve corrispondere all'identità utilizzata.

Nessuno dei due metodi restituisce un'immagine del volto.
Se il tuo workflow richiede un selfie, mantieni i passaggi appropriati di [Rilevamento della vitalità](https://docs.didit.me/it/core-technology/liveness/overview.md) e [Confronto facciale](https://docs.didit.me/it/core-technology/face-match/overview.md) configurati separatamente.

## Cosa vede l'utente

1. L'utente seleziona il proprio paese e sceglie **Smart-ID** o **Mobile-ID** tra i wallet accettati dal tuo workflow.
2. La sessione di verifica richiede il codice identificativo personale; Mobile-ID richiede anche il numero di telefono associato.
3. La pagina mostra un codice di controllo mentre la richiesta di autenticazione raggiunge il telefono.
4. L'utente controlla che il codice sul telefono corrisponda al codice sulla pagina di verifica, quindi approva utilizzando il proprio PIN sul telefono.
5. Didit convalida il risultato firmato dell'identità e prosegue con il workflow di verifica.

Il modulo di identità e la schermata del codice di controllo utilizzano lo stesso layout degli altri metodi di verifica.
Quando la personalizzazione White label è abilitata, ereditano i colori della sessione, la tipografia, lo stile dei pulsanti e il logo del cliente, rimanendo sul dominio della sessione.
L'aggiornamento della pagina ripristina il codice di controllo attivo senza avviare un'altra richiesta di approvazione.

L'utente non inserisce mai il PIN del proprio wallet nella pagina di verifica.
Se i codici differiscono o l'utente non ha avviato la richiesta, deve annullarla.
Il flusso con codice di controllo funziona con un browser desktop o per dispositivi mobili e non richiede un codice QR.
La pagina attende automaticamente il risultato e fornisce un'opzione di annullamento.
Un'approvazione sul telefono deve comunque superare i controlli di identità e di firma prima che Didit consideri riuscita la verifica del wallet.

## Configurare il workflow

Nella console, apri il nodo **Verifica dell'identità** del tuo workflow, scegli **Paesi** e apri il paese che desideri configurare.
In **Wallet accettati**, seleziona i wallet disponibili e scegli il comportamento in caso di errore.
Salva e pubblica il workflow prima di creare una nuova sessione.
Consulta [metodi di Verifica dell'identità nella console](https://docs.didit.me/it/console/id-verification-methods.md#attiva-smart-id-o-mobile-id) per il percorso completo nella console.

> [!WARNING]
>
> Il seguente è un frammento di configurazione di `methods`, non una richiesta di workflow completa.
> Usalo solo quando **entrambi** `smart_id` e `mobile_id` sono contrassegnati come `available` per l'Estonia nel tuo ambiente.
> Un wallet non disponibile impedisce di salvare l'intero workflow.

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

L'array `providers` è una lista di elementi consentiti: gli utenti scelgono tra i suoi wallet e l'ordine dell'array non imposta un wallet preferito.
Per la Lituania, usa `LTU` con gli stessi identificatori di wallet quando entrambi sono disponibili.
Per la Lettonia o il Belgio, usa `LVA` o `BEL` solo con `smart_id`, previa la stessa verifica di disponibilità.
I paesi omessi mantengono il loro comportamento predefinito esistente di acquisizione dei documenti.
Il contratto di configurazione completo è disponibile in [Configurazioni delle funzionalità del workflow](https://docs.didit.me/it/management-api/workflows/feature-configs.md#ocr-/-verifica-dell’identità).

## Leggere il risultato verificato

Leggi la sessione completata tramite l'[API della decisione della sessione](https://docs.didit.me/it/sessions-api/retrieve-session.md) o la tua [integrazione webhook](https://docs.didit.me/it/integration/webhooks.md).
Un controllo del wallet riuscito registra `verification_method: "wallet"`, `assurance: "cryptographic"` e `wallet_provider: "smart_id"` o `"mobile_id"`.
L'oggetto `wallet_verification` identifica il wallet, il paese di emissione, l'orario di verifica, il livello di garanzia e l'esito della firma.
Il risultato della verifica dell'identità espone i campi normalizzati `full_name` e `date_of_birth`.
Per questi due wallet, `wallet_verification.attributes` include `given_name`, `family_name`, `birthdate` e `personal_code` provenienti dall'identità convalidata.
Il paese di emissione identifica il percorso dell'identità; non stabilisce la nazionalità della persona.
Didit restituisce l'esito della firma, non l'attestazione firmata sottostante.
Non vengono restituiti né un'immagine del volto né il PIN del wallet.

Nella console, la scheda **Credenziale** della sessione mostra il wallet e le relative prove verificate.
Un controllo del wallet riuscito completa il passaggio Verifica dell'identità; i controlli successivi nel tuo workflow determinano comunque la decisione finale della sessione.
Consulta il [modello dati della verifica dell'identità](https://docs.didit.me/it/reference/data-models.md#verifica-dell’identità) per i tipi di campo e la distinzione tra il risultato di un controllo e la decisione complessiva della sessione.

## Gestire l'annullamento e gli errori

Se un utente annulla, va in timeout o non riesce a completare l'autenticazione, Didit applica l'impostazione `wallet.on_failure` del paese.
`fallback_to_document` avvia l'acquisizione del documento quando è abilitata per quel paese.
`decline` rifiuta il passaggio di Verifica dell'identità.
Se l'acquisizione del documento è disabilitata, non è disponibile alcun fallback al documento.

Solo un controllo del wallet completato e verificato comporta il costo della verifica del wallet.
I tentativi del wallet annullati, scaduti o non riusciti non comportano addebiti.
Un fallback completato con documento costituisce un controllo separato in base ai [prezzi della verifica dei documenti](https://docs.didit.me/it/getting-started/pricing.md).
Consulta la [tabella dei prezzi dei wallet](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md#prezzi) per le tariffe pubblicate; un metodo senza una tariffa pubblicata non deve essere considerato gratuito.

## Testare prima della produzione

Testa ogni wallet e paese che intendi offrire nell'ambiente in cui è abilitato.
Verifica che compaiano i wallet corretti, che il codice di confronto sia visibile, che l'approvazione faccia proseguire il workflow e che il risultato della sessione contenga l'evidenza del wallet prevista.
Controlla inoltre l'annullamento, la scadenza e il comportamento di fallback che hai scelto.

Le simulazioni in sandbox e i test nell'ambiente di pre-produzione differiscono dall'autenticazione in produzione.
Un'approvazione simulata è utile per verificare l'integrazione, ma non dimostra che un'identità reale possa autenticarsi in produzione.
Prima del rilascio, conferma la disponibilità in produzione nella console e completa una verifica autorizzata su dispositivo reale per il percorso che intendi utilizzare.

## Altri wallet di identità digitale

Il [catalogo dei wallet di identità digitale](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md) di Didit include la disponibilità in produzione e i prossimi wallet in arrivo, compresi il già disponibile Finnish Trust Network e le future integrazioni BankID ed EUDI Wallet.
Un wallet elencato, un prezzo pubblicato o un modulo di onboarding completato non abilitano di per sé l'autenticazione in produzione.
Usa il catalogo e la console del tuo ambiente per verificare ciò che puoi attivare oggi.

Consulta anche [Finnish Trust Network per la Finlandia](https://docs.didit.me/it/core-technology/id-verification/finnish-trust-network.md).


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