Compte Google Wallet
Configurez l'accès à Google Pay & Wallet Console et les identifiants de l'API Google Wallet afin que The Wallet Crew puisse émettre des cartes sous votre marque.
Configurez votre intégration Google Wallet en utilisant soit un accès délégué (recommandé pour une configuration plus rapide), soit une configuration gérée par vous-même. Ce guide couvre la création du compte, l'activation des API et la gestion des identifiants pour déployer des Cartes de portefeuille numérique via la plateforme The Wallet Crew.
Aperçu
Pour distribuer des cartes numériques via Google Wallet, votre organisation doit faire approuver un compte émetteur dans Google Pay & Wallet Console et configurer un projet Google Cloud pour l'accès à l'API. Google approuve les émetteurs manuellement, donc prévoyez 3 à 5 jours ouvrés pour l'approbation, plus 15 à 60 minutes pour la configuration technique.
Principaux éléments à configurer
Un compte émetteur dans Google Pay & Wallet Console (approbation requise)
Un projet Google Cloud avec accès à l'API Google Wallet
Vous créerez les services Google principaux sous votre marque (projet Google Cloud + approbation Google Pay & Wallet Console). Ensuite, vous déléguerez soit la configuration restante à The Wallet Crew, soit vous la complèterez vous-même et collerez les valeurs requises dans The Wallet Crew.
Vous voulez le « pourquoi » avant le « comment » ? Commencez par Wallet Apple et Google.
Prérequis
Compte Google Workspace ou Gmail avec privilèges d'administrateur
Informations sur l'entreprise pour la vérification du marchand Google Pay
Autorisation de créer des comptes de service dans Google Cloud
Configuration du projet Google Cloud
Accédez à la Console Google Cloud et connectez-vous avec le compte Google de votre entreprise.
Créez un nouveau projet en utilisant la convention de nommage thewalletcrew-<brandName> où <brandName> correspond à l'identifiant de votre organisation ou de votre marque. Par exemple : thewalletcrew-acmecorp ou thewalletcrew-retailstore. Cette convention de nommage aide à identifier d'un coup d'œil l'objectif du projet.
Délégation de compte
Cette approche permet à l'équipe The Wallet Crew de gérer la configuration technique tandis que vous conservez la propriété de tous les comptes et identifiants. Vous accorderez un accès temporaire, et nous configurerons tout selon les bonnes pratiques.
Dans la section IAM & Admin, sélectionnez IAM dans le menu de navigation de gauche. Cliquez sur le Accorder l'accès bouton et ajoutez [email protected] en tant que propriétaire du projet. Ce niveau d'autorisation permet à l'équipe The Wallet Crew de créer des comptes de service, d'activer les API et de configurer toutes les ressources nécessaires. Vous pouvez révoquer cet accès une fois la configuration initiale terminée.
Ainsi, les Cartes Google Wallet sont émises sous l'identité de votre organisation, et non celle de The Wallet Crew. Le projet que vous créez ici établit cette identité organisationnelle dans les systèmes de Google.
Configuration par vous-même
Vous gérez l'ensemble de la configuration dans vos propres comptes Google Cloud et Google Pay.
Pour accéder à la Google Pay & Wallet Console, vous devez vous inscrire. Après avoir soumis le formulaire, l'équipe d'assistance vous contactera pour valider votre cas d'utilisation et activer votre compte émetteur.
Créer un compte de service
Accédez à la page des identifiants.
Google Cloud - page des identifiants
Vérifiez que le projet actuel est
thewalletcrew-<brandName>Cliquez sur Créer des identifiants → Compte de service.
Remplissez le formulaire :
Nom du compte de service :
TheWalletCrewID du compte de service : conservez la valeur générée automatiquement
Cliquez sur Terminé pour terminer la création du compte de service.
Notez l'adresse e-mail générée pour le compte de service. Exemple : [email protected]. Vous en aurez besoin plus tard dans la Google Pay & Wallet Console.
Créer et télécharger une clé JSON
Ouvrez le compte de service que vous venez de créer. Puis accédez à l'onglet Clés onglet.
Cliquez sur Ajouter une clé → Créer une nouvelle clé.
Choisissez JSON et cliquez sur Créer.
Enregistrez le fichier généré dans un emplacement sécurisé. Vous le téléverserez plus tard dans la console d'administration The Wallet Crew.
Traitez ce fichier JSON comme un mot de passe.
Activer l'API Google Wallet
Rendez-vous sur la page de l'API Google Wallet et activez l'accès à l'API.
walletobjects.googleapis.comConfiguration de Google Pay & Wallet Console
Accédez à la Google Pay & Wallet Console et connectez-vous avec le compte Google de votre entreprise.
Délégation de compte
Accédez à la section Utilisateurs. Ajoutez [email protected] avec Administrateur autorisation. Cela permet à l'équipe The Wallet Crew de configurer les paramètres de votre émetteur et de terminer l'intégration.
L'équipe The Wallet Crew recevra une notification de votre autorisation d'accès et procédera à la création du compte de service, à l'activation de l'API et à la configuration des identifiants. Nous vous informerons lorsque la configuration sera terminée et vous fournirons vos identifiants pour les conserver en lieu sûr.
Configuration par vous-même
Invitez le compte de service
Accédez à la section Utilisateurs.
Cliquez sur Inviter un utilisateur.
Remplissez le formulaire avec les informations suivantes :
Adresse e-mail : celle notée à l'étape 1.4
Niveau d'accès : Développeur
Puis cliquez sur Inviter.
Compléter les informations de l'établissement
Cliquez sur Détails de l'établissement et vérifiez que toutes les informations sont renseignées et approuvées.
Cliquez sur API Google Wallet.
issuerIdNotez le issuerId. Vous en aurez besoin dans la console d'administration The Wallet Crew.
Configurez The Wallet Crew
Si vous configurez vous-même, retournez dans la console d'administration The Wallet Crew et ouvrez Wallet > Configuration > Google.
Wallet > Configuration > Google
Remplissez le formulaire avec :
la clé JSON du compte de service que vous avez téléchargée précédemment
le
issuerIdprovenant de la Google Pay & Wallet Console
issuerId et téléversez la clé JSONDemander un accès public (uniquement si nécessaire)
Si, après un test avec une Carte Google, vous obtenez l'erreur suivante :
Revenez à l'API Google Wallet :
Ensuite, demandez un accès public. Vous pouvez utiliser l'un de ces modèles.
Modèle d'e-mail — utilisation d'une carte de fidélité
Bonjour,
Nous aimerions utiliser l'API Google Wallet pour générer des cartes de fidélité en magasin. Le client peut scanner un code QR (exemple : xxxx), puis créer ou retrouver son compte et ajouter une carte de fidélité à son Wallet.
Nous travaillons avec The Wallet Crew pour cela.
Cordialement,
Modèle d'e-mail — utilisation pour un événement
Bonjour,
Nous aimerions utiliser l'API Google Wallet pour générer des billets d'événement. Le client recevra un e-mail avec un lien de téléchargement et ajoutera ses billets à son Wallet. Nous afficherons également un bouton « Ajouter à Wallet » sur notre site Web après l'achat des billets.
Nous travaillons avec The Wallet Crew pour cela.
Cordialement,
FAQ
Combien de temps prend l'approbation de Google ?
Google approuve manuellement l'accès des émetteurs. Prévoyez 3 à 5 jours ouvrés pour l'approbation. Puis prévoyez 15 à 60 minutes pour la configuration technique (compte de service, activation de l'API et configuration de l'émetteur).
Que devons-nous configurer dans la console d'administration The Wallet Crew ?
Vous avez besoin de deux éléments : une clé JSON du compte de service provenant de Google Cloud (compte de service → Clés) et votre issuerId provenant de la Google Pay & Wallet Console (section API Google Wallet). Une fois que vous les avez collés/téléversés dans Wallet > Configuration > Google, The Wallet Crew peut s'authentifier et émettre des Cartes sous votre émetteur.
Avons-nous besoin d'un projet Google Cloud dédié ?
Oui. Un projet dédié isole la configuration de Wallet des autres charges de travail cloud. Il facilite aussi grandement la revue des accès, la facturation et l'audit.
À quoi sert le « compte de service » ?
Le compte de service est l'identité machine utilisée pour appeler les API Google Wallet de serveur à serveur. Ce n'est pas un utilisateur humain. The Wallet Crew utilise la clé JSON du compte de service pour authentifier ces appels d'API.
Pourquoi devons-nous inviter un utilisateur/compte de service dans Google Pay & Wallet Console ?
Google Pay & Wallet Console contrôle qui peut gérer votre émetteur. Si le compte de service n'est pas invité, les appels à l'API Google Wallet échoueront même si le projet Cloud est correctement configuré. Dans une configuration autonome, invitez le compte de service en tant qu'utilisateur avec le Développeur rôle.
Que fait réellement « Activer l'API Google Wallet » ?
Cela active le point de terminaison de l'API Google Wallet (walletobjects.googleapis.com) dans votre projet Cloud. Sans cela, les requêtes échoueront avec des erreurs d'autorisation telles que « API not enabled ».
Nous obtenons une erreur demandant un « accès public ». Qu'est-ce que cela signifie ?
Certains émetteurs ont besoin d'une étape d'approbation supplémentaire de Google avant de pouvoir distribuer des Cartes à grande échelle. Cela apparaît souvent lorsque vous passez des tests à une distribution en conditions réelles. Utilisez les modèles d'e-mail de ce guide pour demander un accès public à Google.
Pouvons-nous révoquer l'accès délégué après la mise en production ?
Oui. Une fois que vous avez validé que l'émission et les mises à jour de Cartes fonctionnent de bout en bout, révoquez l'accès délégué aux deux endroits : supprimez The Wallet Crew de votre Google Cloud projet IAM, et supprimez l'utilisateur de la Google Pay & Wallet Console liste Utilisateurs. Faites-le uniquement après avoir effectué de véritables enregistrements et au moins une mise à jour réussie, afin de ne pas casser la production par inadvertance.
Faut-il renouveler la configuration chaque année ?
Généralement non. Cette configuration n'est pas quelque chose que l'on « renouvelle » selon un calendrier.
Ne refaites la configuration dans The Wallet Crew que si quelque chose a changé du côté de Google, par exemple :
Vous avez fait pivoter ou remplacé la clé JSON du compte de service.
La clé a été révoquée/désactivée, ou vous pensez qu'elle a été exposée.
Vous êtes passé à un projet Cloud différent ou issuerId.
les autorisations IAM / Console ont été modifiées et l'émission a cessé de fonctionner.
Si rien n'a changé et que les Cartes s'émettent/se mettent toujours à jour correctement, laissez tel quel.
Nous avons déjà des Cartes existantes. Comment migrer vers The Wallet Crew ?
Il s'agit d'une migration de Cartes en production, et non d'une simple « reconfiguration ».
Chez Google, vos Cartes sont liées à un compte émetteur Google Pay & Wallet Console. Vous ne pouvez pas transférer des Cartes en production vers un autre émetteur. Prévoyez de conserver le même émetteur et de déplacer la configuration opérationnelle (identifiants + données des Cartes) vers The Wallet Crew.
Suivez le guide dédié : Déplacer les Cartes vers The Wallet Crew.
Comment devons-nous stocker la clé JSON du compte de service ?
Traitez la clé JSON comme un mot de passe. Téléversez-la à The Wallet Crew via la console d'administration, puis stockez-la uniquement dans votre gestionnaire de secrets (ou supprimez-la si vous n'avez pas besoin d'en conserver une copie). Évitez de la partager par chat ou par e-mail, et faites-la pivoter immédiatement si elle a été exposée.