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 ni des objets de Google Wallet. Toutefois, vous pouvez dissocier des objets dans Google Wallet.

Comment regrouper plusieurs cartes ?

Vous pouvez utiliser un GroupingID pour 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 fréquence pour les requêtes envoyées à l'API Google Wallet ?

Les appels à l'API Google Wallet sont limités à 20 requêtes par seconde.

L'API Google Wallet ne dispose pas de contrat de niveau de service officiel, mais nous recommandons un délai avant expiration de 10 secondes, basé sur une latence de 99e centile d'environ 5 secondes. Notez également que la latence dépend souvent de facteurs externes, tels que le temps nécessaire pour récupérer une image hébergée sur un serveur externe lors de l'insertion d'un objet avec cette image, car cela dépend de la latence du serveur externe.

Pourquoi les images personnelles sont-elles interdites sur les pass dans Google Wallet ?

Google Wallet n'accepte pas les images personnelles sur les cartes, car la réglementation actuelle stipule que tous les consommateurs ont le droit de refuser la collecte ou le traitement de données sensibles. Si des données sensibles (images personnelles) font partie de l'objet de valeur (dans un JWT), des problèmes d'hébergement peuvent survenir et les données peuvent devenir publiques, ce qui ne correspond pas à l'accord de consentement d'origine. Pour garantir la confidentialité des données, les images personnelles ne sont pas autorisées. Nous prévoyons de prendre en charge les images personnelles à l'avenir.

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

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

Comment activer les notifications push ?

Les notifications push créées par les développeurs 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
Carte 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 docs
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 de fidélité et l'inscription à celui-ci 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 à l'aide de l'API.

Smart Tap

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

Oui. 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 le sans contact avancé.

Jetons Web JSON (JWT)

Existe-t-il des outils permettant de faciliter 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 plates-formes tierces 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, vérifiez que votre logo respecte ces consignes et qu'il est 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".