Skip to content
Zurück zum Blog

Google Wallet Pass erstellen: Kompletter Integrationsleitfaden

Google Wallet API für Pässe, JWT-Speicherlinks, Pass-Klassen und Cloud-Objekt-Verwaltung auf Android.

Passinstance Team
Passinstance Team

Wallet pass platform team

2026-08-162 Min. Lesezeit
Titelbild für Google Wallet Pass erstellen: Kompletter Integrationsleitfaden

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.
SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
SYSTEMARCHITEKTUR-ABLAUF
STUFE 01 Google Wallet Class (Master-Vorlage)
STUFE 02A Nutzer-Objekt A (Jane Doe • 1.250 Punkte)
STUFE 02B Nutzer-Objekt B (John Smith • 500 Punkte)
STUFE 02C Nutzer-Objekt C (Alex Morgan • Gold-Status)

2. Einrichtung in der Google Wallet-Konsole

Für die native Ausgabe von Google Wallet-Pässen sind folgende Schritte nötig:

  1. 1
    Issuer-Konto: Beantragen Sie ein Aussteller-Konto in der Google Wallet-Konsole.
  2. 2
    Service-Account-Schlüssel: Erstellen Sie in Google Cloud ein Dienstkonto mit der Berechtigung Google Wallet API Developer und laden Sie den RSA-Schlüssel als JSON herunter.
  3. 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.


Google Wallet-Pässe werden über kryptografisch signierte JSON Web Tokens (JWT) innerhalb regulärer HTTPS-Links verteilt:

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}`;

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.


Passinstance Feld-Inspektor — Gemeinsame Variablen wie {storedValue} mit optionalem Android-Override verknüpfen
Passinstance Feld-Inspektor — Gemeinsame Variablen wie {storedValue} mit optionalem Android-Override verknüpfen

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:

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": "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:

TS
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.
Dual-Wallet-Live-Vorschau — Nahtlos zwischen Apple Wallet und Google Wallet wechseln
Dual-Wallet-Live-Vorschau — Nahtlos zwischen Apple Wallet und Google Wallet wechseln
Interaktive Live-Demo
Apple Wallet & Google Wallet

Echten Wallet-Pass auf Ihrem Smartphone testen

Erleben Sie digitale Pässe aus erster Hand. Scannen Sie mit Ihrer Smartphone-Kamera oder tippen Sie unten, um diesen Pass direkt zu Apple Wallet oder Google Wallet hinzuzufügen.

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

Mit Smartphone-Kamera scannen

Verwandte Themen zu diesem Thema

Entwickler-API & Integrationen

Themen-Hub öffnen

Bereit, Ihr Wallet-Karten-Programm zu starten?

Erstellen Sie Ihr Konto, gestalten Sie Ihre Kartenvorlage und testen Sie echte Karten direkt in Apple Wallet und Google Wallet.