> 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 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](/configure/fr/advanced-configuration/wallet/apple-and-google-wallet.md).

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

<p align="center"><a href="https://console.cloud.google.com/iam-admin/" class="button secondary" data-icon="chevrons-right">Console Google Cloud</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 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 `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 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](https://support.google.com/pay/merchants/contact/instore_merchants). Après avoir soumis le formulaire, l'équipe d'assistance vous contactera pour valider votre cas d'utilisation 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. Vérifiez 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 la 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 accédez à l'onglet **Clés** onglet.

<div><figure><img src="/files/2e773c1526398050f11476fafba66a8d1cf030e5" alt="Google Cloud service account: Keys tab"><figcaption><p>Ouvrez 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éez 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>Commencez à créer 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électionnez 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**

Rendez-vous sur 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 à la 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 Utilisateurs. Ajoutez `contact@neostore.cloud` avec **Administrateur** 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>Administrateur</strong> accès</p></figcaption></figure></div>

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

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

1. Accédez à la section Utilisateurs.

<div data-with-frame="true"><figure><img src="/files/f21e3fb30db7fcdb04628ef0445c87dbe5ffe02a" alt="Google Pay &#x26; Wallet Console navigation highlighting Users" width="375"><figcaption><p>Ouvrez la section Utilisateurs</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>Invitez 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>Envoyez 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>Confirmez 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 %}

## Configurez The Wallet Crew

Si vous configurez vous-même, retournez dans 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` provenant de la 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 un 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>

Revenez à l'API Google Wallet :

<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 un accès public à Google</p></figcaption></figure></div>

Ensuite, demandez un accès public. Vous pouvez utiliser l'un de ces modèles.

<details>

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

> 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,

</details>

<details>

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

> 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,

</details>

## FAQ

<details>

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

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

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

</details>

<details>

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

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.

</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 à 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.

</details>

<details>

<summary><strong>Pourquoi devons-nous inviter un utilisateur/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 not enabled ».

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

</details>

<details>

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

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

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

</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 ».

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](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-and-google-wallet/google-wallet-account.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.