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

# Verifica dell'identità: configurare i metodi in console

> Scegli quali dei tre metodi di Verifica dell'identità ogni paese può usare in Didit, imposta i fallback e leggi il metodo usato.

Nella fase [Verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/verification-methods.md) di un workflow c'è una scheda **Paesi**. Qui decidi, paese per paese, quale dei tre metodi una persona può usare e cosa succede quando un metodo senza documento non va a buon fine. Tutto ciò che si trova nella scheda scrive la chiave [`methods`](https://docs.didit.me/it/management-api/workflows/feature-configs#ocr-/-verifica-dell’identità) sul nodo Verifica dell'identità: la console e la Management API sono due viste dello stesso oggetto.

## Paesi e metodi ID consentiti

Apri un workflow, seleziona il nodo **Verifica dell'identità**, poi **Paesi**. Ogni riga di paese mostra i metodi che accetta. Seleziona un paese per aprire il suo editor.

| Sezione | Cosa controlla | Configurazione che scrive |
| - | - | - |
| **Acquisizione del documento** | Se viene accettato un documento fotografato, insieme ai tipi di documento, ai sottotipi e alle regole di acquisizione per quel paese | `document.enabled`, `documents_allowed` |
| **Ricerca senza documento** | Se viene offerta la ricerca senza documento, quanti tentativi di risposta ha a disposizione l'utente e se i passaggi successivi del workflow, Rilevamento della vitalità e Confronto facciale, vengono saltati dopo una corrispondenza basata su un ritratto | `id_lookup.enabled`, `id_lookup.max_attempts`, `id_lookup.skip_liveness_and_face_match` |
| **Wallet accettati** | Quali wallet di identità digitale offre quel paese. È un elenco di accettazione, non una classifica: l'utente finale sceglie tra quelli che selezioni | `wallet.enabled`, `wallet.providers` |
| **Ripiega sull'acquisizione del documento quando…** | Un interruttore per ogni modalità di errore | `id_lookup.on_partial_match`, `id_lookup.on_no_match`, `id_lookup.on_provider_error`, `wallet.on_failure` |

Gli interruttori **Ripiega sull'acquisizione del documento quando…** sono disattivati ogni volta che il paese non ha l'acquisizione del documento, perché non c'è un'alternativa a cui ripiegare.
Attiva **Acquisizione del documento** per il paese per usarli.

Se disattivi tutti i metodi di un paese, il salvataggio viene rifiutato con il messaggio **Nessun metodo attivo: nessuno può essere verificato qui**, perché con questa configurazione non si può verificare nessuno.

### Offri l'acquisizione del documento solo come alternativa

Apri un paese e scegli **Come verificano gli utenti qui**:

| Scelta | Cosa vedono gli utenti |
| - | - |
| **Prima il wallet, documento se fallisce** | Solo il wallet (oppure la ricerca ID, quando non è selezionato alcun wallet). L'acquisizione del documento viene proposta solo se il tentativo di accesso viene annullato, scade o non riesce, oppure se la ricerca non trova corrispondenze. |
| **Solo wallet, nessun documento** | Solo il wallet (oppure la ricerca ID). L'acquisizione del documento viene disattivata per il paese e un accesso non completato può essere ritentato: l'utente resta nel passaggio del wallet con il testo "Riprova {wallet}" e la sessione resta aperta finché l'utente non completa l'operazione o la sessione scade. |
| **L'utente sceglie wallet o documento** | Il wallet o la ricerca affiancati all'acquisizione del documento. |
| **Solo documento** | Acquisizione del documento. Non viene offerto alcun wallet né alcuna ricerca. |

**Prima il wallet** scrive `document.fallback_only` e gli interruttori di alternativa corrispondenti (`wallet.on_failure`, e gli interruttori della ricerca quando una ricerca è attiva) in un unico passaggio. **Solo wallet** imposta `document.enabled` su `false` e `wallet.on_failure` su `retry`: un accesso non completato può essere ritentato, e la sessione resta aperta finché l'utente non completa l'operazione o la sessione scade.
Funziona allo stesso modo per qualsiasi wallet in qualsiasi paese.
Entrambe le opzioni non sono disponibili finché non selezioni un wallet attivo (o non attivi una ricerca).
Un wallet contrassegnato come **Prossimamente** non può essere il primo: finché tutti i wallet di un paese sono contrassegnati come **Prossimamente**, l'acquisizione del documento resta per prima.
La lista dei paesi mostra **Wallet, poi documento** sotto ogni paese che lo usa, mentre l'anteprima mostra solo il wallet.

La stessa impostazione si trova in **Impostazioni aggiuntive** nelle schermate Wallet e Ricerca senza documento, come interruttore **Offri l'acquisizione del documento solo come alternativa**.
Entrambi i controlli modificano la stessa configurazione.

### La disponibilità è gestita dal server

La scheda legge lo stesso catalogo delle funzionalità con cui l'API effettua la validazione, quindi può proporti solo ciò che la piattaforma supporta davvero:

* Un metodo che il catalogo non offre in quel paese non viene mostrato come scelta.
* Una fonte o un wallet che il catalogo contrassegna come **Prossimamente** viene elencato per mostrarti la tabella di marcia, ma non può essere attivato.
* L'accesso con wallet è attivato per ambiente. Finché è disattivato, ogni wallet mostra **Prossimamente**, indipendentemente da ciò che dice il catalogo.

### Attiva Smart-ID o Mobile-ID

Smart-ID e Mobile-ID sono disponibili nei paesi supportati.
Consulta il [catalogo dei wallet](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md) per la copertura dei paesi.
Prima di modificare un workflow, verifica la disponibilità mostrata nel tuo ambiente attuale.

