Vai al contenuto principale
POST
cURL
Avvia la verifica dell’identità con Google Wallet dal tuo backend, usando la chiave API della tua applicazione. Non ti servono un workflow né un workflow_id. La risposta all’avvio descrive la successiva azione di autenticazione; non è un risultato di identità approvato.

Copertura e attivazione

L’attivazione del wallet è separata dal rilascio dell’API e dall’idoneità della tua applicazione. Un endpoint documentato non attiva un wallet contrassegnato come Disponibile prossimamente. Per le tariffe pubblicate aggiornate, consulta prezzi del wallet di identità digitale.

Cosa fa la persona

La tua pagina o app chiede direttamente a Google Wallet: non c’è alcun reindirizzamento né una pagina ospitata da Didit. Passa next_action.digital_credentials.request a navigator.credentials.get({digital: request}) in un gesto dell’utente sull’origin da cui hai avviato la richiesta, oppure a Android Credential Manager come GetDigitalCredentialOption. Poi invia ciò che restituisce il wallet a Invia la risposta del wallet. Il browser mostra un proprio codice QR quando il wallet si trova su un altro dispositivo.

Ricevere il risultato

Segui la guida all’API del wallet di identità digitale per monitorare la verifica e recuperarne il risultato. Considera come prova che il wallet ha autenticato la persona esclusivamente un risultato completato e verificato. Gli attributi di identità restituiti variano a seconda del wallet; non dare per scontato che siano presenti un indirizzo, un ritratto o tutti gli attributi richiesti.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Intestazioni

Idempotency-Key
string

Chiave di sicurezza per i nuovi tentativi opzionale (max 255 caratteri). Un nuovo tentativo con la stessa chiave, wallet e corpo restituisce la verifica originale senza avviare un secondo accesso; la stessa chiave con un altro wallet o corpo restituisce 409 idempotency_key_reused.

Corpo

Avvia una verifica Google Wallet (USA, GBR, BRA, SGP, TWN).

country
enum<string>
obbligatorio

Paese ISO 3166-1 alpha-3 dell'identità Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Opzioni disponibili:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
obbligatorio

Dove la tua pagina o app effettuerà la richiesta al wallet: l'origine https della tua pagina (il relativo host deve essere presente in allowed_return_hosts dell'applicazione o corrispondere al suo dominio white label), ad es. https://app.example.com, oppure android:apk-key-hash:<base64 SHA-256 del certificato di firma della tua app, senza padding>. Il wallet rifiuta la richiesta in qualsiasi altra posizione.

Required string length: 1 - 256
vendor_data
string | null

Il tuo riferimento per questa verifica (es. il tuo ID utente). Restituito nei risultati e nei webhook.

metadata
object | null

Oggetto JSON opzionale memorizzato con la verifica e restituito nei risultati e nei webhook.

sandbox_scenario
string

Solo per applicazioni sandbox: l'esito simulato - 'wallet_cancelled', 'wallet_timeout' o 'wallet_provider_error'; qualsiasi altro scenario (o nessuno) viene verificato. Rifiutato sulle applicazioni in produzione. Il catalogo completo è disponibile su GET /v1/sandbox/scenarios/.

Minimum string length: 1

Risposta

Una verifica del wallet autonoma, così come restituita da ciascun endpoint di wallet.

request_id
string<uuid>
obbligatorio
wallet_verification
object
obbligatorio
vendor_data
string | null
obbligatorio
metadata
object | null
obbligatorio

L'oggetto dei metadati inviato all'avvio, o null.

created_at
string<date-time>
obbligatorio
Ultima modifica il 7 novembre 2026