Vai al contenuto principale
L’accesso tramite wallet è uno dei tre metodi di Verifica dell’identità. L’utente accede con un’identità digitale che già possiede — una eID nazionale o un’identità bancaria — e tale provider condivide con Didit un insieme firmato di attributi. Il risultato presenta il livello di garanzia cryptographic: un provider di identità ha autenticato la persona e firmato gli attributi restituiti. Questo è tutto ciò che il livello attesta. Non si tratta di una graduatoria rispetto agli altri due livelli — essi descrivono prove diverse, non una quantità maggiore o minore della stessa cosa — e la durata dell’accesso dipende dal flusso specifico del wallet, che Didit non controlla né garantisce.
La disponibilità è specifica per il tuo ambiente. Le tabelle seguenti descrivono la disponibilità in produzione e la console utilizza il catalogo aggiornato delle funzionalità disponibili del rispettivo ambiente quando salvi un workflow. MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID e Mobile-ID sono disponibili. Estonian ID-card, eParaksts mobile, Personalausweis, OneID e ConnectID rimangono Prossimamente in produzione. Smart-ID supporta Estonia, Lettonia, Lituania e Belgio; Mobile-ID supporta Estonia e Lituania; Finnish Trust Network supporta la Finlandia. Consulta la guida all’integrazione di Smart-ID e Mobile-ID per la copertura dei paesi, la configurazione e il flusso di verifica. Un wallet contrassegnato come Prossimamente non può essere abilitato in tale ambiente.

Scegli la tua integrazione

Usa le API per i wallet di ID digitale quando la tua applicazione gestisce l’interfaccia e i passaggi di autenticazione. Ogni wallet dispone di un endpoint di avvio dedicato, con endpoint condivisi per risultati, polling e annullamento. Non è necessario creare un workflow. Usa l’API Sessions per il percorso wallet ospitato di Didit, le regole del workflow e il fallback su documento configurato. La disponibilità del wallet, l’approvazione richiesta all’utente e gli attributi di identità verificati si applicano a entrambi i metodi di integrazione.

Prerequisiti

Ciascun wallet richiede un’identità attiva presso l’emittente indicato di seguito e l’accesso al relativo metodo di autenticazione. L’account deve essere idoneo per gli attributi richiesti e l’utente deve fornire il consenso alla loro condivisione. Una firma verifica l’emittente e le attestazioni restituite; non garantisce che ogni attributo richiesto sia presente, aggiornato o sufficiente per la tua politica di conformità. Un wallet privo di un’immagine del volto non include un confronto con selfie. Tutti i 25 wallet del catalogo sono elencati di seguito, inclusi entrambi i paesi che utilizzano BankID, ConnectID, Estonian ID-card ed eParaksts mobile. Un fallback su documento configurato esegue un controllo del documento separato. Non viene promessa alcuna data di lancio. Questi sono wallet di identità. Lo screening dei wallet crypto controlla gli indirizzi blockchain per il rischio finanziario ed è un prodotto separato.

Prezzi

✅ Disponibile indica che è abilitato in produzione. ⏳ Prossimamente indica che non è ancora abilitato in produzione, anche se i test di integrazione sono già iniziati. I wallet disponibili compaiono per primi. Su richiesta nella colonna del prezzo indica che il wallet è disponibile ma non ha una tariffa al dettaglio pubblicata; non indica una verifica gratuita. Questi sono i prezzi standard di Didit in USD per ogni verifica completata tramite wallet per i prodotti d’identità elencati di seguito. Il prezzo indicato include il controllo dell’identità tramite wallet; non viene applicata alcuna commissione di transazione eID nazionale separata. Una tariffa concordata specifica per l’organizzazione ha la precedenza. Prossimamente nella colonna del prezzo indica che il wallet è previsto e che il relativo prezzo per il cliente non è ancora stato pubblicato. Non significa che la verifica sia gratuita. Le bandiere dei paesi mostrano la copertura del catalogo del wallet; la colonna separata sulla disponibilità mostra se può essere attualmente abilitato. Un prezzo pubblicato non abilita un wallet. La disponibilità sopra indicata proviene dal catalogo di produzione. Un wallet contrassegnato con Prossimamente non può ancora essere selezionato in un workflow; queste tariffe si applicano quando diventa disponibile.
  • Un accesso verificato tramite wallet viene addebitato una sola volta per nodo di Verifica dell’identità in un workflow, o una volta per richiesta di verifica tramite l’API autonoma del wallet. I callback o i controlli di stato ripetuti non generano ulteriori addebiti.
  • Gli accessi annullati, scaduti, rifiutati o incompleti non generano un addebito per la verifica del wallet.
  • I prezzi dei wallet sono prezzi di listino: lo sconto del tuo piano si applica a essi come a ogni altro controllo.
  • Un fallback al documento è un controllo separato, fatturato in base ai prezzi della verifica dei documenti. Le altre funzionalità completate del workflow vengono fatturate separatamente.
