Qu’est-ce qu’un fichier pkpass ? Le fonctionnement des pass Apple Wallet

Vous trouverez peut-être un fichier se terminant par .pkpass joint à un e-mail de réservation, ou un site web en téléchargera un quand vous touchez « Ajouter à l’app Cartes d’Apple ». Alors, qu’est-ce qu’un fichier pkpass ? C’est le format qu’utilise Apple Wallet pour chaque carte d’embarquement, billet d’événement, carte de fidélité et coupon que vous ajoutez. Cet article explique ce qu’il contient, comment l’ouvrir sur iPhone, pourquoi il ne peut pas être modifié, et quelles sont vos options quand votre billet n’existe qu’en PDF.

Ce qu’est vraiment un fichier .pkpass

Un fichier .pkpass, c’est un pass Wallet complet dans un seul fichier. Son nom vient de PassKit, le framework d’Apple pour les pass. À l’intérieur, il s’agit d’une archive ZIP avec une autre extension. Les sites web l’envoient généralement avec le type application/vnd.apple.pkpass, pour que Safari sache qu’il doit le transmettre à Wallet au lieu de l’enregistrer comme téléchargement.

Un pass n’est pas une image de votre billet. Ce sont des données structurées : des champs avec un libellé (comme « Porte », « Place » ou « Numéro de membre »), la valeur d’un code-barres, des couleurs et quelques images. Wallet se sert de ces données pour dessiner le pass. C’est pour cela que les pass ont un aspect net et homogène, et que Wallet peut faire des choses impossibles avec un PDF, comme afficher le pass sur l’écran verrouillé à l’approche de l’heure de départ.

Ce que contient un fichier pkpass

Si vous copiez un fichier .pkpass sur un ordinateur, que vous le renommez en .zip et que vous l’ouvrez, vous trouverez généralement :

• pass.json : le pass lui-même. Il contient le style du pass, les libellés et valeurs des champs, le message et le format du code-barres, les couleurs, et des éléments facultatifs comme une date ou un lieu pertinents.
• Des images : une icône, généralement un logo, et parfois une bannière, une vignette ou une image de fond. Elles existent souvent en plusieurs résolutions pour les différents écrans.
• manifest.json : la liste de tous les fichiers du pass, chacun avec une somme de contrôle (une courte empreinte de son contenu).
• signature : une signature cryptographique du manifeste, réalisée avec un certificat délivré par Apple au créateur du pass.

Regarder à l’intérieur ne présente aucun risque, mais n’essayez pas de reconstituer le fichier après l’avoir modifié. La section suivante explique pourquoi cela ne fonctionnera pas.

Pourquoi chaque pass doit être signé

Wallet n’accepte qu’un pass signé avec un certificat valide délivré par Apple. La signature couvre le manifeste, et le manifeste couvre chaque fichier. Si un seul caractère change dans pass.json, les sommes de contrôle ne correspondent plus et Wallet rejette le pass.

Cela vous protège, vous et l’émetteur :

• Vous avez la garantie qu’un pass n’a pas été modifié depuis que son créateur l’a signé.
• Les compagnies aériennes et les lieux savent que leurs pass ne peuvent pas être modifiés en douce après leur envoi.
• Chaque pass peut être rattaché à un titulaire de certificat enregistré auprès d’Apple.

La clé de signature est secrète. Elle doit rester sur un serveur contrôlé par le créateur du pass. Elle ne peut pas être intégrée à une app, car n’importe qui pourrait l’en extraire. Toute app qui crée des pass Wallet, qu’il s’agisse des apps des émetteurs ou des apps de création de pass, a donc besoin d’un serveur pour les signer.

Il existe une exception récente pour les pass que vous créez vous-même. Sur iOS 27, Apple indique que vous pouvez modifier certains champs et changer l’apparence d’un pass créé avec la fonction Créer une carte de Wallet. Les billets signés par une compagnie aérienne ou un organisateur ne peuvent toujours pas être modifiés.

Comment ouvrir un fichier .pkpass sur iPhone

En général, vous n’avez rien de particulier à faire. Dans Mail, Messages, Safari et la plupart des apps, toucher un fichier .pkpass ouvre l’aperçu de Wallet.

