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.
Pass aktualisieren & Sperrbildschirm-Mitteilungen verwalten
Auf dem iPhone (Apple Wallet)
-
1
Öffnen Sie die Wallet-App und tippen Sie auf Ihren Pass.
-
2
Tippen Sie oben rechts auf
...(Mehr / Passdetails), um die Rückseite des Passes zu öffnen. -
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
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/:serialNumberauszulösen. -
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
Öffnen Sie die Google Wallet-App und wählen Sie Ihren Pass aus.
-
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:
| Endpunktpfad | Methode | Aufrufer | Beschreibung |
|---|---|---|---|
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber | DELETE | Apple PassKit | Wird automatisch von iOS aufgerufen, wenn ein Passinhaber in Apple Wallet auf Pass entfernen tippt (passTypeIdentifier = Apple bundleId). |
/api/v1/wallet/callback | POST | Google Wallet | Webhook, der von Google Cloud aufgerufen wird (eventType: "del"), wenn ein Nutzer einen Pass unter Android entfernt. |
/email/unsubscribe/:token | POST / GET | E-Mail-Client / Nutzer | POST verarbeitet RFC 8058 List-Unsubscribe=One-Click; GET leitet sicher auf die Präferenzoberfläche weiter, ohne den Zustand zu verändern. |
/email/preferences/:token | GET | Browser 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)
{
"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 (
installedDevicessinkt), 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.
