Résolution des problèmes courants d'installation et de scan
La majorité des incidents d'ajout de carte ou de validation en caisse provient des navigateurs intégrés aux applications sociales, d'une différence de compte Google, des contrôles de sécurité au téléchargement (verifyDownloadPin / downloadUntil) ou des reflets d'écran en caisse.
Référentiel de diagnostic des barrières de téléchargement
Pour comprendre pourquoi un lien intelligent (/d/:slug, /download/:slug ou /s/:token) n'ouvre pas immédiatement Apple Wallet ou Google Wallet, examinez le statut de réponse et le mécanisme de protection :
| Symptôme / Comportement observé | Mécanisme backend | Cause & action pour le titulaire |
|---|---|---|
| « Safari ne peut pas télécharger ce fichier » ou écran blanc sur iPhone | Restriction MIME de WKWebView intégré | Le lien a été ouvert dans Instagram, TikTok, Facebook, LinkedIn ou un aperçu e-mail. Touchez ... -> Ouvrir dans le navigateur (Safari) afin qu'iOS puisse installer le .pkpass signé par bundleId. |
| La carte demande un code PIN à 4–6 chiffres | verifyDownloadPin (Public Download Page) | L'émetteur a activé la protection par code PIN (pinVerified: false tant qu'il n'est pas saisi). Entrez le PIN sur la page PassFlow (GET /d/:slug?pin=...) ou dans l'invite e-mail/SMS pour déverrouiller les liens Wallet. |
Lien expiré (downloadUntil) | Contrôle d'horodatage downloadUntil | Le jeton de téléchargement temporaire a expiré. Cliquez sur le bouton de récupération affiché (POST /d/:slug/request-recovery avec { emailOrPhone }) pour recevoir un nouveau lien. |
Limite d'appareils atteinte (HTTP 403 Forbidden) | limitToOneActivePerPass: true | La carte est déjà active sur un autre téléphone. Supprimez d'abord le pass de votre ancien appareil ou demandez à l'émetteur de réinitialiser l'association d'appareil. |
| Carte enregistrée sur Android mais absente de Google Wallet | Incohérence de compte Google | Chrome utilisait un compte Gmail secondaire différent du compte actif dans l'application Google Wallet. Changez de compte via l'avatar en haut à droite de Google Wallet. |
Déverrouiller une page de téléchargement protégée par PIN
Lorsqu'un modèle, un pack Wallet Experience ou une page de téléchargement impose une vérification par PIN avant la diffusion du .pkpass signé ou de l'URL Google Save, Public Download Page valide le code via verifyDownloadPin (acceptant l'en-tête HTTP ou le paramètre ?pin= sur /d/:slug et /d/:slug/download) et retient les URL de téléchargement (error=pin_required / pinVerified: false) jusqu'à saisie du code valide.
Corriger la lecture optique des codes-barres et du NFC en caisse
Si un lecteur de caisse ou la caméra d'un appareil d'accueil peine à lire votre carte :
-
1
Poussez la luminosité de l'écran au maximum : Apple Wallet et Google Wallet augmentent automatiquement le rétroéclairage lors de l'affichage d'un code, mais les modes d'économie d'énergie peuvent bloquer ce comportement. Augmentez la luminosité manuellement.
-
2
Retirez ou inclinez les films de confidentialité teintés : Les protections polarisées réduisent fortement le contraste hors axe sous l'éclairage des magasins. Maintenez le téléphone bien à plat face à la fenêtre du lecteur (
10–15 cmde distance). -
3
Approchez l'appareil du symbole sans contact NFC : Pour les cartes configurées avec Apple VAS ou Google Smart Tap (
NFC), placez le bord supérieur de l'iPhone ou le dos central de votre Android contre l'icône sans contact du lecteur pendant 1 seconde et validez Face ID / Touch ID / biométrie si demandé. -
4
Utilisez le numéro de série lisible : Chaque carte avec code-barres affiche un identifiant de secours (
serialNumberou numéro de membre) sous le code QR/PDF417/Code128 permettant au personnel de retrouver la carte viaGET /api/v1/scans/pass?barcode=...si l'écran est fissuré.
Important : Si votre carte affiche un statut expiré ou annulé (pass status:
VOIDEDouEXPIRED), la carte a déjà été utilisée ou a dépassé sa date de validité et sera refusée par le lecteur (ALREADY_VOIDED/PASS_VOIDED_AFTER_SCANouEXPIRED).
Besoin d'aide supplémentaire ? Consultez Ajouter une carte à votre Wallet ou passez par Contacter le support.
