Veelvoorkomende problemen met pasinstallatie en scannen oplossen
De meeste problemen bij het toevoegen van een pas of het scannen aan de kassa worden veroorzaakt door ingebouwde browsers in socialmedia-apps, afwijkende Google-accounts, downloadbeveiligingen (verifyDownloadPin / downloadUntil) of schermreflecties aan de balie.
Diagnosetabel voor downloadbeveiligingen
Als een slimme link (/d/:slug, /download/:slug of /s/:token) Apple Wallet of Google Wallet niet direct opent, controleer dan de antwoordstatus en de ingestelde beveiligingspoort:
| Symptoom / Poortgedrag | Backend-mechanisme | Oorzaak & oplossing voor pashouder |
|---|---|---|
| 'Safari kan dit bestand niet downloaden' of leeg scherm op iPhone | Beperking van ingesloten WKWebView MIME-type | De link werd geopend vanuit Instagram, TikTok, Facebook, LinkedIn of een e-mailvoorbeeld. Tik op ... -> Open in systeembrowser (Safari) zodat iOS het met bundleId ondertekende .pkpass-bestand kan installeren. |
| Pas vraagt om een 4- tot 6-cijferige pincode | verifyDownloadPin (Public Download Page) | De uitgever heeft pincodebeveiliging ingeschakeld (pinVerified: false tot verificatie). Voer de pincode in op de PassFlow-pagina (GET /d/:slug?pin=...) of via de e-mail-/sms-melding om de Wallet-links te ontgrendelen. |
Link verlopen (downloadUntil) | Handhaving van tijdstempel downloadUntil | Het tijdelijke downloadtoken is verlopen. Gebruik de herstelknop op de pagina (POST /d/:slug/request-recovery met { emailOrPhone }) om een nieuwe link te ontvangen. |
Apparaatlimiet bereikt (HTTP 403 Forbidden) | limitToOneActivePerPass: true | De pas is al actief op een ander toestel. Verwijder de pas eerst van uw oude telefoon of vraag de uitgever om de apparaatkoppeling te resetten. |
| Kaart opgeslagen op Android, maar ontbreekt in Google Wallet-app | Google-account komt niet overeen | Chrome was aangemeld met een ander Gmail-account dan het primaire account in de Google Wallet-app. Wissel van account via het profielpictogram rechtsboven in Google Wallet. |
Een met pincode beveiligde downloadpagina ontgrendelen
Wanneer een sjabloon, Wallet Experience-pakket of downloadpagina pincodeverificatie vereist voordat het ondertekende .pkpass-bestand of de Google Save-URL wordt aangeboden, valideert Public Download Page de code via verifyDownloadPin (zowel via HTTP-header als queryparameter ?pin= op /d/:slug en /d/:slug/download) en houdt de Wallet-download-URL's tegen (error=pin_required / pinVerified: false) totdat de geldige pincode op de PassFlow-pagina wordt ingevoerd.
Optische barcode- & NFC-scanproblemen aan de kassa verhelpen
Als een kassa-scanner of de camera van een medewerkersapparaat uw pas moeilijk leest aan de balie:
-
1
Zet schermhelderheid op maximaal: Apple Wallet en Google Wallet verhogen automatisch de schermverlichting bij weergave van een barcode, maar agressieve spaarstanden kunnen dit blokkeren. Schuif de helderheid handmatig omhoog.
-
2
Vermijd donkere privacy-screenprotectors: Gepolariseerd privacyglas vermindert het contrast onder schuine hoeken bij winkelverlichting sterk. Houd de telefoon vlak en recht voor het scanvenster (
10–15 cmafstand). -
3
Houd het toestel bij het contactloze NFC-symbool: Houd voor passen met Apple VAS of Google Smart Tap (
NFC) de bovenrand van uw iPhone of het midden van de achterkant van uw Android-toestel 1 seconde direct tegen het contactloze golfpictogram en bevestig desgevraagd met Face ID / Touch ID / biometrie. -
4
Gebruik het leesbare serienummer: Elke barcodepas toont een alternatieve code (
serialNumberof lidnummer) onder de QR-/PDF417-/Code128-afbeelding zodat medewerkers de pas viaGET /api/v1/scans/pass?barcode=...kunnen opzoeken bij een gebarsten scherm.
Belangrijk: Als u een verlopen of ongeldig verklaarde status op uw pas ziet (pass status:
VOIDEDofEXPIRED), is de kaart al verzilverd of is de vervaldatum verstreken en wordt deze door de scanner geweigerd (ALREADY_VOIDED/PASS_VOIDED_AFTER_SCANofEXPIRED).
Nog steeds hulp nodig? Raadpleeg Een pas toevoegen aan uw Wallet of neem contact op via Contact opnemen met support.
