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.
Smart Distribution Endpoints
Passinstance serves passholder installation flows across three public route patterns managed by Download Page API and Public Download Page:
| Route Pattern | Method | Purpose |
|---|---|---|
/d/:slug | GET | Short vanity link for SMS, QR posters, and email campaigns. Performs automatic OS detection and wallet handoff. |
/download/:slug | GET | Explicit PassFlow download page showing pass preview, brand theme, and platform-specific Add to Wallet buttons. |
/s/:token | GET | Cryptographically 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
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
Tap Add to Apple Wallet — iOS immediately recognizes the
application/vnd.apple.pkpasspackage and slides up the native pass preview sheet. -
3
Tap Add in the top-right corner of the preview screen.
-
4
Apple Watch Sync: If you wear a paired Apple Watch, iOS automatically mirrors eligible passes to the Wallet app on your wrist.
-
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
Open your pass link in Google Chrome or your default Android browser.
-
2
Tap Add to Google Wallet — this opens Google's authenticated save sheet (
https://pay.google.com/gp/v/save/<jwt>). -
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
Tap View in Wallet to display your barcode or contactless NFC pass immediately.
3. Opening a Pass Link on a Laptop or Desktop Computer
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:
{
"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.
