Skip to content
Retour au blog

Créer un pass Google Wallet : Guide d'intégration complet

Google Wallet API, tokens JWT signés, classes et objets de pass génériques.

Passinstance Team
Passinstance Team

Wallet pass platform team

2026-08-163 min de lecture
Image de couverture pour Créer un pass Google Wallet : Guide d'intégration complet

Google Wallet offre aux utilisateurs Android un espace natif et préinstallé pour conserver leurs cartes de fidélité numériques, billets d'événement, offres, cartes cadeaux, cartes d'embarquement et cartes de membre.

Ce guide complet détaille l'architecture de l'API Google Wallet, les identifiants émetteur, la relation entre Class et Object, les liens de sauvegarde JWT signés et les mises à jour à distance sur Android.


1. Architecture Google Wallet : Classes vs Objects

Contrairement au fichier unique .pkpass d'Apple Wallet, Google Wallet sépare les données d'une carte entre une Class et un Object :

  • Pass Class : Définit les propriétés générales de mise en page, les visuels de marque, le logo, la couleur principale, le nom de l'émetteur et les conditions partagées par tous les utilisateurs.
  • Pass Object : Définit l'état propre à un utilisateur : nom du client, numéro de série ou code-barres individuel, solde de points actuel et date d'expiration.
FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX ARCHITECTURE SYSTÈME
ÉTAPE 01 Google Wallet Class (Modèle maître)
ÉTAPE 02A User Object A (Jane Doe • 1 250 Points)
ÉTAPE 02B User Object B (John Smith • 500 Points)
ÉTAPE 02C User Object C (Alex Morgan • Niveau Or)

2. Configuration de la console Google Pay & Wallet

Pour émettre nativement des cartes Google Wallet :

  1. 1
    Compte émetteur (Issuer Account) : Demandez un compte émetteur dans la console Google Pay & Wallet.
  2. 2
    Compte de service (Service Account) : Créez un compte de service Google Cloud, attribuez-lui les droits Google Wallet API Developer et téléchargez la clé privée RSA au format JSON.
  3. 3
    Définition de la Class : Publiez une Pass Class (ex. issuerId.loyalty_class_2026) via l'API REST Google Wallet.

[!NOTE]

Démarrage rapide : Passinstance dispose d'un statut d'émetteur vérifié sur Google Wallet, vous permettant de tester et lancer des cartes Google Wallet sans attendre plusieurs semaines de validation manuelle.


3. Générer des liens JWT signés « Ajouter à Google Wallet »

Les cartes Google Wallet sont distribuées à l'aide de JSON Web Tokens (JWT) signés cryptographiquement et intégrés dans une URL HTTPS standard :

TS
import jwt from "jsonwebtoken";

const claims = {
  iss: serviceAccount.client_email,
  aud: "google",
  typ: "savetowallet",
  iat: Math.floor(Date.now() / 1000),
  payload: {
    loyaltyObjects: [
      {
        id: "338810294.user_pass_jane_2048",
        classId: "338810294.loyalty_class_v1",
        state: "ACTIVE",
        accountName: "Jane Doe",
        accountId: "MEM-2048",
        barcode: {
          type: "QR_CODE",
          value: "PASS-LOYALTY-8842",
        },
      },
    ],
  },
};

const token = jwt.sign(claims, serviceAccount.private_key, { algorithm: "RS256" });
const saveUrl = `https://pay.google.com/gp/v/save/${token}`;

Lorsqu'un client Android clique sur ce lien ou scanne un QR code, Google Wallet vérifie la signature JWT et ajoute directement la carte sur son appareil.


Inspecteur de champs — Liez des variables comme {storedValue} avec un remplacement spécifique Android
Inspecteur de champs — Liez des variables comme {storedValue} avec un remplacement spécifique Android

4. Mises à jour à distance via l'API REST Google Wallet

Lorsqu'un client gagne des points ou utilise une récompense, mettez à jour sa carte sur Android en envoyant une requête PATCH à l'API REST Google Wallet :

HTTP
PATCH /walletobjects/v1/loyaltyObject/338810294.user_pass_jane_2048 HTTP/1.1
Host: walletobjects.googleapis.com
Authorization: Bearer <OAuth2_Token>
Content-Type: application/json

{
  "loyaltyPoints": {
    "label": "Points",
    "balance": {
      "int": 1500
    }
  }
}

L'infrastructure Google actualise la carte sur l'appareil Android et déclenche une notification système lorsque les règles de plateforme s'appliquent.


5. Émission Google Wallet automatisée avec Passinstance

Passinstance unifie Apple Wallet et Google Wallet derrière un seul appel API et une interface visuelle unique :

TS
import { Passinstance } from "@passinstance/sdk";

const client = new Passinstance({ apiKey: process.env.PASSINSTANCE_API_KEY });

// Publier une carte pour Apple Wallet et Google Wallet depuis un seul modèle
const pass = await client.passes.create({
  templateId: "tpl_retail_rewards",
  data: {
    customerName: "Jane Doe",
    points: 1500,
  },
});

console.log("Lien Ajouter à Google Wallet :", pass.googleWalletUrl);
Aperçu en direct double portefeuille — Basculez entre Apple Wallet et Google Wallet
Aperçu en direct double portefeuille — Basculez entre Apple Wallet et Google Wallet

Points clés à retenir

  • Aucune application Android requise : Les clients cliquent sur un lien web ou scannent un QR code pour enregistrer la carte dans Google Wallet.
  • Modèle unifié : Maintenez un seul design générant proprement les formats Android et iOS.
  • Mises à jour à distance : Actualisez soldes de points et informations de programme sur les cartes enregistrées.
Démo interactive en direct
Apple Wallet & Google Wallet

Testez une vraie carte Wallet sur votre téléphone

Découvrez le fonctionnement des cartes digitales en direct. Scannez avec votre téléphone ou appuyez ci-dessous pour ajouter ce pass dans Apple Wallet ou Google Wallet.

Artisan RoastersCafé & F&B
Test QR code for Artisan Roasters

Scannez avec l'appareil photo

Lié à ce sujet

API pour développeurs et intégrations

Centre de sujets ouvert

Prêt à lancer votre programme de carte de portefeuille ?

Créez votre compte, concevez votre modèle de carte et testez de vrais carte directement dans Apple Wallet et Google Wallet.