Skip to content
Helpcentrum-gids · Hulp voor pashouders
3 min leestijdGecontroleerd 2026-11-16

Wallet-problemen oplossen

Los geblokkeerde .pkpass-bestanden in in-app browsers, Google-accountwissels en scanreflecties snel op.

In deze gids

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.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
DOWNLOADPOORT & BROWSER-OVERDRACHTDIAGNOSTIEK
FASE 01 PASHOUDER OPENT /d/:slug, /download/:slug OF /s/:token
FASE 02A WEBVIEW-ONDERSCHEPPING
Instagram/TikTok iOS blokkeert .pkpass
Toon melding "Open in Safari"
FASE 02B AFHANDELING VERLOPEN LINK
Link voorbij `downloadUnti
Laat gebruiker nieuwe link aanvragen viaPOST/d/:slug/request- recovery
FASE 02C PIN-VERIFICATIEPOORT
Vraagt gebruiker op /d/:slug & controleert verifyDownloadPin met ?pin= / header vóór pasverzending

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 / PoortgedragBackend-mechanismeOorzaak & oplossing voor pashouder
'Safari kan dit bestand niet downloaden' of leeg scherm op iPhoneBeperking van ingesloten WKWebView MIME-typeDe 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 pincodeverifyDownloadPin (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 downloadUntilHet 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: trueDe 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-appGoogle-account komt niet overeenChrome 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. 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. 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 cm afstand).
  3. 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. 4
    Gebruik het leesbare serienummer: Elke barcodepas toont een alternatieve code (serialNumber of lidnummer) onder de QR-/PDF417-/Code128-afbeelding zodat medewerkers de pas via GET /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: VOIDED of EXPIRED), is de kaart al verzilverd of is de vervaldatum verstreken en wordt deze door de scanner geweigerd (ALREADY_VOIDED / PASS_VOIDED_AFTER_SCAN of EXPIRED).

Nog steeds hulp nodig? Raadpleeg Een pas toevoegen aan uw Wallet of neem contact op via Contact opnemen met support.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.