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.
Dépannage et exceptions concernant l'API
- Que signifient les exceptions ?
-
Si vous rencontrez des exceptions lorsque vous travaillez avec l'API Google Wallet, consultez le tableau suivant pour obtenir des explications et des suggestions :
Exception Exemple de message Suggestion 400 – BadRequestException La requête contient un argument non valide. ID de ressource non valide : {1234567891234567899 - ABCD1234567}. Vérifiez la structure des données pour le type, le format et la longueur, puis transmettez le bon argument. 403 – PermissionDeniedException Autorisation refusée Assurez-vous que l'adresse e-mail du compte de service est correcte et correspond à un utilisateur autorisé dans la Pay & Wallet Console de votre entreprise. 404 – NotFoundException Objet Wallet {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} introuvable. Exécutez une requête GET sur l'ID d'objet avant d'essayer d'exécuter une requête PATCH ou PUT pour vous assurer que vous disposez de la version la plus récente d'un objet à mettre à jour. 404 – IssuerClassNotFoundException Classe d'objet Wallet {1234567891234567899.ABCD.1234567} introuvable. Lorsque vous effectuez une mise à jour, veillez à exécuter une requête GET avant une requête PATCH ou PUT pour vous assurer que vous disposez de la version la plus récente d'une classe à utiliser comme référence. Vérifiez également que la charge utile (objet et classe) appropriée est utilisée correctement dans la requête. 409 – AlreadyExistsException La classe d'objet Wallet {1234567891234567899.ABCD.1234567} existe déjà. Exécutez une requête GET sur l'ID de classe avant d'essayer de créer le même ID de classe. Si la ressource existe, il peut être souhaitable d'utiliser une requête PATCH ou PUT. - 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 obligatoires dans l'API sont définis sur la carte.
- Cette option vous permet de gérer de manière centralisée un seul compte principal comptant plusieurs sous-comptes d'entreprise/d'émetteur ou aucun.
- Un projet Google Cloud
- Un identifiant de compte de service
- Un seul ensemble d'utilisateurs
- 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
- 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
Questions d'ordre général
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 pour les cartes suivantes. Les notifications push créées par les développeurs ne sont actuellement pas compatibles avec Google Wallet.
| Secteur | Notification | Déclenchement | 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 | 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 Google Pay & Wallet Console.
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 utiliser la fonctionnalité Association d'applications ?
Pour utiliser cette fonctionnalité, vous devez demander à figurer sur la liste d'autorisation sur cette page.
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.
Google Wallet est-il compatible avec le géorepérage ?
Le géorepérage n'est actuellement pas pris en charge.
Comment configurer un programme de fidélité ?
Vous pouvez configurer un programme de fidélité et d'inscription 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.
Mon logo ne s'affiche pas sur les cartes que j'ai créées. Quel est le problème ?
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.
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 encodée en android.util.Base64 avec les options NO_WRAP et URL_SAFE. Cela correspond à la section 4 de la norme RFC 3548.
Comment regrouper plusieurs cartes ?
Pour regrouper facilement des cartes, vous pouvez utiliser un ID de regroupement.
Comment créer des comptes d'émetteur par programmation ?
Pour créer des comptes d'émetteur via l'API, consultez ce guide.
L'URL de mon lien JWT dépasse la limite de 1 800 caractères imposée par les navigateurs. Que dois-je faire ?
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).
Comment ne modifier qu'une partie d'une carte ?
Pour découvrir comment effectuer des mises à jour partielles à l'aide de requêtes PATCH, consultez notre guide d'exécution.
Puis-je créer des cartes de manière groupée ?
Pour découvrir comment envoyer des requêtes par lot à l'aide de l'API, consultez notre guide d'exécution.
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 Smart Tap. Pour consulter la liste des fournisseurs certifié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.
Configuration de l'environnement de développement
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 faible
Un compte Business Console ou un compte parent Business Console avec plusieurs comptes d'émetteur.
Complexité de configuration moyenne
Un compte parent avec plusieurs comptes d'émetteur.
Complexité de configuration élevée
Un compte parent avec plusieurs comptes d'émetteur.
Comment contacter l'assistance technique ?
Pour obtenir de l'aide, contactez l'équipe d'assistance via la console Google Pay et Wallet.
Laisser un commentaire
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".