1. Touchez la pièce jointe, le lien ou le bouton « Ajouter à l’app Cartes d’Apple ».
2. Vérifiez l’aperçu : nom, date, place, vol ou numéro de membre.
3. Touchez Ajouter dans le coin supérieur.
4. Ouvrez l’app Cartes (Apple Wallet) pour retrouver le pass. Si vous avez une Apple Watch jumelée, Apple indique que le pass est aussi ajouté automatiquement à son Wallet.

Si vous avez enregistré le fichier dans Fichiers, le toucher depuis cette app devrait afficher le même aperçu. S’il ne se passe rien, ou si un message d’erreur apparaît, téléchargez à nouveau le fichier depuis l’e-mail ou le site d’origine. Si cela échoue encore, demandez un nouveau pass à l’émetteur.

Les styles de pass et ce qu’ils changent

Chaque pass a un style, défini dans pass.json, qui détermine sa mise en page et une partie de son comportement :

• Carte d’embarquement : vols, trains, bus et ferries, avec une origine, une destination et une icône de transport.
• Billet d’événement : concerts, matchs, théâtre, conférences.
• Carte de magasin : cartes de fidélité, de salle de sport, de bibliothèque et de membre.
• Coupon : offres et réductions.
• Générique : tout ce qui n’entre pas dans les autres catégories.

Un pass peut aussi inclure une date ou un lieu pertinents. Dans ce cas, Wallet peut le proposer sur l’écran verrouillé autour de ce moment ou de cet endroit. L’exemple d’Apple est une carte d’embarquement qui apparaît à l’approche de l’heure de départ.

Les codes-barres dans un pass

Le code-barres n’est pas stocké sous forme d’image. pass.json contient le message et le format du code-barres, et Wallet le dessine lui-même. Jusqu’à iOS 26, Wallet peut afficher quatre formats : QR, PDF417, Aztec et Code 128. À partir d’iOS 27, la documentation développeur d’Apple ajoute Code 39, Codabar, EAN-13 et ITF. UPC-A ne figure pas dans la liste d’Apple. Un pass peut aussi prévoir un code-barres de secours, pour que les iPhone plus anciens affichent un format qu’ils prennent en charge.

C’est important pour les pass faits maison. Quand le code-barres d’une carte de fidélité est dans un format que Wallet ne sait pas afficher, une app de création de pass peut réencoder le même numéro dans un autre format. Beaucoup de lecteurs le lisent quand même, mais certaines caisses n’acceptent que le format d’origine. Testez un tel pass avant de compter dessus.

Pass statiques et pass qui se mettent à jour

Un pass émis par une compagnie aérienne ou un organisateur peut inclure l’adresse d’un service web. Grâce à elle, l’émetteur peut envoyer une nouvelle version du pass quand quelque chose change, comme une porte, une place ou un horaire. Wallet remplace l’ancien pass et peut afficher une notification.

Les pass sans ce lien sont statiques : ils restent exactement tels qu’ils ont été créés. La plupart des pass faits maison sont statiques, ils n’afficheront donc ni retards, ni changements de porte, ni annulations. Vérifiez toujours ces informations auprès de la compagnie aérienne, de la compagnie ferroviaire ou de l’organisateur.

Certains billets n’existent pas du tout sous forme de fichier pkpass. Un code-barres qui change ou s’anime toutes les quelques secondes dans l’app d’un organisateur est conçu pour ne pas pouvoir être copié. Une capture d’écran de ce code, ou un pass créé à partir de lui, ne passera pas au scan. Utilisez l’app de l’organisateur pour ces billets, et munissez-vous d’une pièce d’identité si les conditions du billet l’exigent.

Quand il n’y a aucun fichier .pkpass

Beaucoup de billets et de cartes ne sont jamais fournis sous forme de pass. Vous recevez parfois un PDF, un code-barres dans un e-mail ou une carte en plastique. Voici vos options, en commençant par les solutions officielles :

