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.
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.
Cosa fa l’utente
- Seleziona il proprio paese nel passaggio di identificazione e sceglie un wallet tra quelli che accetti.
- Accede con quel wallet, esattamente come accede alla propria banca o al portale governativo.
- Approva la condivisione dei propri attributi di identità con te.
- Ritorna con lo stato verificato.
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 sonoidcard_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.
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 unworkflow_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_validper 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.
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 comeconnectid.
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 comeavailable 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.
wallet.enabled è true, altrimenti il salvataggio verrà rifiutato. Il riferimento completo è disponibile in Configurazioni delle funzionalità del workflow.
Correlati
- Integrazione con Finnish Trust Network - Finlandia, autenticazione bancaria e fallback su documento
- Integrazione con Smart-ID e Mobile-ID - copertura geografica, codici di confronto e configurazione del workflow
- Metodi di Verifica dell’identità — i tre metodi, fallback e fatturazione
- Consultazione senza documenti — il metodo di confronto dati
- Metodi di Verifica dell’identità nella console — abilitare i wallet per paese