Google Wallet biedt Android-gebruikers een vooraf geïnstalleerde, veilige centrale plek voor het beheren van digitale klantenkaarten, evenementtickets, aanbiedingen, cadeaukaarten, instapkaarten en lidmaatschapspassen.
Deze complete handleiding voor 2026 legt stap voor stap de architectuur van de Google Wallet API uit: uitgevergegevens, de relatie tussen Classes en Objects, ondertekende JWT-opslaanlinks en realtime pushupdates op Android.
1. Google Wallet-architectuur: Classes versus Objects
In tegenstelling tot de enkelvoudige .pkpass-bundel van Apple Wallet splitst Google Wallet pasgegevens op in een Class en een Object:
-
Pass Class: Definieert de algemene lay-outeigenschappen, merkassets, het logo, de hoofdkleur, de naam van de uitgever en de algemene programmavoorwaarden die voor alle gebruikers gelijk zijn.
-
Pass Object: Definieert de gebruikersspecifieke status, de klantnaam, het individuele serie- of barcodenummer, het actuele puntensaldo en de vervaldatum.
2. Configuratie in de Google Pay & Wallet Console
Om native Google Wallet-passen uit te geven:
-
1
Uitgeveraccount (Issuer Account): Vraag een Issuer Account aan in de Google Pay & Wallet Console.
-
2
Serviceaccount-inloggegevens: Maak een Google Cloud Service Account aan, ken de machtiging
Google Wallet API Developertoe en download de JSON met de private RSA-sleutel. -
3
Class-definitie: Publiceer een Pass Class (bijv.
issuerId.loyalty_class_2026) via de Google Wallet REST API.
[!NOTE]
Optie voor directe livegang: Passinstance is een goedgekeurde, vooraf geverifieerde Google Wallet-uitgever. U kunt direct Google Wallet-passen lanceren zonder wekenlang te hoeven wachten op zakelijke verificatie door Google.
3. Ondertekende JWT-links voor "Toevoegen aan Google Wallet" genereren
Google Wallet-passen worden gedistribueerd met cryptografisch ondertekende JSON Web Tokens (JWT's) die zijn ingesloten in standaard HTTPS-URL's:
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}`;
Wanneer een Android-klant op deze link klikt of een QR-code scant, controleert Google Wallet de JWT-handtekening en wordt de pas direct aan zijn toestel toegevoegd.

4. Over-the-air updates via de Google Wallet REST API
Zodra een klant punten verdient of een beloning inwisselt, werkt u de pas op Android-apparaten bij door een PATCH-verzoek te sturen naar de Google Wallet REST API:
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": "Points",
"balance": {
"int": 1500
}
}
}
De backend van Google werkt het Android-toestel in realtime bij en toont een native melding in het meldingenpaneel.
5. Geautomatiseerde Google Wallet-uitgifte met Passinstance
Passinstance verenigt Apple Wallet en Google Wallet achter één enkele API-aanroep en één editorinterface:
import { Passinstance } from "@passinstance/sdk";
const client = new Passinstance({ apiKey: process.env.PASSINSTANCE_API_KEY });
// Publish pass to both Apple Wallet and Google Wallet from one template
const pass = await client.passes.create({
templateId: "tpl_retail_rewards",
data: {
customerName: "Jane Doe",
points: 1500,
},
});
console.log("Add to Google Wallet Link:", pass.googleWalletUrl);

Belangrijkste conclusies
-
Geen Android-app vereist: Klanten tikken op een weblink of scannen een QR-code om passen aan Google Wallet toe te voegen.
-
Eén gecombineerd sjabloon: Beheer één enkel ontwerp dat feilloos compileert voor zowel Android als iOS.
-
Directe over-the-air updates: Stuur puntwijzigingen en aankondigingen rechtstreeks naar Android-toegangsschermen.





