> 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-wallet-et-google-wallet/compte-google-wallet.md).

# Compte Google Wallet

Configurez votre intégration Google Wallet en utilisant soit un accès délégué (recommandé pour une mise en place 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 Wallet numériques via la plateforme The Wallet Crew.

## Aperçu

Pour distribuer des Cartes Wallet 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 aux API. Google approuve les émetteurs manuellement, alors prévoyez **3 à 5 jours ouvrables** 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 allez créer les services Google principaux sous votre marque (projet Google Cloud + approbation Google Pay & Wallet Console). Ensuite, vous déléguerez soit le reste de la configuration à The Wallet Crew, soit vous la terminerez vous-même et collerez les valeurs requises dans The Wallet Crew.

Vous voulez le « pourquoi » avant le « comment » ? Commencez par [Apple & Google wallet](broken://pages/4666a9c896025b09466ca03283cb4db2f3f6112b).

#### 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 Google Cloud Console et connectez-vous avec le compte Google de votre entreprise.

<p align="center"><a href="https://console.cloud.google.com/iam-admin/" class="button secondary" data-icon="chevrons-right">Google Cloud Console</a></p>

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 la finalité 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 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. Vous pouvez révoquer cet accès une fois la configuration initiale terminée.

<div data-with-frame="true"><figure><img src="/files/5cf0d0dd2e1e984bd02d15ebd60af72b68fa26d5" alt="Google Cloud IAM page showing the Grant access action" width="375"><figcaption><p>Google Cloud IAM : accorder l’accès au projet</p></figcaption></figure></div>

Ainsi, les Cartes Wallet Google 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 autonome

Vous gérez la configuration complète dans vos propres comptes Google Cloud et Google Pay.

Pour accéder à Google Pay & Wallet Console, vous devez [vous inscrire](https://support.google.com/pay/merchants/contact/instore_merchants). Après l’envoi du formulaire, l’équipe d’assistance vous contactera pour valider votre cas d’usage et activer votre compte émetteur.

{% stepper %}
{% step %}
**Créer un compte de service**

1. Accédez à la page des identifiants.

<p align="center"><a href="https://console.developers.google.com/apis/credentials" class="button secondary" data-icon="chevrons-right">Google Cloud - Page des identifiants</a></p>

2. Assurez-vous que le projet actuel est `thewalletcrew-<brandName>`
3. Cliquez sur **Créer des identifiants → Compte de service**.

<div data-with-frame="true"><figure><img src="/files/e134e872d14eacaddbe1f318dcbc36f10d564669" alt="Google Cloud: Create credentials → Service account" width="375"><figcaption><p>Créer un nouveau compte de service</p></figcaption></figure></div>

4. Remplissez le formulaire :

* Nom du compte de service : `TheWalletCrew`
* ID du compte de service : conservez la valeur générée automatiquement

<figure><img src="/files/5b6a1c7b109519068c59ed1804d6ecdd64095882" alt="Google Cloud service account details form (name and ID)" width="375"><figcaption><p>Nom et ID du compte de service</p></figcaption></figure>

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`. Vous en aurez besoin plus tard dans Google Pay & Wallet Console.
{% endstep %}

{% step %}
**Créer et télécharger une clé JSON**

1. Ouvrez le compte de service que vous venez de créer. Puis allez dans l’onglet **Clés** .

<div><figure><img src="/files/2e773c1526398050f11476fafba66a8d1cf030e5" alt="Google Cloud service account: Keys tab"><figcaption><p>Ouvrir l’onglet Clés</p></figcaption></figure> <figure><img src="/files/d73e445b2e033bf4068391932e84fa1c818b95f5" alt="Google Cloud service account keys page showing the Add key action"><figcaption><p>Créer une nouvelle clé</p></figcaption></figure></div>

2. Cliquez sur **Ajouter une clé → Créer une nouvelle clé**.

<div data-with-frame="true"><figure><img src="/files/32cc81d12884929dbc9d7263d7eb4b6925f72906" alt="Google Cloud: Add key → Create new key" width="375"><figcaption><p>Commencer la création d’une clé JSON</p></figcaption></figure></div>

3. Choisissez **JSON** et cliquez sur **Créer**.

<figure><img src="/files/a86d3474a5f7f37183112ea67b03d9a8b649c32e" alt="Google Cloud: select JSON as the key type" width="375"><figcaption><p>Sélectionner le type de clé JSON</p></figcaption></figure>

4. 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.

{% hint style="warning" %}
Traitez ce fichier JSON comme un mot de passe.
{% endhint %}
{% endstep %}

{% step %}
**Activer l’API Google Wallet**

Accédez à la page de l’API Google Wallet et activez l’accès à l’API.

<p align="center"><a href="https://console.cloud.google.com/apis/library/walletobjects.googleapis.com" class="button secondary" data-icon="chevrons-right">API Google Wallet</a></p>

<div data-with-frame="true"><figure><img src="/files/f278a83abfb85e136db3f477e1fdf6a671a2ce11" alt="Google Cloud API Library: enable Google Wallet API (walletobjects.googleapis.com)" width="375"><figcaption><p>Activer <code>walletobjects.googleapis.com</code></p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Configuration de Google Pay & Wallet Console

Accédez à Google Pay & Wallet Console et connectez-vous avec le compte Google de votre entreprise.

<p align="center"><a href="https://pay.google.com/gp/m/issuer/list" class="button secondary" data-icon="chevrons-right">Google Pay &#x26; Wallet Console</a></p>

### Délégation de compte

Accédez à la section Users. Ajoutez `contact@neostore.cloud` avec **Modifier** l’autorisation. Cela permet à l’équipe The Wallet Crew de configurer les paramètres de votre émetteur et de terminer l’intégration.

<div data-with-frame="true"><figure><img src="/files/86e46b79f7f217d15d8d15c6b1385dd7edfd7ad7" alt="Google Pay &#x26; Wallet Console Users page showing user access management" width="375"><figcaption><p>Ajoutez un utilisateur avec <strong>Modifier</strong> l’accès</p></figcaption></figure></div>

L’équipe The Wallet Crew recevra une notification de votre octroi d’accès et poursuivra avec la création du compte de service, l’activation des API et la configuration des identifiants. Nous vous informerons lorsque la configuration sera terminée et nous vous fournirons vos identifiants pour conservation.

### Configuration autonome

{% stepper %}
{% step %}
**Inviter le compte de service**

1. Accédez à la section Users.

<div data-with-frame="true"><figure><img src="/files/f21e3fb30db7fcdb04628ef0445c87dbe5ffe02a" alt="Google Pay &#x26; Wallet Console navigation highlighting Users" width="375"><figcaption><p>Ouvrir la section Users</p></figcaption></figure></div>

2. 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**

<div><figure><img src="/files/85d9bb4dd0b973c6cdf1bb76229f9189d93e639b" alt="Google Pay &#x26; Wallet Console: Invite a user dialog"><figcaption><p>Inviter l’adresse e-mail du compte de service</p></figcaption></figure> <figure><img src="/files/95fbbc6caabdf6db3c4eb389f8200412a12cb476" alt="Google Pay &#x26; Wallet Console: select Developer access level"><figcaption><p>Choisissez le <strong>Développeur</strong> rôle</p></figcaption></figure></div>

Puis cliquez sur **Inviter**.

<div data-with-frame="true"><figure><img src="/files/caf47a06a82414f803667b26e71e8833c6b2ebb3" alt="Google Pay &#x26; Wallet Console: Invite button to send the user invitation" width="375"><figcaption><p>Envoyer l’invitation</p></figcaption></figure></div>
{% endstep %}

{% step %}
**Compléter 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.

<div data-with-frame="true"><figure><img src="/files/ee5c4bdbc6b630cfce3d74a699308287dd663694" alt="Google Pay &#x26; Wallet Console: establishment details page" width="375"><figcaption><p>Confirmer que les détails de l’établissement sont approuvés</p></figcaption></figure></div>

2. Cliquez sur **API Google Wallet**.

<figure><img src="/files/fb9d470060364d4b4c6002a803b1eb915b49c946" alt="Google Pay &#x26; Wallet Console: Google Wallet API page showing the issuerId value" width="375"><figcaption><p>Copiez le <code>issuerId</code></p></figcaption></figure>

Notez le `issuerId`. Vous en aurez besoin dans la console d’administration The Wallet Crew.
{% endstep %}
{% endstepper %}

## Configurer The Wallet Crew

Si vous configurez vous-même, revenez à la console d’administration The Wallet Crew et ouvrez Wallet > Configuration > Google.

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/passTypes/configuration/google" class="button secondary" data-icon="wallet">Wallet > Configuration > Google</a></p>

Remplissez le formulaire avec :

* la clé JSON du compte de service que vous avez téléchargée précédemment
* le `issuerId` depuis Google Pay & Wallet Console

<figure><img src="/files/b14ca5fa5b3a0f2dcf25cd7ceb30b3a554f7ed3a" alt="The Wallet Crew admin console: Google Wallet configuration form for issuerId and service account JSON key"><figcaption><p>Collez <code>issuerId</code> et téléversez la clé JSON</p></figcaption></figure>

#### Demander l’accès public (uniquement si nécessaire)

Si, après un test avec une Carte Google, vous obtenez l’erreur suivante :

<div data-with-frame="true"><figure><img src="/files/6c9b9a3ccfc83183ca32690991881c38e8ed3b64" alt="Google Wallet error message asking to request public access" width="297"><figcaption><p>Erreur lorsque l’accès public est requis</p></figcaption></figure></div>

Retournez à Google Wallet API :

<div data-with-frame="true"><figure><img src="/files/e0da35739f99380ba2d24b8f19d59cc0e2900f10" alt="Google Cloud: Google Wallet API console for requesting public access" width="375"><figcaption><p>Demander l’accès public à Google</p></figcaption></figure></div>

Demandez ensuite l’accès public. Vous pouvez utiliser l’un de ces modèles.

<details>

<summary><strong>Modèle d’e-mail — utilisation de carte de fidélité</strong></summary>

> 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 récupérer son compte et ajouter une carte de fidélité à son Wallet.
>
> Nous travaillons avec The Wallet Crew pour cela.
>
> Cordialement,

</details>

<details>

<summary><strong>Modèle d’e-mail — utilisation pour un événement</strong></summary>

> Bonjour,
>
> Nous souhaiterions 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,

</details>

## FAQ

<details>

<summary><strong>Combien de temps prend l’approbation par Google ?</strong></summary>

Google approuve manuellement l’accès des émetteurs. Prévoyez **3 à 5 jours ouvrables** pour l’approbation. Puis prévoyez **15 à 60 minutes** pour la configuration technique (compte de service, activation des API et configuration de l’émetteur).

</details>

<details>

<summary><strong>Que devons-nous configurer dans la console d’administration The Wallet Crew ?</strong></summary>

Vous avez besoin de deux éléments : une **clé JSON du compte de service** de Google Cloud (compte de service → **Clés**) et votre **`issuerId`** de **Google Pay & Wallet Console** (section API Google Wallet). Une fois que vous avez collé/téléversé ces éléments dans Wallet > Configuration > Google, The Wallet Crew peut s’authentifier et émettre des cartes sous votre émetteur.

</details>

<details>

<summary><strong>Avons-nous besoin d’un projet Google Cloud dédié ?</strong></summary>

Oui. Un projet dédié isole la configuration Wallet des autres charges de travail cloud. Il facilite aussi beaucoup la revue des accès, la facturation et l’audit.

</details>

<details>

<summary><strong>À quoi sert le « compte de service » ?</strong></summary>

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.

</details>

<details>

<summary><strong>Comment devons-nous stocker la clé JSON du compte de service ?</strong></summary>

Traitez la clé JSON comme un mot de passe. Téléversez-la vers 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 immédiatement tourner si elle a été exposée.

</details>

<details>

<summary><strong>Pourquoi devons-nous inviter un utilisateur/un compte de service dans Google Pay &#x26; Wallet Console ?</strong></summary>

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.

</details>

<details>

<summary><strong>Que fait réellement « Activer l’API Google Wallet » ?</strong></summary>

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 non activée ».

</details>

<details>

<summary><strong>Nous obtenons une erreur demandant un « accès public ». Qu’est-ce que cela signifie ?</strong></summary>

Certains émetteurs ont besoin d’une étape d’approbation supplémentaire de Google avant de pouvoir distribuer largement des cartes. Cela apparaît souvent lorsque vous passez des tests à une distribution réelle. Utilisez les modèles d’e-mail de ce guide pour demander l’accès public à Google.

</details>

<details>

<summary><strong>Pouvons-nous révoquer l’accès délégué après la mise en ligne ?</strong></summary>

**Oui**. Une fois que vous avez validé que l’émission et les mises à jour des cartes fonctionnent de bout en bout, révoquez l’accès délégué aux deux endroits : retirez The Wallet Crew de votre **Google Cloud** IAM du projet, et retirez l’utilisateur de la **Google Pay & Wallet Console** liste Users. Faites-le uniquement après avoir effectué de vraies sauvegardes et au moins une mise à jour réussie, afin de ne pas casser accidentellement la production.

</details>

<details>

<summary><strong>Faut-il renouveler la configuration chaque année ?</strong></summary>

Généralement **non**. Cette configuration n’est pas quelque chose que vous « renouvelez » selon un calendrier.

Ne refaites la configuration dans The Wallet Crew que si quelque chose a changé côté Google, par exemple :

* Vous **avez fait tourner 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 **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 s’émettent/se mettent toujours à jour correctement, laissez tel quel.

</details>

<details>

<summary><strong>Nous avons déjà des cartes existantes. Comment migrer vers The Wallet Crew ?</strong></summary>

Il s’agit d’une **migration** de cartes en production, et non d’une simple « reconfiguration ».

Sur 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 transférer la configuration opérationnelle (identifiants + données des cartes) vers The Wallet Crew.

Suivez le guide dédié : [Déplacez les cartes vers The Wallet Crew](broken://pages/6b85ec1ec6de65ecc22ab84f9c3c48ae4fb30780).

</details>


---

# 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-wallet-et-google-wallet/compte-google-wallet.md?ask=<question>&goal=<endgoal>
```

`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.