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

Update or Remove a Pass

Turn on automatic Wallet updates, pull-to-refresh stale balances, mute lock-screen alerts, or remove a card cleanly.

In This Guide

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.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
WALLET UPDATE & UNINSTALLATION PROTOCOL
STAGE 01 LIVE PASS REFRESH
iOS: APNs silent push {}iPhone calls GET/v1/passes/:bundleId/:serial
Android: Passinstance patches walletobjects via Google Wallet REST API
STAGE 02 PASSHOLDER REMOVES PASS FROM DEVICE
Apple Wallet emits: DELETE/v1/devices/:deviceId/registrations/:type/:serial
Google Wallet emits: POST/api/v1/wallet/callback (eventType: "del")
Pass transitions to Removed from Wallets (inactiveDeviceRegistrations)
STAGE 03 EMAIL & MARKETING PREFERENCES (Email Preferences API)
RFC 8058 One-Click Unsubscribe: POST/email/unsubscribe/:token
Browser Preference Redirect: GET/email/unsubscribe/:token
Self-Service Preference Portal: /email/preferences/:token

Refreshing Your Pass & Managing Lock-Screen Notifications

On iPhone (Apple Wallet)

  1. 1
    Open the Wallet app and tap your pass.
  2. 2
    Tap the ... (More / Pass Details) button in the top-right corner to inspect the back of the pass.
  3. 3
    Verify Automatic Updates: Ensure Automatic Updates is toggled ON so your card refreshes in the background whenever you earn points or stamps.
  4. 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. 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. 1
    Open the Google Wallet app and select your pass.
  2. 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 PathMethodCallerDescription
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumberDELETEApple PassKitInvoked automatically by iOS when a passholder taps Remove Pass in Apple Wallet (passTypeIdentifier = Apple bundleId).
/api/v1/wallet/callbackPOSTGoogle WalletWebhook invoked by Google Cloud (eventType: "del") when a user removes a pass on Android.
/email/unsubscribe/:tokenPOST / GETEmail Client / UserPOST processes RFC 8058 List-Unsubscribe=One-Click; GET safely redirects to the preference UI without mutating state.
/email/preferences/:tokenGETPassholder BrowserOpens 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)

JSON
{
  "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 (installedDevices decrements), 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.

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.