Ad esempio, 1,000 verifiche di identificazione completa completate con iDIN alla tariffa standard costano $950, prima di altre funzionalità del workflow. Si tratta di un’identificazione completa; non è un prezzo per accessi ripetuti. La tariffa BankID indicata sopra è per Norway High, mentre la tariffa eID tedesca è per Personalausweis Profile 2.

Cosa fa l’utente

  1. Seleziona il proprio paese nel passaggio di identificazione e sceglie un wallet tra quelli che accetti.
  2. Accede con quel wallet, esattamente come accede alla propria banca o al portale governativo.
  3. Approva la condivisione dei propri attributi di identità con te.
  4. Ritorna con lo stato verificato.
L’accesso sullo stesso dispositivo reindirizza l’utente all’app del wallet e lo riporta al flusso di verifica una volta terminato. L’accesso tra dispositivi diversi mostra un codice QR sullo schermo del computer che l’utente scansiona con il telefono su cui è presente il wallet. Entrambe le modalità vengono offerte dove supportate dal wallet; la scelta spetta all’utente. Quando Smart-ID o Mobile-ID è abilitato per il tuo workflow, l’utente inserisce il proprio codice identificativo personale nella pagina di verifica. Mobile-ID richiede anche il numero di telefono associato all’identità. La pagina mostra un codice di confronto e l’utente approva sul proprio telefono solo quando tale codice corrisponde. L’utente inserisce il proprio PIN sul telefono; Didit non lo richiede mai. Questo flusso funziona da computer o da telefono senza bisogno di un codice QR. La disponibilità è determinata dal catalogo delle funzionalità in produzione; un wallet contrassegnato con Prossimamente non può ancora essere abilitato. Un accesso avviato rimane valido per un intervallo di tempo limitato (10 minuti per impostazione predefinita). Trascorso tale periodo, l’utente deve avviarlo nuovamente.

Elenco dei wallet accettati

wallet.providers è l’elenco dei wallet che un paese può offrire. Non si tratta di una graduatoria: l’ordine inviato non ha alcun significato, viene normalizzato secondo l’ordine del catalogo al momento del salvataggio e l’utente finale sceglie tra quelli che hai accettato. Puoi abilitare un solo wallet o tutti i wallet di un paese: la scelta spetta all’utente. L’API rifiuta un workflow che abilita un wallet non offerto dal catalogo in quel paese, oppure uno ancora contrassegnato con Prossimamente.
L’elenco degli attributi di ciascun wallet riportato di seguito include un’asserzione firmata. Didit verifica tale firma e riporta l’esito come wallet_verification.signature_valid sulla sessione; l’asserzione stessa non viene restituita, pertanto non vi è alcun riferimento da recuperare o archiviare. La colonna Sulla sessione indica quale delle due opzioni si riceve per ciascun attributo.

Wallet supportati

