Skip to content
Helpcentrum-gids · Certificaten & sleutelsOnboardingfase 2
3 min leestijdGecontroleerd 2026-11-16

Google Wallet-configuratie

Begrijp beheerde versus eigen Google Wallet Issuer ID's en Android-specifieke veldinstellingen.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Sjablooneditor — Pastype & indeling (Ingezoomd)

Kies de onderliggende passtructuur (Discount Coupon, Store / Loyalty Card, Event Ticket, Generic of Boarding Pass) en lay-outvariant.

Overzicht: beheerde vs. aangepaste Google Wallet Issuer-configuratie

In tegenstelling tot de vereiste van een eigen certificaat per handelaar bij Apple Wallet biedt Passinstance standaard een beheerde Google Wallet Issuer-infrastructuur, zodat u tijdens de onboarding direct Android-passen kunt publiceren en distribueren (PUT /api/v1/onboarding/wallet-setup). Voor enterprise-merken die eigenaar willen zijn van hun eigen Google Pay & Wallet Console Issuer ID of aangepaste contactloze Google Smart Tap-sleutels ondersteunt Passinstance ook het koppelen van een eigen Google Cloud Service Account (POST /api/v1/google-wallet/setup).

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
GOOGLE WALLET ISSUER & SERVICE ACCOUNT-CONFIGURATIE
FASE 01 OPTIE A: BEHEERDE PASSINSTANCE-ISSUER (STANDAARD)
Geen Google Cloud-configuratie vereist
Automatisch geactiveerd tijdens onboarding (PUT/api/v1/onboarding/wallet-setup)
Passinstance ondertekent Save JWT's en beheert walletobjects REST-aanroepen
FASE 02 OPTIE B: AANGEPASTE ENTERPRISE-ISSUERCONFIGURATIE
1
Google Pay & Wallet Console (pay.google.com/business/console)
Kopieer de 19-cijferige numerieke issuerId (bijv. 3388000000022194812)
Configureer Smart Tap collectorId (bij gebruik van contactloze NFC)
2
Google Cloud Console (console.cloud.google.com)
Schakel "Google Wallet API" (walletobjects.googleapis.com) in
Maak een Service Account aan en exporteer JSON-sleutel (private_key, client_email)
3
Autoriseer het Service Account in de Google Pay & Wallet Console
Nodig client_email uit met Developer- / Admin-toegang
4
Richt in binnen Passinstance (POST/api/v1/google-wallet/setup)
Versleutelt Service Account JSON in encrypted storage en verifieert API-connectiviteit

Vereisten: Wanneer u een aangepaste Google Wallet Issuer ID configureert, moet u het client_email van het Google Cloud Service Account uitnodigen in de Google Pay & Wallet Business Console -> Users met Developer-machtigingen. Zonder deze IAM-koppeling retourneert Google's walletobjects API een 403 Forbidden-fout wanneer Passinstance Classes of Objects probeert aan te maken.

Vergelijking tussen beheerde en aangepaste Google Issuer-modus

MogelijkheidBeheerde Passinstance-issuerAangepaste Enterprise Issuer ID
InstallatietijdDirect (0 minuten)~15 minuten (Google Cloud + Business Console)
Merknaam en logo op pasVolledig aanpasbaar per sjabloon (issuerName, programLogo)Volledig aanpasbaar per sjabloon (issuerName, programLogo)
Toegang tot Google Pay & Wallet ConsoleBeheerd door PassinstanceDirecte toegang tot uw eigen Google Business Console
Google Smart Tap NFC (NFC_SMART_TAP)Gebruikt werkruimte-/lezerconfiguratieOndersteunt uw eigen smartTapMerchantId & collectorId
Callback-webhook (/api/v1/wallet/callback)Automatisch vooraf geconfigureerdAutomatisch geconfigureerd bij aanmaken van Class

Google Wallet-configuratie & sjabloonactivatie-API (Google Wallet Setup API)

Alle endpoints voor het inrichten van Google Wallet-issuers en sjablonen bevinden zich onder /api/v1/google-wallet:

MethodeEndpoint-padVereiste machtigingBeschrijving
POST/api/v1/google-wallet/setupwallet:manage, certificates:manageRicht een Google Wallet-issueraccount en optionele Smart Tap collector ID in op basis van de bedrijfsgegevens van uw werkruimte.
GET/api/v1/google-wallet/statuswallet:read / wallet:manageRetourneert { isConfigured, collectorId } wat aangeeft of Google Wallet en Smart Tap zijn ingericht.
POST/api/v1/google-wallet/repair-callbackswallet:manage, certificates:manageSynchroniseert ontbrekende /api/v1/wallet/callback-webhook-URL's opnieuw over gepubliceerde Google Wallet Classes.
POST/api/v1/google-wallet/templates/:templateId/activatewallet:manage, certificates:manageActiveert Google Wallet Class-inrichting voor een specifiek sjabloon.
POST/api/v1/google-wallet/templates/:templateId/deactivatewallet:manage, certificates:manageSchakelt Google Wallet-ondersteuning voor een specifiek sjabloon uit.
GET/api/v1/google-wallet/templates/:templateId/statuswallet:manage, certificates:readRetourneert { isEnabled, issuerId } voor het doelsjabloon.

Voorbeeld: Google Wallet Issuer-configuratie initialiseren

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

Antwoord (201 Created):

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

Als u de status achteraf controleert via GET /api/v1/google-wallet/status, wordt { "isConfigured": true, "collectorId": "50992104" } geretourneerd en stellen individuele passen googleWalletTypeSource bloot (Google Wallet source type: INITIAL_CREATION | MIGRATION | MANUAL_REGENERATION).

Best practices tijdens sjabloonconfiguratie

  1. 1
    Kies de juiste Google-pascategorie: koppel uw programma onder Edit Template -> Pass Types aan Loyalty (LoyaltyClass), Offer (OfferClass), Gift Card (GiftCardClass), Event Ticket (EventTicketClass) of Generic Pass (GenericClass) — het resourcetype van Google Wallet-classes kan na publicatie niet meer worden gewijzigd.
  2. 2
    Test Android-voorbeelden expliciet: schakel in het live voorbeeldpaneel tussen Apple Wallet en Google Wallet, omdat de beeldverhoudingen (brede hero-banner androidBackground vs. vierkante uitsnede googlePayLogo) en regels voor het afkappen van velden per platform verschillen.
  3. 3
    Gebruik Android Overrides: stel aangepaste Android-veldlabels en -waarden in via de Inspector wanneer een Apple-lay-outslot niet 1:1 overeenkomt op Android.

Raadpleeg Google Wallet en Google Smart Tap voor Class/Object- en NFC-specificaties.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.