> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Verifica dell'identità con Google Wallet: API > Integra la verifica dell'identità tramite Google Wallet ID con Didit: copertura paesi, passaggi di autenticazione, risultati e prezzi. 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 | Proprietà | Valore | | - | - | | Wallet | Google Wallet ID | | ID wallet | `google_wallet` | | Paesi | ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/us.svg)Stati Uniti, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gb.svg)Regno Unito, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/br.svg)Brasile, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sg.svg)Singapore, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/tw.svg)Taiwan | | Attivazione del wallet in produzione | ✅ Disponibile | | Prezzo pubblicato del wallet | \$0.20 per verifica completata | 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](https://docs.didit.me/it/getting-started/pricing.md#prezzi-dei-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](https://docs.didit.me/it/standalone-apis/digital-id-wallet-response.md). 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](https://docs.didit.me/it/standalone-apis/digital-id-wallets.md) 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 * [API dei wallet di identità digitale](https://docs.didit.me/it/standalone-apis/digital-id-wallets.md) * [Copertura e attributi dei wallet](https://docs.didit.me/it/core-technology/id-verification/digital-id-wallets.md) * [Prezzi](https://docs.didit.me/it/getting-started/pricing.md#prezzi-dei-wallet-di-identità-digitale) ## OpenAPI ````yaml it/openapi-25.json POST /v3/id-verification/wallets/google-wallet/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/id-verification/wallets/google-wallet/: post: tags: - Digital ID wallets summary: Avvia la verifica Google Wallet description: >- Avvia un accesso Google Wallet (Google Wallet (ID pass) ed emittenti statali degli Stati Uniti (patente di guida mobile); USA, GBR, BRA, SGP, TWN) senza alcun workflow. Fatturato una sola volta, solo quando l'identità viene verificata. La risposta contiene next_action.type=request_digital_credential con una richiesta firmata da Didit per la tua applicazione, utilizzabile solo dall'origine. In corrispondenza di un gesto dell'utente, passa next_action.digital_credentials.request a navigator.credentials.get({digital: ...}) (o ad Android Credential Manager come GetDigitalCredentialOption requestJson), quindi invia con POST ciò che il wallet restituisce a /v3/id-verification/wallets/verifications/{request_id}/response/. Il browser propone un proprio codice QR quando il wallet si trova su un altro dispositivo. Le applicazioni sandbox ottengono una simulazione deterministica (simulated: true) che non contatta mai il provider. operationId: start_google_wallet_wallet_verification parameters: - in: header name: Idempotency-Key schema: type: string description: >- 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. requestBody: content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest example: country: USA vendor_data: your-customer-reference metadata: reference: example origin: https://app.example.com application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest multipart/form-data: schema: $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest required: true responses: '201': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResponse example: request_id: 00000000-0000-4000-8000-000000000001 wallet_verification: wallet: id: google_wallet name: Google Wallet issuing_authority: >- Google Wallet (ID pass) and US state issuers (mobile driving licence) country: USA status: Not Finished outcome: pending error: null interaction: digital_credentials simulated: false expires_at: '2026-01-01T10:10:00Z' next_action: type: request_digital_credential digital_credentials: protocol: openid4vp-v1-signed request: requests: - protocol: openid4vp-v1-signed data: request: identity: null attributes: null level_of_assurance: null verified_at: null signature_valid: null credential_type: person_identification vendor_data: your-customer-reference metadata: reference: example created_at: '2026-01-01T10:00:00Z' description: '' '400': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartBadRequest description: >- Errori di validazione dei campi ({field: [messages]}), oppure errore return_url_invalid, return_url_not_allowed, origin_invalid, origin_not_allowed, invalid_personal_code, invalid_phone_number o idempotency_key_invalid. '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartForbidden description: >- Credenziali mancanti ({detail}), oppure errore wallet_unavailable, insufficient_credits o contract_rate_missing. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- errore idempotency_key_reused o idempotency_key_in_progress (con Retry-After). '502': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- errore wallet_provider_unavailable: non è stato possibile avviare il provider; non è stato creato nulla. '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- errore wallet_not_configured: questo ambiente non può raggiungere il wallet. security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \ --url https://verification.didit.me/v3/id-verification/wallets/google-wallet/ \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Idempotency-Key: your-unique-attempt-key' \ --header 'Content-Type: application/json' \ --data '{ "country": "USA", "vendor_data": "your-customer-reference", "metadata": { "reference": "example" }, "origin": "https://app.example.com" }' components: schemas: DigitalIdWalletApiGoogleWalletWalletVerificationStartRequest: type: object description: Avvia una verifica Google Wallet (USA, GBR, BRA, SGP, TWN). properties: vendor_data: type: string nullable: true description: >- Il tuo riferimento per questa verifica (es. il tuo ID utente). Restituito nei risultati e nei webhook. metadata: type: object additionalProperties: {} nullable: true description: >- Oggetto JSON opzionale memorizzato con la verifica e restituito nei risultati e nei webhook. sandbox_scenario: type: string minLength: 1 description: >- 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/. country: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartCountryEnum description: |- Paese ISO 3166-1 alpha-3 dell'identità Google Wallet. * `USA` - USA * `GBR` - GBR * `BRA` - BRA * `SGP` - SGP * `TWN` - TWN origin: type: string minLength: 1 description: >- 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:. Il wallet rifiuta la richiesta in qualsiasi altra posizione. maxLength: 256 required: - country - origin DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Una verifica del wallet autonoma, così come restituita da ciascun endpoint di wallet. properties: request_id: type: string format: uuid wallet_verification: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationResult' vendor_data: type: string nullable: true metadata: type: object additionalProperties: {} nullable: true description: L'oggetto dei metadati inviato all'avvio, o null. created_at: type: string format: date-time required: - created_at - metadata - request_id - vendor_data - wallet_verification DigitalIdWalletApiWalletVerificationStartBadRequest: oneOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationFieldErrors' DigitalIdWalletApiWalletVerificationStartForbidden: oneOf: - $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: Codice stabile leggibile da macchina, es. wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiGoogleWalletWalletVerificationStartCountryEnum: enum: - USA - GBR - BRA - SGP - TWN type: string description: |- * `USA` - USA * `GBR` - GBR * `BRA` - BRA * `SGP` - SGP * `TWN` - TWN DigitalIdWalletApiWalletVerificationResult: type: object properties: wallet: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWallet' readOnly: true country: type: string status: type: string description: >- Non completato mentre è in sospeso, poi Approvata (verificata) o Rifiutata. outcome: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResultOutcomeEnum error: type: string nullable: true readOnly: true interaction: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiInteractionEnum' readOnly: true simulated: type: boolean readOnly: true expires_at: type: string format: date-time next_action: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextAction' nullable: true readOnly: true identity: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletIdentity' nullable: true readOnly: true attributes: type: object additionalProperties: {} nullable: true readOnly: true level_of_assurance: type: string nullable: true verified_at: type: string format: date-time nullable: true signature_valid: type: boolean nullable: true description: >- True dopo che la firma della credenziale è stata verificata; null per una simulata. credential_type: type: string nullable: true required: - attributes - country - credential_type - error - expires_at - identity - interaction - level_of_assurance - next_action - outcome - signature_valid - simulated - status - verified_at - wallet DigitalIdWalletApiWalletVerificationFieldErrors: type: object description: >- Errori di validazione della richiesta: ciascun campo rifiutato con i relativi messaggi. additionalProperties: type: array items: type: string DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission DigitalIdWalletApiWallet: type: object properties: id: type: string description: Id di catalogo del wallet, ad es. bankid_se. name: type: string issuing_authority: type: string nullable: true required: - id - issuing_authority - name DigitalIdWalletApiWalletVerificationResultOutcomeEnum: enum: - pending - verified - cancelled - timeout - failed type: string description: |- * `pending` - In sospeso * `verified` - Verificata * `cancelled` - Annullata dall'utente * `timeout` - Scaduta per timeout * `failed` - Non riuscita DigitalIdWalletApiInteractionEnum: enum: - redirect - in_app - digital_credentials type: string description: |- * `redirect` - redirect * `in_app` - in_app * `digital_credentials` - digital_credentials DigitalIdWalletApiWalletNextAction: type: object properties: type: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextActionTypeEnum' description: >- redirect: reindirizza il browser dell'utente a url. confirm_in_app: mostra verification_code all'utente, che verifica la corrispondenza con il codice nella propria app wallet e conferma lì; quindi esegui il polling. request_digital_credential: con un gesto dell'utente sull'origine da cui hai iniziato, richiedi al wallet con digital_credentials.request, quindi invia ciò che restituisce a POST .../verifications/{request_id}/response/. * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential url: type: string format: uri description: 'Solo redirect: dove l''utente effettua l''accesso con il wallet.' digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- Solo request_digital_credential: la richiesta da trasmettere al wallet. verification_code: type: string description: >- Solo confirm_in_app: il codice di confronto a 4 cifre mostrato anche dall'app del wallet. poll_interval_seconds: type: integer description: >- Solo confirm_in_app: la frequenza con cui chiamare POST .../verifications/{request_id}/poll/ per un feedback immediato. Didit esegue il polling degli accessi in sospeso anche in background, quindi il webhook segnala l'esito anche se non esegui il polling. required: - type DigitalIdWalletApiWalletIdentity: type: object properties: full_name: type: string nullable: true first_name: type: string nullable: true last_name: type: string nullable: true date_of_birth: type: string format: date nullable: true nationality: type: string nullable: true description: Nazionalità ISO3, solo quando dichiarata dal wallet (mai dedotta). issuing_state: type: string description: Paese ISO3 il cui schema ha emesso l'identità. required: - date_of_birth - first_name - full_name - issuing_state - last_name - nationality DigitalIdWalletApiWalletNextActionTypeEnum: enum: - redirect - confirm_in_app - request_digital_credential type: string description: |- * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential DigitalIdWalletApiWalletDigitalCredentialsRequest: type: object properties: protocol: type: string description: openid4vp-v1-signed. request: type: object additionalProperties: {} description: >- Passalo così com'è: navigator.credentials.get({digital: request}) nel browser, oppure JSON.stringify(request) come requestJson di GetDigitalCredentialOption su Android. Firmato da Didit per la tua applicazione. required: - protocol - request securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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. BearerAuth: type: http scheme: bearer description: Il token di accesso client-credentials dell'applicazione. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.