Skip to content
Hilfecenter-Anleitung · Zertifikate & ZugangsdatenOnboarding-Phase 2
3 Min. LesezeitGeprüft 2026-11-16

Google Wallet-Konfiguration

Verstehen Sie verwaltete vs. eigene Google Wallet Issuer IDs und Android-Feldüberschreibungen im visuellen Editor.

In dieser Anleitung

Prüfen Sie passende Dashboard-Bereiche, Steuerelemente und Zoom-Hinweise zu diesem Thema.

Vergrößerter UI-Fokus
Wichtige UI-Elemente

Template-Editor — Passtyp & Layout-Variante (Zoom)

Zugrunde liegende Pass-Struktur (Coupon, Store-/Treuekarte, Event-Ticket, Generic Pass, Bordkarte) und Layout-Variante wählen.

Überblick: Verwaltete vs. eigene Google-Wallet-Issuer-Einrichtung

Anders als bei Apple Wallets zertifikatspflichtigem Modell pro Händler stellt Passinstance out of the box eine verwaltete Google-Wallet-Issuer-Infrastruktur bereit, sodass Sie Android-Pässe sofort ab dem Onboarding veröffentlichen und verteilen können (PUT /api/v1/onboarding/wallet-setup). Für Enterprise-Marken, die eine eigene Google Pay & Wallet Console Issuer ID oder eigene kontaktlose Google-Smart-Tap-Schlüssel führen möchten, unterstützt Passinstance zudem die Anbindung eines dedizierten Google-Cloud-Dienstkontos (POST /api/v1/google-wallet/setup).

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
GOOGLE-WALLET-ISSUER- & DIENSTKONTO-EINRICHTUNG
STUFE 01 OPTION A: VERWALTETER PASSINSTANCE-ISSUER (STANDARD)
Keine eigene Google-Cloud-Einrichtung nötig
Automatisch während des Onboardings aktiviert (PUT/api/v1/onboarding/wallet-setup)
Passinstance signiert Save-JWTs & steuert walletobjects-REST-Aufrufe selbst
STUFE 02 OPTION B: EIGENE ENTERPRISE-ISSUER-KONFIGURATION
1
Google Pay & Wallet Console (pay.google.com/business/console)
19-stellige numerische issuerId kopieren (z. B. 3388000000022194812)
Smart-Tap-collectorId einrichten (für kontaktlose NFC-Einlösung)
2
Google Cloud Console (console.cloud.google.com)
„Google Wallet API“ (walletobjects.googleapis.com) aktivieren
Dienstkonto anlegen & JSON-Schlüssel exportieren (private_key, client_email)
3
Dienstkonto in Google Pay & Wallet Console autorisieren
client_email mit Rolle Developer / Admin einladen
4
In Passinstance bereitstellen (POST/api/v1/google-wallet/setup)
Verschlüsselt JSON-Key im encrypted storage & prüft API-Konnektivität

Voraussetzungen: Wenn Sie eine eigene Google Wallet Issuer ID konfigurieren, müssen Sie die client_email Ihres Google-Cloud-Dienstkontos in der Google Pay & Wallet Business Console -> Benutzer mit der Rolle Developer einladen. Ohne diese IAM-Verknüpfung liefert Googles walletobjects-API den Fehler 403 Forbidden, sobald Passinstance Classes oder Objects anlegen möchte.

Vergleich: Verwalteter vs. eigener Google-Issuer-Modus

FunktionVerwalteter Passinstance-IssuerEigene Enterprise Issuer ID
EinrichtungszeitSofort (0 Minuten)Ca. 15 Minuten (Google Cloud + Business Console)
Markenname & Logo auf der KartePro Vorlage frei anpassbar (issuerName, programLogo)Pro Vorlage frei anpassbar (issuerName, programLogo)
Zugriff auf Google Pay & Wallet ConsoleVon Passinstance verwaltetDirekter Zugriff auf Ihre eigene Google Business Console
Google Smart Tap NFC (NFC_SMART_TAP)Nutzt Workspace-/Reader-KonfigurationUnterstützt Ihre eigene smartTapMerchantId & collectorId
Callback-Webhook (/api/v1/wallet/callback)Automatisch vorkonfiguriertBei Klassenerstellung automatisch konfiguriert

