Passaggio 2: crea un ID di test nella sandbox

Un ID di test ti consente di eseguire l'intero flusso di presentazione e di verificare che il tuo servizio accetti e convalidi una risposta di Google Wallet, senza bisogno di un documento di identità ufficiale reale. Puoi creare l'ID di test scansionando un passaporto elettronico simulato in Google Wallet sul tuo dispositivo sandbox.

Inizia

Scegli il tuo percorso RP, VR o di persona

1

Configura la sandbox Inserisci l'account nella lista consentita e cambia dispositivo

2Qui

Crea un ID di test Aggiungi un pass ID di test a Wallet

3

Integra Sviluppa in base al tuo percorso:

Relying Party→ Verifier Registrar→

4

Testa l'integrazione Esegui l'elenco di controllo E2E e registra il video

5

Pubblica i tuoi annunci Lancia la campagna in base al tuo percorso:

Relying Party→ Verifier Registrar→

Passaggi in questa pagina

A Configura due dispositiviSmartphone simulatore + smartphone con Wallet sandbox B Aggiungi un documento di identità di test a WalletScansiona la MRZ e tocca utilizzando NFC C Esamina il documento di identità in WalletControlla i dettagli della carta in Google Wallet D Utilizza il documento di identità di testRichiedi il tipo di documento del pass ID e testa il flusso

Passaggio A: configura i due dispositivi Android

Ti servono due dispositivi Android: il primo dispositivo simula un passaporto elettronico, mentre il secondo dispositivo è quello in cui aggiungi la tessera ID derivata dal passaporto elettronico simulato.

Requisito	Dispositivo 1: simulatore di passaporto	Dispositivo 2: il tuo Google Wallet di test
Role	Simula un passaporto elettronico NFC	Contiene il pass ID di test in Google Wallet
Procedura di configurazione	Installa l'app Utopia ePassport Simulator. Apri l'app e aggiungi una nuova voce per il passaporto. Dovrai scansionare questa voce nel passaggio B.	Installa o aggiorna l'app Google Wallet dal Play Store. Verifica che la versione di Google Play Services sia 24.38.xx o successiva (scopri come controllare). Verifica che il dispositivo NON sia un dispositivo di debug o rooted. Passa Google Wallet all'ambiente sandbox (questa operazione su un dispositivo personale elimina i dati di produzione esistenti). Accedi con un Account Google @gmail.com.

Nota: Utopia ePassport Simulator è un'app di test, non è destinata all'uso in produzione e non è un'app Google ufficiale.

Passaggio B: aggiungi l'ID di test a Wallet

1. Sul Dispositivo 2, apri l'app Google Wallet e tocca Aggiungi a Wallet.
2. Seleziona Documento di identità > Pass ID.
3. Segui le istruzioni sullo schermo fino al completamento:
   1. Scansione MRZ:su Dispositivo 1, tocca la voce creata in precedenza nell'app del simulatore e inserisci manualmente i dettagli del passaporto su Dispositivo 2.
   2. Scansione NFC:tieni il Dispositivo 1 (con la pagina MRZ dell'app del simulatore aperta) contro il retro del Dispositivo 2 durante la scansione NFC.

Passaggio C: visualizza i dettagli in Wallet

1. Una volta inserito il pass ID in Google Wallet, tocca il menu con tre puntini nell'angolo in alto a destra e seleziona Informazioni sul pass ID.
2. Tocca le opzioni elencate e verifica che funzionino come previsto. In particolare, apri la sezione dei dettagli della tessera per confermare che gli attributi corrispondano alla voce che hai creato.

Passaggio D: utilizza l'ID di test nelle richieste

Il tuo ID di test della sandbox è un pass ID. Affinché Google Wallet possa abbinarlo e presentarlo, il tuo OpenID4VP dcql_query deve richiedere un tipo di documento di tessera ID:

• com.google.wallet.idcard.1 (pass ID) o
• org.iso.23220.photoid.1 (pass ID che utilizza il tipo di documento di identità con foto ISO)

Una richiesta che richiede solo una patente di guida mobile (org.iso.18013.5.1.mDL) non corrisponderà al pass ID di test di Utopia. Per accettare qualsiasi credenziale idonea, utilizza l'esempio di più credenziali dcql_query nel Passaggio 3.A: formatta la richiesta e controlla Credenziali e attributi supportati per i percorsi di rivendicazione disponibili.

Testa il nuovo pass ID in due fasi:

1. Controllo rapido con lo strumento Web Verifier: apri verifier.multipaz.org sul Dispositivo 2 (o su un browser desktop per i test QR cross-device) e richiedi un pass ID. In questo modo, puoi verificare che il dispositivo e il pass ID di prova funzionino prima di testare il tuo codice.
2. Esegui test con il tuo servizio:una volta completato il passaggio 3, invia una richiesta firmata con le chiavi di test della sandbox (Relying Party) o con la CA principale della sandbox (Verifier Registrar) e configura il tuo server per convalidare issuerAuth rispetto al certificato Utopia Sandbox.

Risoluzione dei problemi

Problema	Aspetti da controllare
Ambiente TapAndPay non è presente in Impostazioni	Il tuo Account Google non è ancora nella lista consentita della sandbox. Consulta il Passaggio 1.A: richiedi l'accesso alla sandbox.
L'opzione Pass ID non viene visualizzata in Aggiungi a Wallet	Verifica che il Dispositivo 2 sia in modalità sandbox (Passaggio 1.C), che abbia eseguito l'accesso con un account @gmail.com, che non sia rooted/debug e che esegua Play Services 24.38.xx o versioni successive.
"Nessun documento di identità digitale disponibile" durante il test di una richiesta	Verifica che la richiesta includa com.google.wallet.idcard.1 o org.iso.23220.photoid.1 e che il Dispositivo 2 sia ancora in modalità sandbox.
La richiesta non va a buon fine prima della schermata per il consenso di Google Wallet	Verifica la firma JWS, l'intestazione del certificato x5c, client_id (x509_hash) e gw_rp_metadata_bytes.

Elimina il pass ID di test da Wallet

Tocca il menu con tre puntini in alto a destra nella schermata del documento di identità e seleziona Elimina, quindi segui le istruzioni per rimuovere la tessera ID di prova.

Passaggio successivo

Passaggio 3 (Relying Party): integra → Passaggio 3 (Verifier Registrar): integra →