Vai al contenuto principale
Nella fase Verifica dell’identità 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 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. 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: 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 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 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: Documento / Documentale, Ricerca senza documento / Corrispondenza dei dati, oppure il nome del wallet con Crittografico.
Una sessione passata dal metodo senza documento alla cattura del documento viene mostrata come sessione Documento / Documentale. fallback_from 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

Ultima modifica il 7 novembre 2026