Questions fréquentes sur l'API Google Wallet

Premiers pas

Qu'est-ce que l'API Google Wallet ?

L'API Google Wallet permet aux développeurs de créer des cartes numériques dans Google Wallet. L'API Google Wallet est actuellement compatible avec les cartes d'embarquement, les billets pour des événements, les cartes de fidélité, les offres et les titres de transport. Plus récemment, le type "Carte générique" a été ajouté afin de prendre en charge davantage de cas d'utilisation.

Comment configurer mon environnement de développement en fonction des exigences et de la complexité de mon entreprise ?

Vous trouverez ci-dessous des guides pour configurer un environnement de développement en fonction de différents niveaux de complexité et de sécurité. L'utilisation de plusieurs comptes de service permet aux développeurs de créer un environnement de test distinct de leur environnement de production.

Complexité de configuration de base

Un compte Business Console ou un compte parent Business Console avec plusieurs comptes d'émetteur.

  • Cette option vous permet de gérer de manière centralisée un seul compte principal comptant plusieurs sous-comptes d'entreprise/émetteur ou aucun.
  • Un projet Google Cloud.
  • Un identifiant de compte de service.
  • Un seul ensemble d'utilisateurs.

Complexité de configuration moyenne

Un compte parent avec plusieurs comptes d'émetteur.

  • Cette option vous permet de gérer de manière centralisée un seul compte principal comptant plusieurs sous-comptes d'entreprise.
  • Un projet Google Cloud.
  • Compte utilisateur Business Console distinct pour chaque émetteur.
  • Un à plusieurs identifiants de compte de service.
    • Un identifiant par entreprise/émetteur.
    • Identifiants d'accès différents pour chaque entreprise.

Complexité de configuration élevée

Un compte parent avec plusieurs comptes d'émetteur.

  • Cette option vous permet de gérer de manière centralisée un seul compte principal comptant plusieurs sous-comptes d'entreprise.
  • Un à plusieurs projets Google Cloud.
  • Compte utilisateur Business Console distinct pour chaque émetteur.
  • Un à plusieurs identifiants de compte de service.
    • Un identifiant de production par entreprise/émetteur.
    • Un identifiant de développement par entreprise/émetteur.

Contacter l'assistance

Utiliser les cartes

Comment supprimer des classes ou des objets ?

Actuellement, vous ne pouvez pas supprimer des classes ou des objets de Google Wallet. Toutefois, les utilisateurs peuvent dissocier des objets dans Google Wallet.

Comment regrouper plusieurs cartes ?

L'GroupingID permet de regrouper facilement des cartes.

Comment ne modifier qu'une partie d'une carte ?

Consultez notre guide d'exécution pour découvrir comment effectuer des mises à jour partielles à l'aide de requêtes PATCH.

Puis-je créer des cartes de manière groupée ?

Consultez notre guide d'exécution pour découvrir comment envoyer des requêtes par lot à l'aide de l'API.

Questions d'ordre général

Quelle est la limite de débit pour les requêtes envoyées à l'API Google Wallet ?

Le débit des appels à l'API Google Wallet est limité à 20 requêtes par seconde.

Pourquoi les images personnelles ne sont-elles pas autorisées sur les cartes Google Wallet ?

Google Wallet n'accepte pas les images personnelles sur les cartes, car les réglementations actuelles stipulent que tous les consommateurs ont le droit de refuser la collecte ou le traitement de données sensibles. L'intégration de données sensibles (images personnelles) dans l'objet de valeur (dans un jeton JWT), cela peut poser des problèmes d'hébergement des données, qui risquent de devenir publiques, ce qui est contraire à l'accord de consentement d'origine. Pour garantir la confidentialité des données, les images personnelles ne sont pas autorisées. Nous mettons tout en œuvre pour prendre en charge les images personnelles à l'avenir.

Quels codes d'erreur sont renvoyés par l'API Google Wallet ?

Pour obtenir la liste des codes d'erreur et des exceptions renvoyées par l'API Google Wallet, consultez Codes d'erreur.

Comment activer les notifications push ?

Les notifications push créées par le développeur ne sont actuellement pas compatibles avec Google Wallet. Cependant, Google Wallet propose des notifications en temps voulu pour les cartes suivantes. Les notifications push créées par les développeurs ne sont actuellement pas compatibles avec Google Wallet.

