Skip to content
Help Center Guide · Help for Passholders
3 min readVerified 2026-11-16

Find or Recover Your Pass

How customers locate a saved card inside Apple/Google Wallet or request a fresh recovery link after switching phones.

In This Guide

Locating a Pass Already Saved on Your Phone

Before requesting a replacement link, check whether your pass is already stored in your phone's wallet app:

In Apple Wallet (iPhone)

  1. 1
    Open the built-in Wallet app.
  2. 2
    Scroll below your top credit and debit payment cards — loyalty cards, memberships, coupons, and event tickets are stacked in the lower section.
  3. 3
    Check Hidden / Expired Passes: If an event date has passed or you haven't used the card recently, iOS may move it to the collapsed list at the very bottom. Scroll all the way down and tap View Expired Passes (you can tap Unhide on any pass to return it to your main stack).

In Google Wallet (Android)

  1. 1
    Open the Google Wallet app and scroll below your payment methods.
  2. 2
    Tap the Search icon or check Expired passes at the bottom of your pass list.
  3. 3
    Tap your profile avatar in the top-right corner to verify you are viewing the same Google Account you used when saving the pass.
SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
SELF-SERVICE PASS RECOVERY
STAGE 01
1
PASSHOLDER REQUESTS RECOVERY (/d/:slug, /download/:slug, or /f/:slug)
Enters registered email address or phone number in the recovery prompt
Calls POST/d/:slug/request-recovery { emailOrPhone }
STAGE 02
2
TENANT-SCOPED LOOKUP & ANTI-ENUMERATION GUARD
Searches active Pass records matching the workspace template & contact info
Always returns uniform HTTP 200 response to prevent email/phone enumeration
STAGE 03
3
SIGNED LINK RE-DELIVERY & DEVICE TRANSFER
Dispatches fresh signed /s/:token link via email
Re-installing preserves existing points, stamps, tier & stored-value balance

Self-Service Recovery After Switching Phones

If you upgraded to a new smartphone, reset your device, or accidentally deleted your pass, your loyalty points, stamps, and membership balance remain safely stored on Passinstance's servers.

Method 1: Re-Open Your Original Confirmation Email or SMS

Search your email inbox or SMS messages for the original message from the merchant. Tapping the Add to Wallet link (/s/:token or /d/:slug) on your new phone downloads the live pass with your current balance intact.

Method 2: Request a Recovery Link (POST /d/:slug/request-recovery)

When a merchant enables self-service recovery on their public download or PassFlow page (Public Pass Recovery API at /d/:slug, /download/:slug, or /f/:slug), passholders can request an instant link re-send:

Endpoint PathMethodAuthFunctionality
/d/:slug/request-recoveryPOSTPublic (Rate-Limited 5/min)Looks up an existing pass by emailOrPhone and emails a fresh signed /s/:token install link.
/s/:tokenGETSigned TokenInstalls the recovered pass (signed with bundleId on iOS) onto the customer's new device.

Request Payload:

JSON
{
  "emailOrPhone": "member@example.com"
}

Response (200 OK — Anti-Enumeration Safe):

JSON
{
  "success": true,
  "message": "If an active pass matches the provided email address, a recovery link has been sent."
}

How limitToOneActivePerPass Handles Device Replacement

Some membership clubs and VIP programs configure limitToOneActivePerPass: true on their template to prevent casual link sharing across multiple people.

Important: If your pass is protected by single-device binding (limitToOneActivePerPass: true) and you get a new phone, first delete the pass from your old device (which triggers an automatic unregistration call DELETE /v1/devices/... on iOS or a del callback on Android) so the slot frees up immediately. If your old phone was lost or broken, contact the issuing business so an administrator can reset your device registration or resend your personal access link.

Need help updating or removing an old card first? Read Update or Remove a Pass or troubleshoot errors in Resolve Wallet Issues.

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.