I wallet disponibili sono MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID e Mobile-ID. iDIN è disponibile per l’identificazione completa nei Paesi Bassi. Smart-ID e Mobile-ID sono disponibili nei paesi elencati nel catalogo seguente. La copertura geografica e i dati richiesti per Smart-ID e Mobile-ID riflettono l’integrazione implementata; la disponibilità in produzione rimane gestita separatamente. Usa la guida all’integrazione per i percorsi implementati di Smart-ID e Mobile-ID.
Disponibilità proviene dal catalogo delle funzionalità, non è gestita manualmente qui. Prossimamente indica che il wallet è visibile nella console ma non può ancora essere attivato; non comporta alcuna data vincolante.

Carta d’identità estone ed eParaksts mobile

Entrambi i metodi sono integrati nel catalogo dei wallet ma rimangono contrassegnati come Prossimamente in produzione. Non possono essere abilitati nei workflow di produzione finché il catalogo di produzione non li contrassegna come Disponibile. Gli identificativi API sono idcard_ee per l’Estonia (EST) ed eparaksts_mobile per la Lettonia (LVA). Entrambi hanno un prezzo di $0.55 per verifica completata quando disponibili; una tariffa pubblicata non abilita l’accesso in produzione.
  • Carta d’identità estone: l’utente prosegue nel browser sul computer collegato al proprio lettore di smart card e si autentica con la propria carta e il PIN tramite il software della carta.
  • eParaksts mobile: l’utente prosegue verso il servizio di accesso all’identità e approva con il proprio account eParaksts mobile attivo. Gli utenti da desktop possono scansionare il codice QR per continuare sul proprio telefono; gli utenti da telefono proseguono direttamente.
Entrambi utilizzano il flusso condiviso di Didit per la selezione, il passaggio e il ritorno del wallet. L’utente inserisce il proprio PIN di autenticazione solo nel servizio di identità o nel software della carta, mai in un modulo Didit. Dopo l’autenticazione, Didit verifica gli attributi di identità firmati e prosegue con il workflow configurato. L’annullamento o il fallimento segue il fallback al documento o l’azione di rifiuto configurati nel workflow.
Il White label si applica alle schermate di verifica di Didit. Le schermate di autenticazione esterne per questi due metodi mantengono il branding del proprio servizio. I loghi personalizzati, i nomi dei servizi e lo stile White label non si applicano a tali schermate esterne.

Usare questi wallet tramite l’API

Entrambi i metodi supportano anche la verifica API autonoma senza un workflow_id. La disponibilità in produzione è la stessa sia per l’API autonoma che per i workflow; controlla GET /v3/id-verification/wallets/ prima di proporre uno di questi metodi agli utenti. Conserva la tua x-api-key sul tuo backend e registra l’host di ritorno della tua applicazione nella sua impostazione allowed_return_hosts. Invia un return_url HTTPS su tale host all’avvio di una verifica. La risposta iniziale restituisce un request_id e un wallet_verification.next_action.url per il browser dell’utente. Reindirizza l’utente a tale URL affinché possa autenticarsi con la propria carta o app. Dopo il suo ritorno, recupera GET /v3/id-verification/wallets/verifications/{request_id}/ dal tuo backend per controllare il risultato della verifica, oppure elabora il webhook firmato status.updated. Non considerare il solo reindirizzamento del browser come prova dell’avvenuta verifica. A entrambe le opzioni di integrazione si applicano lo stesso prezzo e le medesime regole di fatturazione per verifica completata.

Google Wallet