1. Cherchez l’option de l’émetteur. Apple conseille de chercher « Ajouter à l’app Cartes d’Apple » dans une app, un e-mail, un message ou une page web. S’il n’y en a pas, Apple suggère de demander à l’émetteur s’il prend en charge Wallet. Les apps des compagnies aériennes et des organisateurs ajoutent souvent le pass pour vous.
2. Utilisez Créer une carte dans Wallet (iOS 27). Dans l’app Cartes (Apple Wallet), touchez Ajouter une carte → Créer une carte. Créez ensuite le pass manuellement à partir d’un modèle standard, adhésion ou événement, ou à partir d’une photo ou d’une capture d’écran d’un code-barres. La méthode par photo nécessite un iPhone 15 Pro ou ultérieur avec Apple Intelligence. Apple présente cette fonction comme utile pour des cartes de bibliothèque ou de salle de sport, par exemple, qui ont un code-barres mais pas de pass numérique.
3. Utilisez une app de création de pass. Ces apps lisent votre billet et créent pour vous un fichier .pkpass signé. Kardin en est un exemple. Elle convient à un billet qui n’existe qu’en PDF, ou à un iPhone sans Apple Intelligence. Vous partagez le PDF ou une photo vers Kardin depuis Mail, Fichiers ou Photos, ou vous scannez le code-barres avec l’appareil photo. Kardin lit la première page d’un PDF sur votre iPhone et décode le code-barres dans son format d’origine lorsqu’il s’agit d’un QR, PDF417, Aztec ou Code 128. Elle remplit ensuite les champs d’un pass de vol, de train, de bus, d’événement ou de carte. Vous vérifiez et modifiez chaque champ sur un écran de vérification avant de toucher « Ajouter à l’app Cartes d’Apple ». L’extraction peut manquer des informations si le texte est brouillon ou très petit, alors vérifiez attentivement l’écran de vérification.

Pour la marche à suivre complète, consultez comment ajouter un billet PDF à Apple Wallet. Si vous êtes devant l’entrée en ce moment même, consultez que faire quand votre billet PDF n’a pas de bouton Apple Wallet.

Côté confidentialité, comme chaque pass doit être signé sur un serveur, certaines données doivent quitter votre téléphone. Avec Kardin, vos fichiers et photos sont lus sur l’iPhone et ne sont jamais téléversés. Seul le contenu du pass est envoyé au serveur de Kardin pour être signé : les champs, la valeur et le format du code-barres, les couleurs et la date. Le serveur renvoie aussitôt le pass signé et ne le conserve pas. La page sécurité donne tous les détails.

Un fichier pkpass est-il sûr ?

Un fichier .pkpass ne contient que des données et des images. Il ne peut pas exécuter de code sur votre téléphone, et Wallet vous montre toujours un aperçu avant d’ajouter quoi que ce soit. Réfléchissez tout de même à ce que contient le pass :

• Les pass dans Wallet peuvent être ouverts sans Face ID ni code, et ils se synchronisent avec vos autres appareils via iCloud.
• Ne mettez donc jamais de numéros de carte bancaire, de codes PIN, de mots de passe, de codes de sécurité bancaires ou d’informations de pièce d’identité officielle dans un pass créé par une app tierce.
• Supprimez les pass dont vous n’avez plus besoin. Dans l’app Cartes (Apple Wallet), touchez le pass, puis le bouton Plus, et supprimez-le.

En résumé

• Un fichier .pkpass est un paquet ZIP qui contient les données du pass (pass.json), des images, une liste de sommes de contrôle et une signature délivrée par Apple.
• Touchez-le dans Mail, Messages, Safari ou Fichiers, vérifiez l’aperçu, puis touchez Ajouter.
• La moindre modification invalide la signature : pour corriger un pass, il faut en obtenir ou en créer un nouveau.
• Les pass des émetteurs peuvent se mettre à jour d’eux-mêmes. Les pass faits maison sont généralement statiques, et les codes-barres qui changent en continu ne peuvent pas être transformés en pass.
• Pas de pass ? Cherchez d’abord le bouton de l’émetteur, puis Créer une carte dans Wallet sur iOS 27, puis une app de création de pass comme Kardin pour les PDF et les photos.