Google-Wallet-Einrichtungs- & Vorlagen-Aktivierungs-API (Google Wallet Setup API)

Alle Endpunkte zur Google-Wallet-Issuer- und Vorlagenbereitstellung befinden sich unter /api/v1/google-wallet:

MethodeEndpunkt-PfadErforderliche BerechtigungBeschreibung
POST/api/v1/google-wallet/setupwallet:manage, certificates:manageRichtet ein Google-Wallet-Issuer-Konto und optional eine Smart-Tap-Collector-ID anhand Ihrer Workspace-Firmendaten ein.
GET/api/v1/google-wallet/statuswallet:read / wallet:manageLiefert { isConfigured, collectorId } und zeigt an, ob Google Wallet und Smart Tap eingerichtet sind.
POST/api/v1/google-wallet/repair-callbackswallet:manage, certificates:manageSynchronisiert fehlende /api/v1/wallet/callback-Webhook-URLs auf veröffentlichten Google-Wallet-Klassen neu.
POST/api/v1/google-wallet/templates/:templateId/activatewallet:manage, certificates:manageAktiviert die Google-Wallet-Klassenbereitstellung für eine bestimmte Vorlage.
POST/api/v1/google-wallet/templates/:templateId/deactivatewallet:manage, certificates:manageDeaktiviert die Google-Wallet-Unterstützung für eine bestimmte Vorlage.
GET/api/v1/google-wallet/templates/:templateId/statuswallet:manage, certificates:readGibt { isEnabled, issuerId } für die Zielvorlage zurück.

Beispiel: Einrichtung des Google-Wallet-Issuers anstoßen

BASH
POST /api/v1/google-wallet/setup
X-API-Key: <API_KEY>

Antwort (201 Created):

JSON
{
  "issuerId": "3388000000022194812",
  "googlePayAccount": {
    "accountIdentifier": "3388000000022194812",
    "collectorId": "50992104"
  },
  "smartTapMerchantData": {
    "smartTapMerchantId": "50992104"
  }
}

Eine anschließende Statusabfrage über GET /api/v1/google-wallet/status liefert { "isConfigured": true, "collectorId": "50992104" }, und einzelne Pässe weisen das Feld googleWalletTypeSource (Google Wallet source type: INITIAL_CREATION | MIGRATION | MANUAL_REGENERATION) aus.

Best Practices bei der Vorlageneinrichtung

  1. 1
    Passende Google-Pass-Kategorie wählen: Ordnen Sie Ihr Programm unter Vorlage bearbeiten -> Pass-Typen passend zu Loyalty (LoyaltyClass), Offer (OfferClass), Geschenkkarte (GiftCardClass), Event-Ticket (EventTicketClass) oder Generischer Pass (GenericClass) zu — Google-Wallet-Klassen können ihren Ressourcentyp nach der Veröffentlichung nicht mehr ändern.
  2. 2
    Android-Vorschau gezielt testen: Wechseln Sie im Live-Vorschaupanel zwischen Apple Wallet und Google Wallet, da sich Bildseitenverhältnisse (breites Hero-Banner androidBackground vs. quadratischer Zuschnitt googlePayLogo) und Feldkürzungsregeln zwischen den Plattformen unterscheiden.
  3. 3
    Android Overrides nutzen: Hinterlegen Sie im Inspektor angepasste Android-Feldbeschriftungen und -Werte, wenn ein Apple-Layout-Slot unter Android nicht 1:1 abgebildet wird.

Weitere Informationen zu Klassen/Objekten und NFC-Spezifikationen finden Sie unter Google Wallet und Google Smart Tap.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.