> ## 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. # API de vérification d'identité Google Wallet ID > Vérifiez l'identité via Google Wallet ID avec Didit : couverture par pays, étapes d'authentification, résultats et tarifs. Lancez la vérification Google Wallet ID depuis votre backend à l'aide de la clé API de votre application. Vous n'avez pas besoin de workflow ni de `workflow_id`. La réponse de démarrage décrit la prochaine action d'authentification ; elle ne constitue pas un résultat d'identité approuvé. ## Couverture et activation | Propriété | Valeur | | - | - | | Portefeuille | Google Wallet ID | | Identifiant du portefeuille | `google_wallet` | | Pays | ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/us.svg)États-Unis, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/gb.svg)Royaume-Uni, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/br.svg)Brésil, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/sg.svg)Singapour, ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/tw.svg)Taïwan | | Activation du portefeuille en production | ✅ Disponible | | Prix publié du portefeuille | \$0.20 par vérification terminée | L'activation du portefeuille est indépendante du déploiement de l'API et de l'éligibilité de votre application. Un endpoint documenté n'active pas un portefeuille marqué Bientôt disponible. Pour les tarifs publiés en vigueur, consultez la [tarification des portefeuilles d'identité numérique](https://docs.didit.me/fr/getting-started/pricing.md#tarifs-des-portefeuilles-d’identité-numérique). ## Ce que fait la personne Votre page ou votre application demande directement à Google Wallet : il n'y a ni redirection ni page hébergée par Didit. Transmettez `next_action.digital_credentials.request` à `navigator.credentials.get({digital: request})` lors d'un geste de l'utilisateur, sur la même `origin` que celle utilisée au démarrage, ou à Android Credential Manager sous la forme `GetDigitalCredentialOption`. Envoyez ensuite la réponse du portefeuille à [Envoyer la réponse du portefeuille](https://docs.didit.me/fr/standalone-apis/digital-id-wallet-response.md). Le navigateur propose son propre QR code lorsque le portefeuille se trouve sur un autre appareil. ## Recevoir le résultat Suivez le [guide de l'API du portefeuille d'identité numérique](https://docs.didit.me/fr/standalone-apis/digital-id-wallets.md) pour suivre la vérification et récupérer son résultat. Considérez uniquement un résultat terminé et vérifié comme preuve que le portefeuille a authentifié la personne. Les attributs d'identité renvoyés varient selon le portefeuille ; ne partez pas du principe qu'une adresse, un portrait ou l'ensemble des attributs demandés est présent. ## Liens connexes * [API des portefeuilles d'identité numérique](https://docs.didit.me/fr/standalone-apis/digital-id-wallets.md) * [Couverture et attributs des portefeuilles](https://docs.didit.me/fr/core-technology/id-verification/digital-id-wallets.md) * [Tarifs](https://docs.didit.me/fr/getting-started/pricing.md#tarifs-des-portefeuilles-d’identité-numérique) ## OpenAPI ````yaml fr/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 de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/id-verification/wallets/google-wallet/: post: tags: - Digital ID wallets summary: Démarrer la vérification Google Wallet description: >- Démarrez une connexion Google Wallet (Google Wallet (pass d'identité) et émetteurs des États américains (permis de conduire mobile) ; USA, GBR, BRA, SGP, TWN) sans aucun workflow. Facturé une seule fois, uniquement lorsque l'identité est vérifiée. La réponse contient next_action.type=request_digital_credential avec une requête que Didit a signée pour votre application, utilisable uniquement depuis origin. Lors d'un geste de l'utilisateur depuis cette origine, transmettez next_action.digital_credentials.request à navigator.credentials.get({digital: ...}) (ou à Android Credential Manager sous la forme GetDigitalCredentialOption requestJson), puis envoyez en POST ce que le portefeuille renvoie à /v3/id-verification/wallets/verifications/{request_id}/response/. Le navigateur propose son propre QR code lorsque le portefeuille se trouve sur un autre appareil. Les applications en sandbox reçoivent une simulation déterministe (simulated: true) qui ne contacte jamais le fournisseur. operationId: start_google_wallet_wallet_verification parameters: - in: header name: Idempotency-Key schema: type: string description: >- Clé de sécurité pour les réessais optionnelle (255 caractères maximum). Réessayer avec la même clé, le même portefeuille et le même corps renvoie la vérification d'origine sans démarrer une deuxième connexion ; la même clé avec un autre portefeuille ou un autre corps renvoie 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: >- Erreurs de validation de champ ({field: [messages]}), ou erreur return_url_invalid, return_url_not_allowed, origin_invalid, origin_not_allowed, invalid_personal_code, invalid_phone_number ou idempotency_key_invalid. '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartForbidden description: >- Identifiants manquants ({detail}), ou erreur wallet_unavailable, insufficient_credits ou contract_rate_missing. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- erreur idempotency_key_reused ou idempotency_key_in_progress (avec Retry-After). '502': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: "erreur wallet_provider_unavailable\_: le fournisseur n'a pas pu démarrer\_; rien n'a été créé." '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: "erreur wallet_not_configured\_: cet environnement ne peut pas joindre le portefeuille." 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: Démarrer une vérification Google Wallet (USA, GBR, BRA, SGP, TWN). properties: vendor_data: type: string nullable: true description: >- Votre propre référence pour cette vérification (par exemple, votre identifiant d'utilisateur). Renvoyée dans les résultats et les webhooks. metadata: type: object additionalProperties: {} nullable: true description: >- Objet JSON optionnel stocké avec la vérification et retourné dans les résultats et les webhooks. sandbox_scenario: type: string minLength: 1 description: "Applications en sandbox uniquement\_: le résultat simulé - 'wallet_cancelled', 'wallet_timeout' ou 'wallet_provider_error'\_; la vérification réussit pour tout autre scénario (ou en l'absence de scénario). Rejeté sur les applications en production. Le catalogue complet est disponible à GET /v1/sandbox/scenarios/." country: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiGoogleWalletWalletVerificationStartCountryEnum description: |- Pays ISO 3166-1 alpha-3 de l'identité Google Wallet. * `USA` - USA * `GBR` - GBR * `BRA` - BRA * `SGP` - SGP * `TWN` - TWN origin: type: string minLength: 1 description: >- Endroit où votre page ou application sollicitera le portefeuille : l'origine https de votre page (son hôte doit figurer dans les allowed_return_hosts de l'application ou être son domaine en marque blanche), par exemple https://app.example.com, ou android:apk-key-hash:. Le portefeuille refuse la requête partout ailleurs. maxLength: 256 required: - country - origin DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Une vérification de portefeuille autonome, telle que renvoyée par chaque endpoint de portefeuille. 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'objet de métadonnées envoyé au démarrage, ou 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: Code stable lisible par machine, par exemple 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 terminé tant qu'il est en attente, puis Approuvé (vérifié) ou Refusé. 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: >- Vrai dès que la signature de l'attestation a été vérifiée ; null pour une attestation simulée. 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: >- Erreurs de validation de la requête : chaque champ rejeté avec ses messages. 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: Identifiant de catalogue du portefeuille, par exemple 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` - En attente * `verified` - Vérifié * `cancelled` - Annulé par l'utilisateur * `timeout` - Délai d'attente dépassé * `failed` - Échoué 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 : redirigez le navigateur de l'utilisateur vers url. confirm_in_app : affichez verification_code à l'utilisateur, qui vérifie qu'il correspond au code dans son application de portefeuille et confirme là-bas ; puis interrogez. request_digital_credential : lors d'un geste utilisateur sur l'origine initiale, interrogez le portefeuille avec digital_credentials.request, puis envoyez ce qu'il renvoie à 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: >- redirect uniquement : là où l'utilisateur se connecte avec le portefeuille. digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- request_digital_credential uniquement : la requête à transmettre au portefeuille. verification_code: type: string description: "confirm_in_app uniquement\_: le code de comparaison à 4 chiffres que l'application de portefeuille affiche également." poll_interval_seconds: type: integer description: "confirm_in_app uniquement\_: fréquence d'appel de POST .../verifications/{request_id}/poll/ pour un retour rapide. Didit interroge également les connexions en attente en arrière-plan, de sorte que le webhook signale le résultat même si vous n'effectuez pas de scrutation." 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: >- Nationalité ISO3, uniquement lorsque le portefeuille en atteste une (jamais déduite). issuing_state: type: string description: Pays ISO3 dont le système a délivré 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: "Transmettez tel quel\_: navigator.credentials.get({digital: request}) dans le navigateur, ou JSON.stringify(request) comme requestJson de GetDigitalCredentialOption sur Android. Signé par Didit pour votre application." required: - protocol - request securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Le token d'accès client-credentials de l'application. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.