Wie die intelligente Karteninstallation funktioniert
Das Hinzufügen einer Treuekarte, eines Veranstaltungstickets, eines Mitgliedsausweises oder eines Gutscheins zu Ihrem Smartphone dauert weniger als 10 Sekunden und erfordert keinen Download einer Drittanbieter-App. Wenn Sie einen intelligenten Link (Smart Link) von Passinstance öffnen, erkennt das Backend das Betriebssystem Ihres Geräts und leitet Sie entweder zu einem .pkpass-Paket für Apple Wallet (signiert mit der Pass Type ID bundleId des Händlers) oder zu einem RS256-signierten Speicher-JWT für Google Wallet weiter.
Intelligente Verteilungsendpunkte
Passinstance stellt Installationsabläufe für Karteninhaber über drei öffentliche Routenmuster bereit, die vom Download Page API und Public Download Page verwaltet werden:
| Routenmuster | Methode | Zweck |
|---|---|---|
/d/:slug | GET | Kurzer Vanity-Link für SMS, QR-Poster und E-Mail-Kampagnen. Führt eine automatische Betriebssystemerkennung und Wallet-Übergabe durch. |
/download/:slug | GET | Explizite PassFlow-Downloadseite mit Kartenvorschau, Markendesign und plattformspezifischen Schaltflächen Zur Wallet hinzufügen. |
/s/:token | GET | Kryptografisch signierter, karteninhaberspezifischer Zugriffs-Token-Link mit optionalem Ablaufdatum (downloadUntil) und PIN-Prüfungen. |
Schritt-für-Schritt-Anleitung für Karteninhaber
1. Auf dem iPhone & der Apple Watch (Apple Wallet)
-
1
Tippen Sie auf Ihren persönlichen Karten-Link, sodass er sich in Safari öffnet (wenn Sie den Link innerhalb von Instagram, TikTok oder LinkedIn angetippt haben, tippen Sie unten rechts auf das Browser-Symbol, um ihn im nativen Safari-Browser zu öffnen).
-
2
Tippen Sie auf Zu Apple Wallet hinzufügen – iOS erkennt das
application/vnd.apple.pkpass-Paket sofort und blendet die native Kartenvorschau von unten ein. -
3
Tippen Sie oben rechts im Vorschaubildschirm auf Hinzufügen.
-
4
Synchronisierung mit der Apple Watch: Wenn Sie eine gekoppelte Apple Watch tragen, spiegelt iOS berechtigte Karten automatisch in die Wallet-App an Ihrem Handgelenk.
-
5
Schnellzugriff: Drücken Sie jederzeit zweimal schnell auf die Seitentaste Ihres iPhones, um Ihre gespeicherte Karte an der Kasse oder am Veranstaltungseinlass aufzurufen.
2. Unter Android (Google Wallet)
-
1
Öffnen Sie Ihren Karten-Link in Google Chrome oder Ihrem Standard-Android-Browser.
-
2
Tippen Sie auf Zu Google Wallet hinzufügen – dadurch öffnet sich der authentifizierte Speicherbildschirm von Google (
https://pay.google.com/gp/v/save/<jwt>). -
3
Überprüfen Sie, ob das oben im Dialogfeld angezeigte Google-Konto mit dem Konto übereinstimmt, das in der Google Wallet-App Ihres Smartphones angemeldet ist, und tippen Sie anschließend auf Zur Wallet hinzufügen.
-
4
Tippen Sie auf In Wallet ansehen, um Ihre Karte mit Barcode oder kontaktlosem NFC sofort anzuzeigen.
3. Öffnen eines Karten-Links auf einem Laptop oder Desktop-Computer
Auf Desktop-Computern sind Apple Wallet oder Google Wallet nicht nativ verfügbar. Wenn Sie einen /d/:slug- oder /s/:token-Link unter macOS oder Windows öffnen:
{
"detectedPlatform": "DESKTOP",
"handoffMode": "QR_CODE_LANDING_PAGE",
"qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
"instructions": "Scan this QR code with your iPhone or Android camera to add the pass directly to your phone."
}
Richten Sie die Kamera Ihres iPhones oder Android-Smartphones auf den auf dem Bildschirm angezeigten QR-Code und tippen Sie auf das eingeblendete Banner, um die Installation auf Ihrem Telefon abzuschließen.
Wichtig: Einige Herausgeber schützen hochwertige VIP-Karten oder Mitarbeiterausweise durch eine Einzelgerätebindung (
limitToOneActivePerPass: true) oder eine Download-PIN. Geben Sie bei entsprechender Aufforderung die per E-Mail oder SMS zugesandte PIN ein, bevor Sie auf Zur Wallet hinzufügen tippen.
Haben Sie Probleme bei der Installation Ihrer Karte? Lesen Sie Wallet-Probleme beheben oder erfahren Sie unter Karte finden oder wiederherstellen, wie Sie eine bestehende Karte wiederfinden.
