# Compte Google Wallet

Configurez votre intégration Google Wallet en utilisant soit l'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 de compte, l'activation des API et la gestion des identifiants pour déployer des cartes numériques via la plateforme The Wallet Crew.

## Aperçu

Pour distribuer des cartes numériques via Google Wallet, votre organisation doit obtenir l'approbation d'un compte émetteur Google Pay & Wallet Console et configurer un projet Google Cloud pour l'accès à l'API. Google approuve les émetteurs manuellement, prévoyez **3–5 jours ouvrables** pour l'approbation, plus **15–60 minutes** pour la configuration technique.

**Principales choses à configurer**

* Un compte émetteur 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éguez soit la configuration restante à The Wallet Crew, soit vous la complétez vous-même et collez les valeurs requises dans The Wallet Crew.

Vous voulez le « pourquoi » avant le « comment » ? Commencez par [Apple & Google wallet](https://docs.thewalletcrew.io/fr/configurer/wallet/apple-and-google-wallet).

#### Prérequis

* Compte Google Workspace ou Gmail avec privilèges d'administrateur
* Informations sur l'entreprise pour la vérification commerçant 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`. Ce nommage aide à identifier la finalité du projet en un coup d'œil.

### Délégation de compte

Cette approche permet à l'équipe The Wallet Crew de gérer la configuration technique tout en conservant 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 **Grant Access** 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 des 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="https://content.gitbook.com/content/WLc8AHXW4tdrAXUBfrYF/blobs/9v5gMI3vDtDtEW3XeMAV/inline" 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>

De cette façon, 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 vos soins

Vous gérez l'intégralité de la configuration au sein de 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 de support vous contactera pour valider votre cas d'utilisation et activer votre compte émetteur.

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

1. Allez à la page Credentials.

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

2. Assurez-vous que le projet en cours est `thewalletcrew-<brandName>`
3. Cliquez **Create credentials → Service account**.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FrrIrZQ5GzjAWQLCLMXEu%2Finline%20(96).png?alt=media&#x26;token=f337119e-6908-4529-91f8-b2a3fece2d56" 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`
* Identifiant du compte de service : conservez la valeur générée automatiquement

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FyhIhubyNRMdlsPMw207F%2Finline%20(97).png?alt=media&#x26;token=2f275359-9504-4e56-b59c-8955c77ec95e" 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 **Terminé** pour finaliser 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 allez à l'onglet **Keys** .

<div><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FRl2PJBpZWGkOSOCP9Dr8%2Finline%20(98).png?alt=media&#x26;token=7ab40655-a9c9-4ced-af57-6bbb2bbce0b4" alt="Google Cloud service account: Keys tab"><figcaption><p>Ouvrir l'onglet Keys</p></figcaption></figure> <figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FbAsQpACMmFDECzCnPuEP%2Finline%20(99).png?alt=media&#x26;token=9a8d1ba7-fd9e-4fdc-89f6-926bb24d9c97" 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 **Add key → Create new key**.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FOt03ubk9VRrn5RzGkY1d%2Finline%20(100).png?alt=media&#x26;token=04e5a7ed-f22f-4dc1-b89b-3082e54c67cf" 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 **Create**.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FhIN0IpJUVRWXIOhaFsoG%2Finline%20(101).png?alt=media&#x26;token=3441f394-e1a4-4c3d-9399-8658036d382c" 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**

Allez sur la page Google Wallet API 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">Google Wallet API</a></p>

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FkVPqBWEAnVKsMCAaBtHK%2Finline%20(102).png?alt=media&#x26;token=691c3572-cf6d-4a7a-99aa-20ff7834abac" 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 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 **Edit** permission. Cela permet à l'équipe The Wallet Crew de configurer vos paramètres d'émetteur et de compléter l'intégration.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/WLc8AHXW4tdrAXUBfrYF/blobs/MAUjv9wmfWjCeo4Fl6Wt/inline" alt="Google Pay &#x26; Wallet Console Users page showing user access management" width="375"><figcaption><p>Ajouter un utilisateur avec <strong>Edit</strong> accès</p></figcaption></figure></div>

L'équipe The Wallet Crew recevra une notification de votre octroi d'accès et procédera à 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 vous fournirons vos identifiants pour conservation en lieu sûr.

### Configuration par vos soins

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

1. Accédez à la section Utilisateurs.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FJYPRC7tKa9c3PwOASIC2%2Finline%20(103).png?alt=media&#x26;token=e3538846-c593-4882-8831-89a1d91314fc" alt="Google Pay &#x26; Wallet Console navigation highlighting Users" width="375"><figcaption><p>Ouvrir la section Utilisateurs</p></figcaption></figure></div>

2. Cliquez **Inviter un utilisateur**.

Remplissez le formulaire avec les informations suivantes :

* Adresse e-mail : celle notée à l'étape 1.4
* Niveau d'accès : **Developer**

<div><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FdvOqVrCJn6cOrgrsk5JQ%2Finline%20(104).png?alt=media&#x26;token=e5861eeb-f043-41e4-8194-81dadccd630c" alt="Google Pay &#x26; Wallet Console: Invite a user dialog"><figcaption><p>Inviter l'e-mail du compte de service</p></figcaption></figure> <figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fe5IpL6YmzTX33AAmFo2i%2Finline%20(105).png?alt=media&#x26;token=7b3828d2-faa5-4686-9626-abb34e64f1a1" alt="Google Pay &#x26; Wallet Console: select Developer access level"><figcaption><p>Choisissez le <strong>Developer</strong> rôle</p></figcaption></figure></div>

Puis cliquez sur **Invite**.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fj2q0GBjAGYp7EiEAD1Dl%2Finline%20(106).png?alt=media&#x26;token=7b825de5-6caa-422c-a194-f2bfd7d7846f" 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 d'établissement**

1. Cliquez **Détails de l'établissement** et vérifiez que toutes les informations sont remplies et approuvées.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FUpG9OK1ZK0zmcotjdTdY%2Finline%20(107).png?alt=media&#x26;token=5cd50980-8b32-40da-85c6-160c4de6ec6b" 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 **Google Wallet API**.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FguRENSDB3bGAavM5l4Rr%2Fimage.png?alt=media&#x26;token=fcadaf8c-56a6-47ef-b6d0-57bb08cb7dae" 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, retournez à 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 la Google Pay & Wallet Console

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FnoVix6VKGHjqFpKeyPzV%2Finline%20(110).png?alt=media&#x26;token=375c59d8-d38f-41a4-bf48-4e85b401b78d" 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 des tests avec une carte Google vous obtenez l'erreur suivante :

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fi7jnhzYCLs4VJzUlydZU%2Finline%20(111).png?alt=media&#x26;token=3eef0b09-95b2-4bee-b04c-b20f9eabeeea" alt="Google Wallet error message asking to request public access" width="297"><figcaption><p>Erreur lorsqu'un accès public est requis</p></figcaption></figure></div>

Retournez à Google Wallet API :

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F5Bho46VDYdL1OIwFhNIq%2Finline%20(112).png?alt=media&#x26;token=11ba3f29-fb68-4ec9-9e92-1bb1ad494d36" 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>

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

<details>

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

> Bonjour,
>
> Nous souhaitons 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 événement</strong></summary>

> Bonjour,
>
> Nous souhaitons 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 « Add to Wallet » sur notre site 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 l'accès émetteur manuellement. Prévoyez **3–5 jours ouvrables** pour l'approbation. Ensuite 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 choses : une **clé JSON du compte de service** depuis Google Cloud (compte de service → **Keys** ) et votre **`issuerId`** depuis la **Google Pay & Wallet Console** (section Google Wallet API). Une fois que vous collez/téléversez 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é maintient la configuration wallet isolée des autres charges de travail cloud. Il facilite également 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 serveur-à-serveur. Ce n'est pas un utilisateur humain. The Wallet Crew utilise la clé JSON du compte de service pour authentifier ces appels 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 dans The Wallet Crew via la console d'administration, puis conservez-la uniquement dans votre gestionnaire de secrets (ou supprimez-la si vous n'avez pas besoin d'en garder une copie). Évitez de la partager via chat ou e-mail, et faites une rotation 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>

La 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 autogérée, invitez le **service account** en tant qu'utilisateur avec le **Developer** 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 recevons une erreur demandant « public access ». Que signifie-t-elle ?</strong></summary>

Certains émetteurs ont besoin d'une étape d'approbation supplémentaire de Google avant de pouvoir distribuer des cartes de manière large. Cela apparaît souvent lorsque vous passez des tests à la 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 production ?</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 l'IAM du projet **Google Cloud** , et retirez l'utilisateur de la liste **Google Pay & Wallet Console** Users. Ne faites cela qu'après avoir effectué des enregistrements réels et au moins une mise à jour réussie, afin de ne pas interrompre accidentellement la production.

</details>

<details>

<summary><strong>Devons-nous 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.

Refaites la configuration dans The Wallet Crew uniquement 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 soupçonnez qu'elle a été exposée.
* Vous êtes passé à un **projet Cloud différent** ou **issuerId**.
* Les permissions 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 à 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 actives, pas 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 actives vers un émetteur différent. 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é : [Move passes to The Wallet Crew](https://docs.thewalletcrew.io/fr/configurer/wallet/import-and-export/move-pass-from-and-to-the-wallet-crew/move-passes-to-the-wallet-crew).

</details>