Google Wallet bietet Android-Nutzerinnen und -Nutzern eine vorinstallierte, zentrale Anwendung zur Verwaltung digitaler Treuekarten, Eintrittskarten, Gutscheine, Geschenkkarten, Bordkarten und Mitgliedsausweise.
Dieser Leitfaden erläutert die Architektur der Google Wallet API, Aussteller-Zugangsdaten, das Verhältnis zwischen Class und Object, signierte JWT-Speicherlinks sowie Aktualisierungen per REST-API auf Android-Geräten.
1. Google Wallet-Architektur: Classes vs. Objects
Anders als das einzelne .pkpass-Archiv bei Apple Wallet trennt Google Wallet Passdaten strikt in eine Class (Vorlage) und ein Object (konkrete Karte):
-
Pass Class: Definiert übergeordnete Layout-Eigenschaften, Markenbilder, Logo, Primärfarbe, Ausstellernamen und allgemeine Programmregeln für alle Teilnehmenden.
-
Pass Object: Speichert benutzerspezifische Werte wie Namen, individuelle Serien- und Barcodenummern, aktuellen Punktestand und Ablaufdatum.
2. Einrichtung in der Google Wallet-Konsole
Für die native Ausgabe von Google Wallet-Pässen sind folgende Schritte nötig:
-
1
Issuer-Konto: Beantragen Sie ein Aussteller-Konto in der Google Wallet-Konsole.
-
2
Service-Account-Schlüssel: Erstellen Sie in Google Cloud ein Dienstkonto mit der Berechtigung
Google Wallet API Developerund laden Sie den RSA-Schlüssel als JSON herunter. -
3
Class veröffentlichen: Legen Sie über die Google Wallet REST-API eine Pass-Klasse (z. B.
issuerId.loyalty_class_2026) an.
[!NOTE]
Schneller Einstieg über Passinstance: Passinstance betreibt eine freigeschaltete Google Wallet-Ausstelleranbindung, sodass Sie Google Wallet-Pässe direkt aus dem Dashboard oder per API ausgeben können.
3. Signierte JWT-Links für „Zu Google Wallet hinzufügen“ erzeugen
Google Wallet-Pässe werden über kryptografisch signierte JSON Web Tokens (JWT) innerhalb regulärer HTTPS-Links verteilt:
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}`;
Tippt eine Android-Kundin oder ein Kunde auf diesen Link bzw. scannt den QR-Code, prüft Google Wallet die JWT-Signatur und speichert den Pass direkt auf dem Gerät.

4. Over-the-Air-Updates über die Google Wallet REST-API
Sammeln Kundinnen und Kunden Punkte oder lösen eine Prämie ein, aktualisieren Sie den gespeicherten Pass über eine PATCH-Anfrage an die Google Wallet REST-API:
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": "Punkte",
"balance": {
"int": 1500
}
}
}
Googles Backend synchronisiert die Änderung mit dem Android-Gerät und spielt unterstützte Aktualisierungshinweise in der Systembenachrichtigung aus.
5. Automatisierte Google Wallet-Ausgabe mit Passinstance
Passinstance bündelt Apple Wallet und Google Wallet hinter einer gemeinsamen API und einem visuellen Editor:
import { Passinstance } from "@passinstance/sdk";
const client = new Passinstance({ apiKey: process.env.PASSINSTANCE_API_KEY });
// Pass für Apple Wallet und Google Wallet aus einer Vorlage erstellen
const pass = await client.passes.create({
templateId: "tpl_retail_rewards",
data: {
customerName: "Jane Doe",
points: 1500,
},
});
console.log("Link für Google Wallet:", pass.googleWalletUrl);
Wichtigste Vorteile
-
Keine eigene Android-App nötig: Kundinnen und Kunden tippen auf einen Weblink oder scannen einen QR-Code.
-
Einheitliche Vorlage: Ein zentrales Design erzeugt konsistente Ausgaben für Android und iOS.
-
Laufende Over-the-Air-Updates: Punktestände und unterstützte Statushinweise werden zentral über die API aktualisiert.






