Skip to content
Helpcentrum-gids · Wallet-integraties
3 min leestijdGecontroleerd 2026-11-16

Google Wallet

Hoe Passinstance Generic-, Loyalty-, Offer-, Gift Card- en Event-objecten uitgeeft via getekende Save JWT-links.

In deze gids

Overzicht: tweedelige Class- & Object-architectuur

In tegenstelling tot het downloadbare binaire .pkpass-archief van Apple Wallet werkt Google Wallet op basis van een tweedelig datamodel in de cloud, beheerd via de Google Wallet REST API (walletobjects/v1):

  1. 1
    Wallet Class (sjabloonlaag): definieert gedeelde visuele branding, metadata van de uitgever, programmalogo's, lay-outstructuur en callback-URL's voor alle pashouders van een sjabloon (bijv. LoyaltyClass, EventTicketClass, OfferClass, GiftCardClass, GenericClass).
  2. 2
    Wallet Object (pasinstantielaag): vertegenwoordigt het digitale bewijs van een individuele klant en verwijst naar zijn bovenliggende classId (bijv. LoyaltyObject, EventTicketObject, OfferObject, GiftCardObject, GenericObject), inclusief de unieke barcode, het puntensaldo, de tierstatus en de Smart Tap-payload van de pashouder.
SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
GOOGLE WALLET CLASS/OBJECT & JWT SAVE-PIJPLEIN
FASE 01 FASE 1: SJABLOON PUBLICERENCLASS INRICHTEN
Passinstance-sjabloon gepubliceerd (POST/api/v1/templates/:id/publish)
Google Wallet Sync doet upsert voor <issuerId>.<templateClassId> via REST (LoyaltyClass | EventTicketClass | OfferClass | GiftCardClass)
FASE 02 FASE 2: PASUITGIFTE & RS256 SAVE JWT GENEREREN
1
Richt <issuerId>.<passObjectId> in of sluit in (LoyaltyObject, enz.)
2
Onderteken JWT-claims (iss, aud: "google", typ: "savetowallet", payload) met de RSA-privésleutel van het Google Cloud Service Account (RS256)
3
Retourneer Save-URL: https://pay.google.com/gp/v/save/<signed_jwt>
Gebruiker slaat op / verwijdert
FASE 03A Google Cloud roept Passinstance-webhook
aan: POST/api/v1/wallet/callback
Event: eventType: "save" | "del"
Werkt actieve installatietelemetrie bi
Pasmutatie aan serverzijde
FASE 03B Passinstance voert REST PATCH uit
op walletobjects/v1/...Object
Google Play Services synchroniseer live kaart direct op Android-telefoon

Passinstance-programma's koppelen aan Google Wallet Classes en Objects

De factory-adapters van Passinstance koppelen uw sjabloonconfiguratie automatisch aan het bijbehorende Google Wallet-resourcepaar:

Passinstance-programmaGoogle Class-resourceGoogle Object-resourceBelangrijkste gespecialiseerde velden
Spaar- & stempelkaartenLoyaltyClassLoyaltyObjectloyaltyPoints, secondaryLoyaltyPoints, accountId, accountName, rewardsTier
Coupons & vouchersOfferClassOfferObjectredemptionChannel, provider, validTimeInterval, barcode
Cadeau- & prepaidkaartenGiftCardClassGiftCardObjectcardNumber, pin, balance (micros + currencyCode), balanceUpdateTime
EvenementticketsEventTicketClassEventTicketObjectseatInfo (seat, row, section, gate), ticketHolderName, eventName, doorsOpen
Lidmaatschap & pasjesGenericClassGenericObjectcardTitle, subheader, header, textModulesData, imageModulesData

Belangrijk: Zelfs als een klant op meerdere Android-apparaten is ingelogd met hetzelfde Google-account, koppelt Google Wallet het digitale pasbewijs aan één canonieke <issuerId>.<objectId>. Passinstance ontdubbelt op Object-niveau en telt dit als 1 actieve Google Wallet-pas.

1. Met RS256 ondertekende Save to Google Wallet JWT

Wanneer een pashouder een slimme link opent op Android, stelt Passinstance een JSON Web Token samen, ondertekent dit met de privésleutel van uw Google Cloud Service Account en leidt door naar https://pay.google.com/gp/v/save/<jwt>:

JSON
{
  "iss": "wallet-signer@passinstance-prod.iam.gserviceaccount.com",
  "aud": "google",
  "typ": "savetowallet",
  "iat": 1763218800,
  "origins": ["https://app.passinstance.com"],
  "payload": {
    "loyaltyObjects": [
      {
        "id": "3388000000022194812.pass_c41a8d20",
        "classId": "3388000000022194812.cls_7b9e4c12",
        "state": "ACTIVE",
        "accountId": "CUST-88412",
        "accountName": "Alex Rivera",
        "loyaltyPoints": {
          "label": "Points",
          "balance": { "int": 1450 }
        },
        "barcode": {
          "type": "QR_CODE",
          "value": "PI-8849-2026-X9",
          "alternateText": "PI-8849-2026-X9"
        }
      }
    ]
  }
}

2. Google Wallet installatie- en verwijderingscallback (POST /api/v1/wallet/callback)

Elke Google Wallet Class die door Passinstance wordt ingericht, stelt callbackOptions.url in op POST /api/v1/wallet/callback. Zodra een Android-gebruiker een pas opslaat in Google Wallet of deze van het apparaat verwijdert, verzendt Google een ondertekende callback-payload:

JSON
POST /api/v1/wallet/callback
{
  "classId": "3388000000022194812.cls_7b9e4c12",
  "objectId": "3388000000022194812.pass_c41a8d20",
  "eventType": "save",
  "expTimeMillis": 1763219100000,
  "nonce": "9f8e7d6c-5b4a-3210-fedc-ba9876543210"
}
  • eventType: "save": registreert de actieve Google Wallet-installatie, verhoogt installedDevices en activeert de webhook-/workflowtrigger PASS_INSTALLED.
  • eventType: "del": markeert het Google Wallet-object als gedeïnstalleerd en verlaagt de tellers voor actief pasgebruik.

Live veldoverschrijvingen voor Android

Omdat Google Wallet passen weergeeft met een verticaal scrollende kaartlay-out (header, cardTitle en rijen in textModulesData met twee kolommen) in plaats van de vaste omkeerbare voor-/achterkant van Apple Wallet, kunt u Android Overrides configureren in de Visual Editor Inspector voor elk veld of afbeeldingsasset (googlePayLogo, androidBackground, androidLogo).

Lees meer bij Google Wallet Platform, Google Wallet-configuratie en Google Smart Tap.

Gerelateerde product- en ontwikkelaarsdocs

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.