Google Wallet consente a una persona di condividere un documento d’identità rilasciato dallo stato dal proprio telefono con la tua pagina o app, tramite la Digital Credentials API del W3C. È disponibile in produzione e in sandbox. Le applicazioni in sandbox non necessitano di alcuna registrazione. Ciascuna applicazione di produzione si registra una sola volta prima di poter utilizzare Google Wallet: nella console, apri il passaggio di verifica dell’identità, trova la riga di Google Wallet di un paese supportato, seleziona Registra con Google e completa la configurazione una tantum, che richiede circa un minuto. Google mostrerà quindi il tuo nome e il tuo logo quando le persone condividono il proprio documento d’identità. Finché l’applicazione non è registrata, il salvataggio di un workflow che abilita Google Wallet viene rifiutato con “Register this application with Google before enabling Google Wallet.” Gli utenti finali dei tuoi clienti visualizzano l’opzione come Verify with digital ID, poiché oltre a Google Wallet qualsiasi altro wallet Android che supporta la medesima richiesta OpenID4VP e contiene un documento d’identità compatibile (un ID pass o una patente di guida digitale) può rispondere.
  • Paesi: Stati Uniti, Regno Unito, Brasile, Singapore e Taiwan.
  • Credenziali: l’ID pass di Google Wallet creato da un passaporto, oltre alle patenti di guida digitali degli stati USA supportati.
  • Dati restituiti: nome, data di nascita, numero del documento, data di scadenza del documento, paese e autorità di emissione, nonché nazionalità per un ID pass. Il risultato include anche il verdetto signature_valid per la credenziale. Non viene condivisa alcuna fototessera.
  • Privacy: Didit richiede esclusivamente i campi necessari, e solo tali campi lasciano il wallet. La persona approva la condivisione in Google Wallet sul proprio dispositivo.
Non è previsto alcun reindirizzamento: la persona conferma nella richiesta del wallet nativa del browser o di Android, mentre i browser desktop mostrano il proprio codice QR quando il wallet si trova su un telefono. La verifica viene richiesta dalla tua pagina o app, pertanto l’integrazione API necessita dell’origine HTTPS della tua pagina. Il flusso ospitato dalle Sessions API propone il metodo solo sui browser e dispositivi che lo supportano, mantenendo altrimenti il fallback al documento. Quando mostri il flusso ospitato all’interno della tua pagina, usa l’SDK Web 0.5.1 o versioni successive, oppure aggiungi digital-credentials-get all’attributo allow del tuo iframe: in sua assenza il browser rifiuta la richiesta del wallet all’interno dell’iframe.

Altri wallet in arrivo

ConnectID (Australia) è integrato per i test in sandbox e compare nel catalogo dei wallet come connectid. L’utente seleziona una banca di test aderente utilizzando il selettore di ConnectID, accede con tale banca ed esamina la richiesta di condivisione. Il bundle di identità iniziale richiede nome, cognome e data di nascita, con un riferimento di transazione per la verifica. Non richiede un indirizzo, numero di telefono, indirizzo email, saldo del conto o cronologia delle transazioni. L’informativa di condivisione identifica Didit e l’azienda che riceve l’identità verificata. Le credenziali bancarie rimangono presso la banca. L’accesso in produzione rimane Prossimamente; i test in sandbox non abilitano la verifica dell’identità in produzione. Prima dell’attivazione devono essere completati un caso d’uso di produzione approvato, l’onboarding del cliente, i termini obbligatori e la certificazione. Anche gli altri wallet contrassegnati come Prossimamente nelle tabelle restano non disponibili in produzione. Non viene promessa alcuna data di lancio.

Livello di garanzia

Laddove un wallet fornisca un livello di garanzia eIDAS (low, substantial o high), Didit registra il livello effettivamente attestato sul risultato. Un wallet privo di un livello eIDAS specificato, come ConnectID, viene mostrato come Non specificato; la sua integrazione non implica una dichiarazione di garanzia eIDAS. Se un wallet restituisce un livello inferiore a quello richiesto, l’accesso fallisce invece di effettuare silenziosamente un downgrade. Verifica wallet_verification.level_of_assurance sulla sessione se le tue regole di compliance dipendono da questo valore.

Riferimento per wallet

MitID

mitid · Disponibile Informazioni inserite in Didit: Nome · Data di nascita · Alias CPR (pseudonimizzato)

BankID

bankid_se · Disponibile Informazioni inserite in Didit: Nome · Numero personale

iDIN

idin · Disponibile Informazioni inserite in Didit: Nome · Data di nascita · Indirizzo

Finnish Trust Network

ftn · Disponibile Informazioni inserite in Didit: Nome · Codice identificativo personale

Google Wallet

google_wallet · Disponibile Informazioni inserite in Didit: Nessun dato d’identità inserito in Didit

Smart-ID

