How Automatic Pass Updates & Removal Telemetry Work
Once a pass is added to Apple Wallet or Google Wallet, it stays connected to Passinstance so point balances, stamp counts, tier upgrades, and event gate changes refresh automatically without downloading a new card. When you remove a pass from your phone, your wallet app notifies the backend to stop sending updates.
Refreshing Your Pass & Managing Lock-Screen Notifications
On iPhone (Apple Wallet)
-
1
Open the Wallet app and tap your pass.
-
2
Tap the
...(More / Pass Details) button in the top-right corner to inspect the back of the pass. -
3
Verify Automatic Updates: Ensure Automatic Updates is toggled ON so your card refreshes in the background whenever you earn points or stamps.
-
4
Manual Pull-to-Refresh: If your phone was in Airplane Mode or had weak reception at checkout, swipe down gently on the Pass Details screen to force an immediate refresh from
GET /v1/passes/:passTypeIdentifier/:serialNumber. -
5
Mute Lock-Screen Banners: If you want to keep your pass in Apple Wallet but silence lock-screen notifications, toggle Allow Notifications OFF on the Pass Details screen.
On Android (Google Wallet)
-
1
Open the Google Wallet app and select your pass.
-
2
Tap the
⋮(three-dot menu) in the top-right corner to view pass details and toggle Show notifications for this pass.
Removing a Pass & Managing Communication Preferences
When you delete a pass from your wallet, or unsubscribe from campaign emails, Passinstance processes the state change through the following endpoints:
| Endpoint Path | Method | Caller | Description |
|---|---|---|---|
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber | DELETE | Apple PassKit | Invoked automatically by iOS when a passholder taps Remove Pass in Apple Wallet (passTypeIdentifier = Apple bundleId). |
/api/v1/wallet/callback | POST | Google Wallet | Webhook invoked by Google Cloud (eventType: "del") when a user removes a pass on Android. |
/email/unsubscribe/:token | POST / GET | Email Client / User | POST processes RFC 8058 List-Unsubscribe=One-Click; GET safely redirects to the preference UI without mutating state. |
/email/preferences/:token | GET | Passholder Browser | Opens the self-service communication preference center for granular email opt-in/opt-out control (/preferences/:token alias). |
How to Remove a Card from Your Phone
-
Apple Wallet: Open the pass → tap
...(top right) → tap Remove Pass → confirm Remove. -
Google Wallet: Open the pass → tap
⋮(top right) → tap Remove → confirm Remove.
Example: Google Wallet Removal Callback (POST /api/v1/wallet/callback)
{
"signature": "MEYCIQDa9...",
"intermediateSigningKey": { "signedKey": "..." },
"protocolVersion": "ECv2SigningOnly",
"signedMessage": "{\"ISSUER_ID\":\"3388000000012345678\",\"OBJECT_ID\":\"3388000000012345678.pass_99102\",\"EVENT_TYPE\":\"del\",\"NONCE\":\"7b8a9c10\"}"
}
Important: Removing a pass from Apple Wallet or Google Wallet deletes the card from your phone and stops lock-screen push notifications (
installedDevicesdecrements), but it does not erase your underlying membership account with the merchant. To exercise GDPR erasure rights, contact the issuing business or review Data Privacy & GDPR.
Need to restore a card you deleted by mistake? Follow the steps in Find or Recover Your Pass.
