Skip to content
Hilfecenter-Anleitung · Hilfe für Passinhaber
3 Min. LesezeitGeprüft 2026-11-16

Karte aktualisieren oder entfernen

Automatische Updates aktivieren, Stände manuell aktualisieren, Benachrichtigungen stummschalten oder eine Karte entfernen.

In dieser Anleitung

Funktionsweise automatischer Updates & Deinstallations-Telemetrie

Sobald ein Pass zu Apple Wallet oder Google Wallet hinzugefügt wurde, bleibt er mit Passinstance verbunden, sodass Punktestände, Stempelanzahlen, Tier-Upgrades und Gate-Änderungen automatisch aktualisiert werden, ohne dass eine neue Karte heruntergeladen werden muss. Wenn Sie einen Pass von Ihrem Smartphone entfernen, benachrichtigt Ihre Wallet-App das Backend, damit keine weiteren Updates gesendet werden.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
WALLET-UPDATE- & DEINSTALLATIONSPROTOKOLL
STUFE 01 LIVE-AKTUALISIERUNG DES PASSES
iOS: Stiller APNs-Push {}iPhone ruft GET/v1/passes/:bundleId/:serial
Android: Passinstance patcht walletobjects über die Google Wallet REST API
STUFE 02 PASSINHABER ENTFERNT PASS VOM GERÄT
Apple Wallet sendet: DELETE/v1/devices/:deviceId/registrations/:type/:serial
Google Wallet sendet: POST/api/v1/wallet/callback (eventType: "del")
Pass wechselt in den Status „Aus Wallets entfernt“ (inactiveDeviceRegistrations)
STUFE 03 E-MAIL- & MARKETING-PRÄFERENZEN (Email Preferences API)
RFC-8058-Ein-Klick-Abmeldung: POST/email/unsubscribe/:token
Browser-Präferenz-Weiterleitung:GET/email/unsubscribe/:token
Self-Service-Präferenzportal: /email/preferences/:token

Pass aktualisieren & Sperrbildschirm-Mitteilungen verwalten

Auf dem iPhone (Apple Wallet)

  1. 1
    Öffnen Sie die Wallet-App und tippen Sie auf Ihren Pass.
  2. 2
    Tippen Sie oben rechts auf ... (Mehr / Passdetails), um die Rückseite des Passes zu öffnen.
  3. 3
    Automatische Updates prüfen: Stellen Sie sicher, dass Automatische Updates aktiviert (EIN) ist, damit Ihre Karte beim Sammeln von Punkten oder Stempeln im Hintergrund aktualisiert wird.
  4. 4
    Manuell per Pull-to-Refresh aktualisieren: Wenn sich Ihr Gerät im Flugmodus befand oder an der Kasse schlechten Empfang hatte, wischen Sie auf dem Bildschirm Passdetails sanft nach unten, um eine sofortige Aktualisierung über GET /v1/passes/:passTypeIdentifier/:serialNumber auszulösen.
  5. 5
    Sperrbildschirm-Banner stummschalten: Wenn Sie Ihren Pass in Apple Wallet behalten, aber keine Sperrbildschirm-Mitteilungen erhalten möchten, schalten Sie Mitteilungen erlauben auf dem Bildschirm „Passdetails“ aus (AUS).

Auf Android (Google Wallet)

  1. 1
    Öffnen Sie die Google Wallet-App und wählen Sie Ihren Pass aus.
  2. 2
    Tippen Sie oben rechts auf ⋮ (Drei-Punkte-Menü), um die Passdetails anzuzeigen und Benachrichtigungen für diesen Pass anzeigen ein- oder auszuschalten.

Pass entfernen & Kommunikationspräferenzen verwalten

Wenn Sie einen Pass aus Ihrer Wallet löschen oder sich von Kampagnen-E-Mails abmelden, verarbeitet Passinstance die Statusänderung über folgende Endpunkte:

EndpunktpfadMethodeAufruferBeschreibung
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumberDELETEApple PassKitWird automatisch von iOS aufgerufen, wenn ein Passinhaber in Apple Wallet auf Pass entfernen tippt (passTypeIdentifier = Apple bundleId).
/api/v1/wallet/callbackPOSTGoogle WalletWebhook, der von Google Cloud aufgerufen wird (eventType: "del"), wenn ein Nutzer einen Pass unter Android entfernt.
/email/unsubscribe/:tokenPOST / GETE-Mail-Client / NutzerPOST verarbeitet RFC 8058 List-Unsubscribe=One-Click; GET leitet sicher auf die Präferenzoberfläche weiter, ohne den Zustand zu verändern.
/email/preferences/:tokenGETBrowser des PassinhabersÖffnet das Self-Service-Präferenzcenter zur granularen Opt-in-/Opt-out-Steuerung für E-Mails (Alias /preferences/:token).

Karte vom Smartphone entfernen

  • Apple Wallet: Pass öffnen → oben rechts auf ... tippen → Pass entfernen wählen → Entfernen bestätigen.
  • Google Wallet: Pass öffnen → oben rechts auf ⋮ tippen → Entfernen wählen → Entfernen bestätigen.

Beispiel: Google-Wallet-Entfernungs-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\"}"
}

Wichtig: Das Entfernen eines Passes aus Apple Wallet oder Google Wallet löscht die Karte von Ihrem Gerät und beendet Sperrbildschirm-Push-Mitteilungen (installedDevices sinkt), löscht jedoch nicht Ihr zugrunde liegendes Mitgliedskonto beim Händler. Um Löschrechte nach DSGVO wahrzunehmen, wenden Sie sich an das ausstellende Unternehmen oder lesen Sie Datenschutz & DSGVO.

Möchten Sie eine versehentlich gelöschte Karte wiederherstellen? Folgen Sie den Schritten in Pass finden oder wiederherstellen.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.