Safari refuse de télécharger le fichier pkpass, le télécharge sous forme de bloc de texte ou n'affiche jamais la feuille Ajouter à Apple Wallet. Le format pkpass est censé être le chemin le plus simple vers Apple Wallet. Lorsque le transfert échoue, il est souvent utile de vérifier un en-tête du serveur ou un réglage de Safari.
Voici ce que Safari attend d'une URL pkpass, les erreurs courantes de configuration du serveur, les réglages de l'iPhone à vérifier et une solution de transfert du Mac vers l'iPhone qui peut aider lorsque le fichier .pkpass sous-jacent est valide.
Ce que Safari attend d'une URL pkpass
Le guide développeur d'Apple Wallet précise comment un fichier pkpass doit être servi. Safari ne le transmet à Apple Wallet que lorsque la réponse respecte la spécification.
Type MIME correct
Le guide développeur Wallet d'Apple indique que Mail et Safari attendent application/vnd.apple.pkpass. Tout autre type (text/html, application/octet-stream) interrompt généralement la transmission.
Content-Disposition
Content-Disposition: attachment; filename="pass.pkpass" est une recommandation pratique pour le serveur. Ce n'est pas une exigence de la spécification Apple, mais une disposition inline peut afficher le fichier brut.
Requête GET
L'URL de téléchargement doit répondre à une requête GET. Les points d'accès qui n'acceptent que POST échouent, car Safari suit les liens avec GET.
iOS 6 ou version ultérieure
La prise en charge des passes est arrivée avec iOS 6 (alors appelé Passbook, renommé Wallet dans iOS 9). Le format de paquet .pkpasses (plusieurs passes dans un fichier) nécessite iOS 15 ou une version ultérieure.
Pour mieux comprendre le format du fichier, consultez ce qu'est un fichier pkpass.
Le problème vient du serveur, pas de Safari
Comment savoir ce que Safari reçoit
Une vérification rapide permet de déterminer si le pass est défectueux ou si le serveur est mal configuré.
- Toucher le lien affiche une feuille d'aperçu Apple Wallet
- Le bouton Ajouter à Apple Wallet apparaît en haut à droite
- Le fichier est téléchargé discrètement et Wallet s'ouvre
- La page s'affiche avec du texte binaire illisible
- Safari propose un téléchargement, mais le fichier devient .zip ou .html
- Un appui prolongé puis Télécharger le fichier lié enregistre un bloc inutilisable
- La page redirige via un flux OAuth qui supprime le fichier
Côté iPhone : les réglages Safari qui bloquent les téléchargements
Même avec un pkpass correctement servi, quelques réglages de l'iPhone méritent d'être testés.
- Navigation privée : La navigation privée n'est pas un blocage universel documenté. Ouvrir le lien dans un onglet normal constitue un test de diagnostic rapide.
- Bloqueurs de contenu : Les bloqueurs de contenu agressifs qui suppriment les balises script peuvent interrompre le téléchargement lorsque les émetteurs utilisent des liens pilotés par JavaScript. Désactivez le bloqueur pour le domaine de l'émetteur.
- Emplacement des téléchargements Safari : Réglages, Apps, Safari, Téléchargements. Choisissez Sur mon iPhone ou iCloud Drive. Un emplacement mal configuré peut provoquer un échec silencieux.
- Stockage saturé : Un iPhone presque plein refuse les nouveaux téléchargements. Libérez quelques centaines de mégaoctets et réessayez.
- VPN active : Un VPN n'est pas une cause universelle. Désactivez-le brièvement pour vérifier si le routage ou les filtres de l'émetteur affectent la requête.
Chrome, Firefox et les autres navigateurs iOS
Contourner le téléchargement défectueux
NeatPass facilite la conversion de n'importe quel billet, pass ou carte de fidélité en pass Apple Wallet.
Solution 1 : ouvrir le fichier dans Apple Mail
Si Safari rencontre des difficultés avec l'URL, vous envoyer le lien puis l'ouvrir dans Apple Mail fonctionne souvent. Le gestionnaire intégré de Mail achemine les pièces jointes pkpass directement vers Wallet.
Envoyez-vous le lien
Ouvrez-le dans Apple Mail
Touchez Ajouter à Apple Wallet
Solution 2 : télécharger sur Mac, puis utiliser AirDrop vers l'iPhone
Cette solution est utile lorsque Safari sur iPhone refuse le téléchargement. Les navigateurs Mac peuvent enregistrer un pkpass sur le disque, et l'envoi par AirDrop d'un fichier .pkpass valide du Mac vers l'iPhone peut le transmettre directement à Apple Wallet. Cela ne peut pas réparer un fichier HTML, ZIP ou bloc de texte corrompu simplement renommé en .pkpass.
Téléchargez sur Mac
Utilisez AirDrop vers l'iPhone
Acceptez sur l'iPhone
Pour en savoir plus sur le transfert de codes-barres et de passes entre appareils, consultez le transfert d'un code-barres du Mac vers l'iPhone et la vue d'ensemble des méthodes d'importation.
Solution 3 : capturer le code-barres et recréer le pass
Si le pkpass d'origine est défectueux chez l'émetteur (certificat expiré ou JSON mal formé), aucune correction côté client ne fonctionnera. La solution pratique consiste à récupérer le code-barres du billet d'origine, d'une capture d'écran ou d'un PDF, puis à créer un nouveau pass Wallet.
NeatPass lit les codes-barres des captures d'écran, des PDF et de l'appareil photo, puis émet un pass propre signé avec PassKit et contenant les mêmes données scannables. Le contenu du code-barres est conservé : le pass se scanne donc de la même manière sur n'importe quel lecteur. Le modèle de confidentialité est détaillé dans la FAQ sur la confidentialité et le pass fonctionne sans Internet (mode hors ligne).
Fidélité des données du code-barres
Pour connaître les formats de codes-barres pris en charge lors de cette recréation, consultez les codes-barres pris en charge et comment ajouter un pass à Wallet.
Questions fréquentes
Créer un pass Wallet propre
TéléchargerVotre pass dans Wallet
Lorsque Safari refuse un téléchargement pkpass, le fichier peut être mal configuré à la source. Demandez une correction à l'émetteur ou contournez la livraison défectueuse avec AirDrop, Apple Mail ou en recréant le pass à partir du code-barres.
Pour les passes qui refusent simplement de s'installer une fois sur l'appareil, consultez le guide des problèmes Wallet.