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.
2. Configuration de la console Google Pay & Wallet
Pour émettre nativement des cartes Google Wallet :
-
1
Compte émetteur (Issuer Account) : Demandez un compte émetteur dans la console Google Pay & Wallet.
-
2
Compte de service (Service Account) : Créez un compte de service Google Cloud, attribuez-lui les droits
Google Wallet API Developeret téléchargez la clé privée RSA au format JSON. -
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 :
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.

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 :
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 :
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);

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.





