Skip to content
Terug naar blog

Google Wallet pass maken: Complete integratiehandleiding

Google Wallet API, ondertekende JWT-tokens en generieke pasklassen.

Passinstance Team
Passinstance Team

Wallet pass platform team

2026-08-162 min leestijd
Omslagafbeelding voor Google Wallet pass maken: Complete integratiehandleiding

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.
SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUUR
FASE 01 Google Wallet Class (Hoofdsjabloon)
FASE 02A Gebruikersobject A (Jane Doe • 1.250 punten)
FASE 02B Gebruikersobject B (John Smith • 500 punten)
FASE 02C Gebruikersobject C (Alex Morgan • Gold-niveau)

2. Configuratie in de Google Pay & Wallet Console

Om native Google Wallet-passen uit te geven:

  1. 1
    Uitgeveraccount (Issuer Account): Vraag een Issuer Account aan in de Google Pay & Wallet Console.
  2. 2
    Serviceaccount-inloggegevens: Maak een Google Cloud Service Account aan, ken de machtiging Google Wallet API Developer toe en download de JSON met de private RSA-sleutel.
  3. 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.


Google Wallet-passen worden gedistribueerd met cryptografisch ondertekende JSON Web Tokens (JWT's) die zijn ingesloten in standaard HTTPS-URL's:

TS
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.


Veldinspectie — Koppel gedeelde variabelen zoals {storedValue} met een optionele Android-override
Veldinspectie — Koppel gedeelde variabelen zoals {storedValue} met een optionele Android-override

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:

HTTP
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:

TS
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);
Dubbele Wallet-livevoorbeeld — Schakel direct tussen Apple Wallet- en Google Wallet-weergaven
Dubbele Wallet-livevoorbeeld — Schakel direct tussen Apple Wallet- en Google Wallet-weergaven

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.
Interactieve live demo
Apple Wallet & Google Wallet

Test een echte walletpas op uw telefoon

Ervaar zelf hoe digitale passen werken. Scan met uw camera of tik hieronder om deze pas direct toe te voegen aan Apple Wallet of Google Wallet.

Artisan RoastersCafé & F&B
Test QR code for Artisan Roasters

Scan met smartphonecamera

Gerelateerd in dit onderwerp

Ontwikkelaars-API & integraties

Open topic-hub

Klaar om uw Wallet-kaart-programma te lanceren?

Maak uw account aan, ontwerp uw passjabloon en test echte passen direct in Apple Wallet en Google Wallet.