1. Apri **Workflow**, seleziona il workflow e il suo nodo **Verifica dell'identità**, poi apri **Paesi**.
2. Apri l'editor del paese e trova **Wallet accettati**.
3. Seleziona **Smart-ID** o **Mobile-ID** solo se è disponibile; lascia attiva l'acquisizione del documento se vuoi un'alternativa.
4. Scegli cosa deve succedere quando un accesso con wallet non riesce, poi salva e pubblica il workflow.
5. Avvia una nuova sessione di verifica con quel workflow e controlla la scheda **Credenziale** della sessione completata.

La [guida all'integrazione di Smart-ID e Mobile-ID](https://docs.didit.me/it/core-technology/id-verification/smart-id-mobile-id.md) elenca i codici paese supportati e il flusso con codice di confronto che vede l'utente.
Un test riuscito in pre-produzione o in sandbox non attiva il wallet in produzione.

### Richiesta e risposta previste

**Vedi dettagli** su una fonte di ricerca o su un wallet apre la richiesta e la risposta previste: cosa viene chiesto all'utente finale, in linguaggio semplice, e cosa restituisce la fonte. Ogni fonte di ricerca è indicata con il suo nome esatto: nella maggior parte dei paesi è un registro governativo, in alcuni un archivio di un'agenzia di credito o dei residenti. È questo a determinare la provenienza dei dati e il regime di consenso. L'utente finale non vede mai i campi della risposta, il nome della fonte o il prezzo.

### Interruttori globali

**Impostazioni globali** attiva un metodo in ogni paese che lo supporta, così non devi passare a mano tutti i 36 paesi. L'editor del singolo paese prevale comunque: attiva un metodo a livello globale, poi disattivalo nell'unico paese in cui non lo vuoi.

## Prezzi nella scheda

La cattura del documento mostra il suo prezzo: \$0.15 per verifica. Una ricerca senza documento mostra il prezzo per paese, e qualsiasi prezzo non ancora pubblicato nel catalogo prezzi è indicato come segnaposto nella scheda, invece di essere presentato come un preventivo. Una riga del wallet mostra il wallet, la sua copertura e la sua disponibilità.

La scheda riporta anche le conseguenze sulla fatturazione di ciascun interruttore di fallback della ricerca, così che il costo di una configurazione sia visibile prima di salvarla:

* Una ricerca su un registro che ha risposto viene fatturata: sia una corrispondenza sia una mancata corrispondenza contano, e la cattura del documento viene poi fatturata in aggiunta quando l'utente passa al fallback.
* Una ricerca che non ha mai restituito una risposta non viene fatturata, quindi un'interruzione ti costa solo il prezzo del documento.
* Se disattivi un fallback, questi utenti vengono rifiutati e non viene addebitato nient'altro.

## Lettura di una sessione

Il blocco **Verifica dell'identità** nel dettaglio di una sessione riporta un chip per il metodo che l'ha prodotta e un secondo chip per il suo [livello di garanzia](https://docs.didit.me/it/core-technology/id-verification/verification-methods.md#livelli-di-garanzia): **Documento / Documentale**, **Ricerca senza documento / Corrispondenza dei dati**, oppure il nome del wallet con **Crittografico**.

> [!NOTE]
>
> Una sessione passata dal metodo senza documento alla cattura del documento viene mostrata come sessione **Documento / Documentale**. [`fallback_from`](https://docs.didit.me/it/reference/data-models#verifica-dell’identità) in quella Verifica dell'identità indica il metodo provato per primo e il motivo per cui è terminato (ad esempio `wallet` e `cancelled`), con `action: "fallback_to_document"`.

Sotto i chip, ogni metodo mostra le proprie prove:

* **Documento**: invariato, con le immagini del fronte, del retro e del selfie, i punteggi di qualità, i campi estratti e gli avvisi.
* **Ricerca senza documento**: un **Confronto con il registro** che elenca ogni campo confrontato con ciò che l'utente ha fornito, ciò che la fonte conteneva e un risultato **Corrispondenza**, **Parziale** o **Nessuna corrispondenza**, oltre al nome della fonte, l'ora del controllo e il numero di tentativi. Una fonte che non ha risposto compare come riga separata con un errore, invece di un giudizio sul campo. Quando la fonte restituisce un ritratto, quel ritratto e il selfie dell'utente sono mostrati affiancati con il punteggio facciale.
* **Wallet**: la scheda **Credenziale**, con il wallet, la sua autorità emittente, il tipo di credenziale, il livello di garanzia dichiarato, la data della verifica, l'esito del controllo della firma e gli attributi condivisi dal wallet.

Quando una fonte o un wallet non condivide alcun ritratto, il pannello lo indica invece di lasciare un riquadro vuoto: non c'è nulla da confrontare con il volto, e Rilevamento della vitalità e Confronto facciale vengono eseguiti come passaggi separati, se il workflow li prevede.

## Correlati

* [Metodi di verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/verification-methods.md): i tre metodi, il fallback e la fatturazione
* [Ricerca senza documento](https://docs.didit.me/it/core-technology/id-verification/non-doc-lookup.md): campi per paese e consenso
* [Wallet di identità digitale](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md): attributi e garanzia per wallet
* [Workflow](https://docs.didit.me/it/console/workflows.md): creazione e pubblicazione di un workflow
* [Impostazioni delle funzionalità del workflow](https://docs.didit.me/it/management-api/workflows/feature-configs.md#ocr-/-verifica-dell’identità): le stesse impostazioni tramite API


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