Skip to content
Google Wallet

Google Wallet Pass API

Manage Google Wallet classes, objects, and JWT save links via REST API. Issue and update Android wallet passes programmatically.

  • Google Wallet classes & objects
  • JWT Save link generation
  • Real-time Google Wallet API updates
  • TypeScript / Node.js SDK
Works on:
 Apple Wallet (.pkpass)Google Wallet (JWT & REST)

Passinstance REST API Explorer

v1.1 Live

Interactive examples for Auth, Template creation, and Pass issuance

POST/api/v1/passes
Issue a personalized Apple Wallet & Google Wallet pass bundle with direct download links.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: pi_live_9f82c4018e6a4b12" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Response Payload
201 Created52ms
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Overview

The Passinstance Google Wallet API simplifies Android wallet pass issuance by handling Google Wallet issuer accounts, Class and Object model relationships, and cryptographically signed JWT Save links.

Issue loyalty cards, offers, gift cards, event tickets, and generic passes that install directly into Google Wallet on Android devices and stay synced via Google Wallet REST API updates.

Capabilities

Everything to run wallet passes in production

Google Wallet class & object management

Automatically map master templates to Google Wallet classes and individual pass instances to Google Wallet objects.

Signed JWT Add to Google Wallet links

Generate instant save-to-wallet URLs and QR codes for web, mobile app, or email distribution.

Wallet pass API

Create, update, and revoke passes programmatically with a REST API and webhooks for install, update, and redemption events.

QR codes and download links

Distribute passes through hosted Add to Wallet pages, QR codes, email, SMS, or POS — customers install in one tap, no app required.

Update notifications

Push live field changes and lock-screen notifications when a balance, status, gate, or offer changes — passes stay current on every device.

Geolocation and relevant locations

Attach relevant locations so a pass surfaces on the lock screen when a customer is near your store, venue, or pickup point.

Dates, expiry, and lifecycle

Set relevant dates and expiration, extend validity on scan, and manage the full pass lifecycle from issue to revoke.

Analytics and tracking

Track installs, removals, scans, and redemptions per pass and cohort, with CSV and API exports for your own reporting.

FAQ

Frequently asked questions

Do I need a Google Pay & Wallet Console issuer account?

No. Passinstance operates as an approved Google Wallet issuer, allowing you to launch instantly without waiting for Google business verification.

How do updates reach Android devices?

Passinstance makes authorized Google Wallet API calls to update pass objects, instantly updating the pass in the Google Wallet app.

Build on the Google Wallet API

Get your API key and issue Google Wallet passes for Android in minutes.