Vertical Notification Déclenché Documentation
Événement Rappel à venir 3 heures avant l'événement docs
Carte d'embarquement Rappel à venir 3 heures avant le départ du vol docs
Carte d'embarquement Mise à jour de la carte Changement du terminal de départ, de la porte, de l'heure d'embarquement ou de l'heure de départ docs
Fiche d'offre Rappel d'expiration 48 heures avant l'expiration de la carte d'offre docs
Générique Rappel à venir 24 heures avant le début de l'intervalle de temps documents
Générique Rappel d'expiration 48 heures avant la fin de l'intervalle de temps docs

Les références marchand peuvent-elles être supprimées ?

Pour le moment, les références marchand ne peuvent pas être supprimées ni archivées depuis la Google Pay & Wallet Console.

Comment utiliser la fonctionnalité Association d'applications ?

Pour utiliser cette fonctionnalité, vous devez demander à figurer sur la liste d'autorisation sur cette page.

Google Wallet est-il compatible avec le géorepérage ?

Le géorepérage n'est actuellement pas accepté.

Comment configurer un programme de fidélité ?

Vous pouvez configurer un programme d'inscription et de fidélité en suivant ce guide.

Comment envoyer à Google mon logo pour les titres de transport ?

Veuillez remplir ce formulaire pour que Google ajoute votre logo à la liste d'autorisation.

Comment traiter correctement les données userProfile encodées en base64 ?

Veillez à utiliser l'encodage UTF-8 tout au long de la procédure. La chaîne JSON est d'abord encodée en UTF-8, puis en android.util.Base64 avec les options NO_WRAP et URL_SAFE. Cela correspond à la section 4 de la norme RFC 3548.

Comment créer des comptes d'émetteur par programmation ?

Consultez ce guide pour créer des comptes d'émetteur via l'API.

Sans contact avancé

Un lecteur NFC spécial est-il nécessaire pour les cartes Google Smart Tap ?

Il doit s'agir d'un terminal compatible avec Smart Tap. Pour consulter la liste des fournisseurs agréés, cliquez ici.

Comment rendre mes cartes compatibles avec la technologie NFC ?

Suivez cette procédure de configuration pour que votre carte soit utilisable avec Smart Tap.

Jetons Web JSON (JWT)

Existe-t-il des outils permettant de simplifier l'implémentation et le débogage des jetons JWT ?

Oui. Des plates-formes telles que www.jwt.io vous permettent de décoder et de déboguer vos jetons au cours du processus de développement. Vous pouvez ainsi vérifier le contenu que vous envoyez. Notez que Google n'a aucun lien avec ces tiers et n'en recommande aucune en particulier.

Vous pouvez précréer des classes et des objets à l'aide de l'API avant de créer le lien d'enregistrement de la carte (JWT).

Dépannage

Pourquoi le paramètre d'heure n'affiche-t-il pas la bonne heure de l'événement ?

L'heure affichée sur la carte correspond à l'heure locale de l'événement, avec le décalage horaire du lieu de l'événement.

Mon logo ne s'affiche pas sur les cartes que j'ai créées. Quel est le problème ?

  • Tout d'abord, assurez-vous que votre logo respecte ces consignes et qu'il est enregistré au format PNG.
  • Assurez-vous que votre logo est accessible facilement et de manière fiable. Ne redirigez pas vers des fichiers image, car ceux-ci peuvent provoquer des erreurs 404. Vos images doivent être hébergées sur un emplacement HTTPS, faute de quoi elles ne seront pas visibles dans Google Wallet.
  • Assurez-vous que tous les champs marqués comme obligatoires dans l'API sont définis sur la carte.

Assistance et commentaires

Comment contacter l'assistance technique ?

Pour obtenir de l'aide, contactez l'équipe d'assistance en cliquant sur le bouton "Contacter l'assistance" dans la barre latérale de gauche de la console Google Pay et Wallet.

Comment laisser des commentaires sur le produit ?

Pour laisser des commentaires sur le produit, cliquez sur le bouton "Envoyer des commentaires" en haut à droite de la page du site pour les développeurs, puis sélectionnez "Commentaires sur le produit". Ajoutez ensuite vos commentaires dans la zone de texte, puis cliquez sur "Envoyer".

Comment laisser des commentaires sur la documentation ?

Pour laisser des commentaires sur la documentation, cliquez sur le bouton "Envoyer des commentaires" en haut à droite de la page du site pour les développeurs, puis sélectionnez "Commentaires sur la documentation". Ajoutez ensuite vos commentaires dans la zone de texte, puis cliquez sur "Envoyer".