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
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
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.
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-programma | Google Class-resource | Google Object-resource | Belangrijkste gespecialiseerde velden |
|---|---|---|---|
| Spaar- & stempelkaarten | LoyaltyClass | LoyaltyObject | loyaltyPoints, secondaryLoyaltyPoints, accountId, accountName, rewardsTier |
| Coupons & vouchers | OfferClass | OfferObject | redemptionChannel, provider, validTimeInterval, barcode |
| Cadeau- & prepaidkaarten | GiftCardClass | GiftCardObject | cardNumber, pin, balance (micros + currencyCode), balanceUpdateTime |
| Evenementtickets | EventTicketClass | EventTicketObject | seatInfo (seat, row, section, gate), ticketHolderName, eventName, doorsOpen |
| Lidmaatschap & pasjes | GenericClass | GenericObject | cardTitle, 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.
Ondertekende JWT-opslaglinks & callback-webhooks
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>:
{
"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:
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, verhoogtinstalledDevicesen activeert de webhook-/workflowtriggerPASS_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.
