Passer au contenu principal
POST
cURL
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

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.

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. 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 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

Autorisations

x-api-key
string
header
requis

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.

En-têtes

Idempotency-Key
string

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.

Corps

Démarrer une vérification Google Wallet (USA, GBR, BRA, SGP, TWN).

country
enum<string>
requis

Pays ISO 3166-1 alpha-3 de l'identité Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Options disponibles:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
requis

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:<base64 SHA-256 du certificat de signature de votre application, sans remplissage>. Le portefeuille refuse la requête partout ailleurs.

Required string length: 1 - 256
vendor_data
string | null

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
object | null

Objet JSON optionnel stocké avec la vérification et retourné dans les résultats et les webhooks.

sandbox_scenario
string

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/.

Minimum string length: 1

Réponse

Une vérification de portefeuille autonome, telle que renvoyée par chaque endpoint de portefeuille.

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

L'objet de métadonnées envoyé au démarrage, ou null.

created_at
string<date-time>
requis
Dernière modification le 7 novembre 2026