smart_id · Disponibile Informazioni inserite in Didit: Codice identificativo personale

Mobile-ID

mobile_id · Disponibile Informazioni inserite in Didit: Codice identificativo personale · Numero di telefono Mobile-ID

BankID

bankid_no · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Numero identificativo nazionale

Vipps

vipps · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Numero di identità nazionale

Buypass ID

buypass · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Numero di identità nazionale

itsme

itsme · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Numero di registro nazionale

Personalausweis

personalausweis · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Nazionalità · Indirizzo

Freja eID

frejaid · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Numero personale

UAE PASS

uae_pass · In arrivo Informazioni inserite in Didit: Nome · Numero dell’Emirates ID · Nazionalità · Ritratto

gov.br

govbr · In arrivo Informazioni inserite in Didit: Nome · CPF

OneID

oneid · In arrivo Informazioni inserite in Didit: Nome · Data di nascita

GOV.UK Wallet

govuk_wallet · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Ritratto

Estonian ID-card

idcard_ee · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Codice identificativo personale

eParaksts mobile

eparaksts_mobile · In arrivo Informazioni inserite in Didit: Nome · Data di nascita · Codice identificativo personale

Bank iD

bankid_cz · Prossimamente Informazioni inserite in Didit: Nome · Data di nascita

MojeID

mojeid · Prossimamente Informazioni inserite in Didit: Nome · Data di nascita

Diia

diia · Prossimamente Informazioni inserite in Didit: Nome · Data di nascita · Ritratto

FranceConnect

franceconnect · Prossimamente Informazioni inserite in Didit: Nome · Data di nascita

Auðkenni

audkenni · Prossimamente Informazioni inserite in Didit: Nome · Kennitala

ConnectID

connectid · Prossimamente Informazioni inserite in Didit: Nessun dato di identità inserito in Didit

EUDI Wallet

eudi · Prossimamente Informazioni inserite in Didit: PID - dati di identificazione della persona

Fallimento e fallback

Qualsiasi esito diverso da verified segue l’opzione wallet.on_failure del paese: fallback_to_document reindirizza l’utente all’acquisizione del documento, decline termina la sessione con una Verifica dell’identità rifiutata. fallback_to_document con l’acquisizione del documento disabilitata per quel paese rifiuta la verifica, poiché non c’è alcun metodo di fallback disponibile. Per mostrare l’acquisizione del documento solo dopo un accesso al wallet non riuscito, consulta Offrire l’acquisizione del documento solo come fallback. Viene fatturato solo un accesso completato. Gli accessi abbandonati, annullati, terminati per timeout e falliti non hanno alcun costo.

Cosa viene registrato nella sessione

attributes contiene le dichiarazioni convalidate del wallet, i cui nomi variano a seconda del wallet. Usa full_name e date_of_birth nel risultato della verifica dell’identità per i campi normalizzati dell’identità. La tabella per ciascun wallet distingue tali campi normalizzati dagli attributi specifici del wallet. portrait è presente solo per i wallet che ne condividono uno. signature_valid è il risultato della convalida dell’asserzione firmata restituita dal wallet. È true in caso di accesso completato: un’asserzione non convalidata fa fallire l’accesso e segue wallet.on_failure anziché produrre un risultato approvato. I tipi completi dei campi sono disponibili nel modello dati della verifica dell’identità.

Configurazione dei wallet

Questo è un frammento di configurazione da utilizzare solo quando il catalogo del tuo ambiente contrassegna ciascun wallet selezionato come available nel paese scelto. L’invio di un wallet non disponibile comporta il rifiuto del salvataggio dell’intero workflow, inclusi eventuali altri metodi presenti nella stessa richiesta. Per esempi relativi a Smart-ID e Mobile-ID, consulta la guida all’integrazione.
Abilita almeno un wallet quando wallet.enabled è true, altrimenti il salvataggio verrà rifiutato. Il riferimento completo è disponibile in Configurazioni delle funzionalità del workflow.

Correlati

Ultima modifica il 7 novembre 2026