Skip to content
Help Center Guide · Help for PassholdersOnboarding Phase 4
3 min readVerified 2026-11-16

Add a Pass to Your Wallet

End-user guide to saving a pass on iPhone (Apple Wallet), Android (Google Wallet), or desktop browsers via QR handoff.

In This Guide

Interactive UI Walkthroughs

Open in 6-Phase Onboarding Guide

Inspect exact dashboard panels, controls, and zoomed callouts related to this guide.

Zoomed UI focus
Key UI elements

Dual-Wallet live pass preview (Zoomed)

Toggle between Apple and Google in the Pass preview panel to confirm artwork, balance formatting, QR code legibility, and field alignment.

How Smart Pass Installation Works

Adding a loyalty card, event ticket, membership pass, or coupon to your smartphone takes under 10 seconds and requires no third-party app download. When you open a Passinstance smart link, the backend detects your device operating system and routes you either to an Apple Wallet .pkpass bundle (signed with the merchant's Pass Type ID bundleId) or an RS256-signed Google Wallet Save JWT.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
SMART DOWNLOAD ROUTING & WALLET HANDOFF
STAGE 01 PASSHOLDER OPENS SMART LINK (GET/d/:slug, /download/:slug, or /s/:token)
Public Download Page inspects User-Agent & token security gates
STAGE 02A APPLE WALLET STREAM
Streams signed ZIP application/vnd. apple.pkpass
Syncs to Apple Watch
STAGE 02B GOOGLE WALLET JWT REDIRECT
Signs RS256 Object JWT
Redirects to https:// pay.google.com/gp/v/save
Saves to Google Account
STAGE 02C DESKTOP QR HANDOFF
Renders responsive
PassFlow page with scannable QR code for phone camera

Smart Distribution Endpoints

Passinstance serves passholder installation flows across three public route patterns managed by Download Page API and Public Download Page:

Route PatternMethodPurpose
/d/:slugGETShort vanity link for SMS, QR posters, and email campaigns. Performs automatic OS detection and wallet handoff.
/download/:slugGETExplicit PassFlow download page showing pass preview, brand theme, and platform-specific Add to Wallet buttons.
/s/:tokenGETCryptographically signed, per-passholder access token link with optional expiration (downloadUntil) and PIN checks.

Step-by-Step Guide for Passholders

1. On iPhone & Apple Watch (Apple Wallet)

  1. 1
    Tap your personal pass link so it opens in Safari (if you tapped the link inside Instagram, TikTok, or LinkedIn, tap the browser icon in the bottom-right corner to open in native Safari).
  2. 2
    Tap Add to Apple Wallet — iOS immediately recognizes the application/vnd.apple.pkpass package and slides up the native pass preview sheet.
  3. 3
    Tap Add in the top-right corner of the preview screen.
  4. 4
    Apple Watch Sync: If you wear a paired Apple Watch, iOS automatically mirrors eligible passes to the Wallet app on your wrist.
  5. 5
    Quick Access: Double-click the side button on your iPhone at any time to pull up your saved pass at checkout or venue doors.

2. On Android (Google Wallet)

  1. 1
    Open your pass link in Google Chrome or your default Android browser.
  2. 2
    Tap Add to Google Wallet — this opens Google's authenticated save sheet (https://pay.google.com/gp/v/save/<jwt>).
  3. 3
    Verify the Google Account shown at the top of the prompt matches the account logged into your phone's Google Wallet app, then tap Add to Wallet.
  4. 4
    Tap View in Wallet to display your barcode or contactless NFC pass immediately.

Desktop computers do not run Apple Wallet or Google Wallet natively. When you open a /d/:slug or /s/:token link on macOS or Windows:

JSON
{
  "detectedPlatform": "DESKTOP",
  "handoffMode": "QR_CODE_LANDING_PAGE",
  "qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
  "instructions": "Scan this QR code with your iPhone or Android camera to add the pass directly to your phone."
}

Point your iPhone or Android camera at the on-screen QR code and tap the banner that appears to complete installation on your phone.

Important: Some issuers protect high-value VIP cards or employee badges with single-device binding (limitToOneActivePerPass: true) or a download PIN. If prompted, enter the PIN sent to your email or SMS before tapping Add to Wallet.

Having trouble installing your card? Check Resolve Wallet Issues or learn how to locate an existing card in Find or Recover Your Pass.

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.