Skip to content
Guide du centre d'aide · Aide aux détenteurs de passes
4 min de lectureVérifié 2026-11-16

Résoudre un problème Wallet

Corrigez les téléchargements .pkpass bloqués par les navigateurs intégrés sociaux, comptes Google ou lecture QR.

Dans ce guide

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.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE : CONTRÔLE DE TÉLÉCHARGEMENT & DIAGNOSTIC NAVIGATEUR
ÉTAPE 01 LE TITULAIRE OUVRE /d/:slug, /download/:slug OU /s/:token
ÉTAPE 02A INTERCEPTION WEBVIEW
Instagram/TikTok iOS bloque .pkpass
Inviter à appuyer sur « Ouvrir dans
Safari »
ÉTAPE 02B GESTION LIEN EXPIRÉ
Lien après downloadUntil
Permet de demander un nouveau lien via `POST
/d/:slug/request-recovery`
ÉTAPE 02C BARRIÈRE VÉRIF. PIN
Invite sur /d/:slug et vérifie verifyDownloadPin avec ?pin= / en-tête avant l'envoi du pass

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 backendCause & action pour le titulaire
« Safari ne peut pas télécharger ce fichier » ou écran blanc sur iPhoneRestriction 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 chiffresverifyDownloadPin (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 downloadUntilLe 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: trueLa 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 WalletIncohérence de compte GoogleChrome 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. 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. 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 cm de distance).
  3. 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. 4
    Utilisez le numéro de série lisible : Chaque carte avec code-barres affiche un identifiant de secours (serialNumber ou numéro de membre) sous le code QR/PDF417/Code128 permettant au personnel de retrouver la carte via GET /api/v1/scans/pass?barcode=... si l'écran est fissuré.

Important : Si votre carte affiche un statut expiré ou annulé (pass status: VOIDED ou EXPIRED), 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_SCAN ou EXPIRED).

Besoin d'aide supplémentaire ? Consultez Ajouter une carte à votre Wallet ou passez par Contacter le support.

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.