> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/apple-and-google-wallet/google-wallet-account.md).
# 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 l’identité propre de la marque.
Configurez l’intégration Google Wallet en utilisant soit un accès délégué (recommandé pour une configuration plus rapide), soit une configuration autonome. Ce guide couvre la création du compte, l’activation de l’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, l’organisation doit faire approuver un compte émetteur 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 ouvrables** pour l’approbation, plus **15 à 60 minutes** pour la configuration technique.
**Principaux éléments à configurer**
* Un compte émetteur Google Pay & Wallet Console (approbation requise)
* Un projet Google Cloud avec accès à l’API Google Wallet
Les services Google principaux sont créés sous la marque (projet Google Cloud + approbation Google Pay & Wallet Console). Le reste de la configuration peut ensuite être délégué à The Wallet Crew, ou réalisé en interne, avec les valeurs requises collées dans The Wallet Crew.
Vous voulez le « pourquoi » avant le « comment » ? Commencez par [portefeuilles Apple et Google](/configure/fr/advanced-configuration/wallet/apple-and-google-wallet.md).
#### Prérequis
* Un compte Google Workspace ou Gmail avec des privilèges d’administrateur
* Informations de l’entreprise pour la vérification du commerçant 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 l’entreprise.
Créez un nouveau projet en utilisant la convention de nommage `thewalletcrew-` où `` correspond à l’identifiant de l’organisation ou de la 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 la marque conserve la propriété de tous les comptes et identifiants. Un accès temporaire est accordé, et nous configurons tout selon les bonnes pratiques.
Dans la section IAM et Admin, sélectionnez **IAM** dans le menu de navigation de gauche. Cliquez sur le bouton **Accorder l’accès** et ajoutez `contact@neostore.cloud` 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. Cet accès peut être révoqué une fois la configuration initiale terminée.
Google Cloud IAM : accorder l’accès au projet
Ainsi, les cartes Google Wallet sont émises sous l’identité de l’organisation, et non celle de The Wallet Crew. Le projet créé ici établit cette identité organisationnelle dans les systèmes de Google.
### Configuration autonome
La configuration complète est gérée dans les propres comptes Google Cloud et Google Pay de la marque.
Pour accéder à Google Pay & Wallet Console, [inscrivez-vous](https://support.google.com/pay/merchants/contact/instore_merchants) d’abord. Après l’envoi du formulaire, l’équipe de support prend contact pour valider le cas d’utilisation et activer le compte émetteur.
{% stepper %}
{% step %}
**Créez un compte de service**
1. Accédez à la page des identifiants.
2. Assurez-vous que le projet actuel est `thewalletcrew-`
3. Cliquez sur **Créer des identifiants → Compte de service**.
Créez un nouveau compte de service
4. Remplissez le formulaire :
* Nom du compte de service : `TheWalletCrew`
* ID du compte de service : conservez la valeur générée automatiquement
Nom et ID du compte de service
5. 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 : `thewalletcrew@thewalletcrew-123456.iam.gserviceaccount.com`. Elle sera nécessaire plus tard dans Google Pay & Wallet Console.
{% endstep %}
{% step %}
**Créez et téléchargez une clé JSON**
1. Ouvrez le compte de service que vous venez de créer. Puis accédez à l’onglet **Clés** .
Ouvrez l’onglet Clés
Créez une nouvelle clé
2. Cliquez sur **Ajouter une clé → Créer une nouvelle clé**.
Commencez à créer une clé JSON
3. Choisissez **JSON** et cliquez sur **Créer**.
Sélectionnez le type de clé JSON
4. Enregistrez le fichier généré dans un emplacement sécurisé. Il sera importé plus tard dans la console d’administration The Wallet Crew.
{% hint style="warning" %}
Traitez ce fichier JSON comme un mot de passe.
{% endhint %}
{% endstep %}
{% step %}
**Activez l’API Google Wallet**
Accédez à la page de l’API Google Wallet et activez l’accès à l’API.
{% endstep %}
{% endstepper %}
## Configuration de Google Pay & Wallet Console
Accédez à Google Pay & Wallet Console et connectez-vous avec le compte Google de l’entreprise.
### Délégation de compte
Accédez à la section Utilisateurs. Ajoutez `contact@neostore.cloud` avec **Administrateur** comme autorisation. Cela permet à l’équipe The Wallet Crew de configurer les paramètres de l’émetteur et de finaliser l’intégration.
Ajoutez un utilisateur avec Administrateur l’accès
L’équipe The Wallet Crew recevra une notification de l’octroi d’accès et procédera à la création du compte de service, à l’activation de l’API et à la configuration des identifiants. Nous avertissons la marque lorsque la configuration est terminée et lui fournissons les identifiants à conserver en lieu sûr.
### Configuration autonome
{% stepper %}
{% step %}
**Invitez le compte de service**
1. Accédez à la section Utilisateurs.
Ouvrez la section Utilisateurs
2. Cliquez sur **Invitez 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**
Invitez l’adresse e-mail du compte de service
Choisissez le Développeur rôle
Puis cliquez sur **Inviter**.
Envoyez l’invitation
{% endstep %}
{% step %}
**Complétez les informations de l’établissement**
1. Cliquez sur **Détails de l’établissement** et vérifiez que toutes les informations sont renseignées et approuvées.
Confirmez que les détails de l’établissement sont approuvés
2. Cliquez sur **API Google Wallet**.
Copiez le issuerId
Notez le `issuerId`. Il est nécessaire dans la console d’administration The Wallet Crew.
{% endstep %}
{% endstepper %}
## Configurez The Wallet Crew
Pour une configuration autonome, retournez dans la console d’administration The Wallet Crew et ouvrez Wallet > Configuration > Google.
Remplissez le formulaire avec :
* la clé JSON du compte de service téléchargée précédemment
* le `issuerId` de Google Pay & Wallet Console
Collez issuerId et téléversez la clé JSON
#### Demander l’accès public (uniquement si nécessaire)
Si les tests avec une Carte Google produisent l’erreur suivante :
Erreur lorsque l’accès public est requis
Retournez à l’API Google Wallet :
Demander l’accès public à Google
Demandez ensuite l’accès public. Un de ces modèles peut être utilisé.
Modèle d’e-mail — utilisation de carte de fidélité
> Bonjour,
>
> Nous souhaiterions 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 portefeuille.
>
> Nous travaillons avec The Wallet Crew pour cela.
>
> Cordialement,
Modèle d’e-mail — utilisation pour un événement
> Bonjour,
>
> Nous souhaiterions utiliser l’API Google Wallet pour générer des billets d’événement. Le client recevra un e-mail contenant un lien de téléchargement et ajoutera ses billets à son portefeuille. 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 l’accès à l’émetteur manuellement. Prévoyez **3 à 5 jours ouvrables** 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 ?
Deux éléments sont nécessaires : une **clé JSON du compte de service** de Google Cloud (compte de service → **Clés**) et **`issuerId`** de **Google Pay & Wallet Console** (section API Google Wallet). Une fois ceux-ci collés ou téléversés dans Wallet > Configuration > Google, The Wallet Crew peut s’authentifier et émettre des cartes sous l’émetteur de la marque.
Avons-nous besoin d’un projet Google Cloud dédié ?
Oui. Un projet dédié isole la configuration du portefeuille des autres charges de travail cloud. Il facilite aussi beaucoup 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 à l’API.
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 un gestionnaire de secrets (ou supprimez-la si aucune copie n’est nécessaire). Évitez de la partager par chat ou par e-mail, et faites-la pivoter immédiatement si elle est exposée.
Pourquoi devons-nous inviter un utilisateur/compte de service dans Google Pay & Wallet Console ?
Google Pay & Wallet Console contrôle qui peut gérer l’é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 le projet Cloud. Sans cela, les requêtes échoueront avec des erreurs d’autorisation telles que « API non activée ».
Nous obtenons une erreur demandant un « accès public ». Que signifie-t-elle ?
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 lors du passage des tests à la distribution réelle. Utilisez les modèles d’e-mail de ce guide pour demander l’accès public à Google.
Pouvons-nous révoquer l’accès délégué après la mise en production ?
**Oui**. Une fois l’émission et les mises à jour des cartes validées de bout en bout, révoquez l’accès délégué aux deux endroits : supprimez The Wallet Crew du **Google Cloud** IAM du projet, et supprimez l’utilisateur de la **Google Pay & Wallet Console** liste des utilisateurs. Faites-le uniquement après que de vrais enregistrements et au moins une mise à jour réussie ont été effectués, afin que la production ne soit pas cassée par inadvertance.
Faut-il renouveler la configuration chaque année ?
En général **non**. Cette configuration n’a pas vocation à être « renouvelée » selon un calendrier.
Ne refaites la configuration dans The Wallet Crew que si quelque chose a changé du côté de Google, par exemple :
* La clé JSON du compte de service a été **renouvelée ou remplacée**.
* La clé a été **révoquée/désactivée**, ou l’on soupçonne qu’elle a été exposée.
* La configuration a basculé vers un **autre projet Cloud** 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 continuent d’être émises/mises à jour correctement, ne touchez à rien.
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 « reconfiguration » normale.
Chez Google, les cartes sont liées à un **compte émetteur Google Pay & Wallet Console**. Les cartes en production ne peuvent pas être transférées 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](/configure/fr/advanced-configuration/wallet/import-and-export/pass-migration/move-passes-to-the-wallet-crew.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/apple-and-google-wallet/google-wallet-account.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
