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

Wallet-Probleme beheben

Beheben Sie blockierte .pkpass-Downloads in Social-App-Browsern, falsche Google-Konten und Barcode-Lesefehler.

In dieser Anleitung

Häufige Installations- und Scan-Probleme beheben

Die meisten Probleme beim Hinzufügen eines Passes oder beim Scannen an der Kasse werden durch eingebettete Social-Media-Browser, abweichende Google-Konten, Download-Schutzmechanismen (verifyDownloadPin / downloadUntil) oder Bildschirmspiegelungen am Kassenbereich verursacht.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
DOWNLOAD-SCHUTZ & BROWSER-ÜBERGABE-DIAGNOSE
STUFE 01 PASSINHABER ÖFFNET /d/:slug, /download/:slug ODER /s/:token
STUFE 02A WEBVIEW-ABFANGBEH.
Instagram/TikTok iOS blockiert .pkpass
Hinweis zum Tippen auf „In Safari
öffnen“
STUFE 02B ÜBERGABE BEI ABLAUF
Link nach downloadUntil
Nutzer fordert neuen
Link über POST/d/:slug/ request-recovery an
STUFE 02C PIN-PRÜFUNGSSCHRANKE
Fragt Nutzer auf /d/:slug ab & prüft verifyDownloadPin
über ?pin= / Header vor Auslieferung

Diagnose-Referenz für Download-Schutzschranken

Wenn Sie prüfen möchten, warum ein Smart-Link (/d/:slug, /download/:slug oder /s/:token) Apple Wallet oder Google Wallet nicht unmittelbar öffnet, kontrollieren Sie den Antwortstatus und die konfigurierte Schutzschranke:

Symptom / Verhalten der SchutzschrankeBackend-MechanismusUrsache & Lösung für Passinhaber
„Safari kann diese Datei nicht laden“ oder leerer Bildschirm auf dem iPhoneEingebettete WKWebView-MIME-EinschränkungDer Link wurde in Instagram, TikTok, Facebook, LinkedIn oder einer E-Mail-Vorschau geöffnet. Tippen Sie auf ... -> In Systembrowser öffnen (Safari), damit iOS die über bundleId signierte .pkpass-Datei installieren kann.
Pass erfordert eine 4- bis 6-stellige PINverifyDownloadPin (Public Download Page)Der Aussteller hat einen PIN-Schutz für den Download aktiviert (pinVerified: false bis zur Eingabe). Geben Sie die PIN auf der PassFlow-Seite (GET /d/:slug?pin=...) oder über die E-Mail-/SMS-Aufforderung ein, um die Wallet-Links freizuschalten.
Link abgelaufen (downloadUntil)Zeitstempel-Prüfung downloadUntilDas zeitlich begrenzte Download-Token ist abgelaufen. Verwenden Sie die Wiederherstellungsschaltfläche auf der Seite (POST /d/:slug/request-recovery mit { emailOrPhone }), um einen neuen Link zu erhalten.
Gerätelimit erreicht (HTTP 403 Forbidden)limitToOneActivePerPass: trueDer Pass ist bereits auf einem anderen Gerät aktiv. Entfernen Sie den Pass zuerst von Ihrem alten Smartphone oder bitten Sie den Aussteller, die Gerätebindung zurückzusetzen.
Karte unter Android gespeichert, fehlt aber in der Google Wallet AppAbweichendes Google-KontoChrome war mit einem anderen Gmail-Konto angemeldet als die Google Wallet App. Wechseln Sie in Google Wallet über das Profilsymbol oben rechts zum passenden Konto.

PIN-geschützte Download-Seite freischalten

Wenn eine Vorlage, ein Wallet-Experience-Paket oder eine Download-Seite vor dem Ausliefern der signierten .pkpass-Datei bzw. der Google-Speicher-URL eine PIN-Prüfung verlangt, validiert Public Download Page die PIN über verifyDownloadPin (über den Header oder den Query-Parameter ?pin= auf /d/:slug und /d/:slug/download) und hält die Wallet-Download-URLs zurück (error=pin_required / pinVerified: false), bis eine gültige PIN auf der PassFlow-Seite eingegeben wird.

Optisches Barcode- & NFC-Scannen an der Kasse korrigieren

Wenn ein Kassenscanner oder die Kamera eines Mitarbeiter-Smartphones Ihren Pass am Point of Sale schwer erfassen kann:

  1. 1
    Bildschirmhelligkeit maximieren: Apple Wallet und Google Wallet erhöhen beim Anzeigen eines Barcodes automatisch die Displayhelligkeit; aggressive Energiesparmodi können dies jedoch überschreiben. Erhöhen Sie die Helligkeit bei Bedarf manuell.
  2. 2
    Abgedunkelte Blickschutzfolien entfernen oder neigen: Polarisierte Sichtschutzgläser reduzieren den Kontrast in schrägen Winkeln unter Ladenbeleuchtung erheblich. Halten Sie das Smartphone flach und direkt vor das optische Scannerfenster (10–15 cm Abstand).
  3. 3
    Direkt an das NFC-Kontaktlossymbol halten: Bei Pässen mit Apple VAS oder Google Smart Tap (NFC) halten Sie die obere Kante Ihres iPhones bzw. die mittlere Rückseite Ihres Android-Smartphones 1 Sekunde lang direkt an das Kontaktlossymbol des Lesegeräts und bestätigen Sie bei Aufforderung mit Face ID / Touch ID / Biometrie.
  4. 4
    Lesbare Seriennummer nutzen: Jeder Barcode-Pass enthält einen Klartextcode (serialNumber oder Mitglieds-ID) direkt unter der QR-/PDF417-/Code128-Grafik, sodass Mitarbeitende den Pass über GET /api/v1/scans/pass?barcode=... auch bei beschädigtem Display abrufen können.

Wichtig: Wenn auf Ihrem Pass das Kennzeichen für abgelaufen oder entwertet angezeigt wird (pass status: VOIDED oder EXPIRED), wurde die Karte bereits eingelöst oder hat ihr Ablaufdatum überschritten und wird vom Scanner abgewiesen (ALREADY_VOIDED / PASS_VOIDED_AFTER_SCAN oder EXPIRED).

Benötigen Sie weitere Unterstützung? Lesen Sie Pass zur Wallet hinzufügen oder kontaktieren Sie uns über Support kontaktieren.

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.