Skip to content
Apple Wallet

Apple Wallet Pass API

Issue, sign, and update native .pkpass files for iOS and watchOS via REST API. Certificate management, APNs push updates, and device registration handled automatically.

  • Signed .pkpass generation
  • Automatic WWDR cert management
  • APNs lock-screen push updates
  • TypeScript / Node.js SDK
Works on:
Apple WalletApple WalletGoogle WalletGoogle Wallet

Passinstance REST API Explorer

Illustrative example

Sample requests and responses. No API call is sent.

POST/api/v1/passes
Issue a personalized Apple Wallet and Google Wallet pass with direct download links.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -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"
  }'
Example response
201 Created
{
  "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 Apple Wallet API enables developers to generate, sign, and update Apple Wallet passes (.pkpass) without setting up Apple Developer Pass Type IDs, WWDR intermediate certificates, or APNs servers.

Supports all native Apple Wallet pass types: loyalty cards, store cards, coupons, event tickets, boarding passes, and generic passes. Update pass text, colors, barcodes, or expiration dates programmatically via HTTP REST calls.

Capabilities

What you launch with in production

01

Apple Wallet .pkpass signing & delivery

Generate cryptographically signed .pkpass bundles ready for instant addition to iPhone, Apple Watch, and Mac.

02

APNs push update infrastructure

Trigger native iOS lock-screen push notifications whenever pass data changes in your system.

03

Wallet pass API

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

04

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.

05

Update notifications

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

06

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.

07

Dates, expiry, and lifecycle

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

08

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 an Apple Developer Account to use the Apple Wallet API?

No. Passinstance provides pre-configured signing certificates and Pass Type IDs. Alternatively, enterprise customers can upload their own Apple certificates.

What pass types does the Apple Wallet API support?

The API supports coupon, eventTicket, loyalty, storeCard, boardingPass, and generic pass types.

TEST PRODUCTION PASSES ON YOUR DEVICE

Scan Real Passes Directly into Apple Wallet & Google Wallet

Hold your smartphone camera up to any QR code below to install a live demo pass. Experience Wallet pass updates, barcode rendering, and native installation with zero consumer app downloads.

Apple WalletGoogle WalletApple Wallet & Google Wallet
Private Banking
Aurelia Private Bank - Private Client Cashback & Concierge
Live Experience

Test the Live Aurelia Private Bank Pass

Show live cashback and 24/7 concierge status at branch or POS without a separate banking app.

ClientAlexander Wright
Cashback€428.50
Account•••• 9104
Open Pass on Phone

Interactive Apple and Google Wallet demo passes

Create this Wallet experience in your workspace

Start free with this demo context preserved so onboarding can offer the matching template.

Build on the Apple Wallet API

Get your API key and issue your first signed Apple Wallet pass in minutes.