Fonctionnement de l'installation intelligente d'un pass
L'ajout d'une carte de fidélité, d'un billet d'événement, d'une carte de membre ou d'un coupon sur votre smartphone prend moins de 10 secondes et ne nécessite aucun téléchargement d'application tierce. Lorsque vous ouvrez un lien intelligent Passinstance, le backend détecte le système d'exploitation de votre appareil et vous dirige soit vers une archive .pkpass Apple Wallet (signée avec le Pass Type ID bundleId du commerçant), soit vers un JWT d'enregistrement Google Wallet signé en RS256.
Points de terminaison de distribution intelligente
Passinstance sert les flux d'installation pour les détenteurs de passes via trois modèles de routes publiques gérés par Download Page API et Public Download Page :
| Modèle de route | Méthode | Objectif |
|---|---|---|
/d/:slug | GET | Lien court personnalisé pour les SMS, affiches QR et campagnes d'e-mailing. Effectue une détection automatique de l'OS et le transfert vers le portefeuille. |
/download/:slug | GET | Page de téléchargement explicite affichant l'aperçu du pass, le thème de la marque et les boutons Add to Wallet propres à chaque plateforme. |
/s/:token | GET | Lien à jeton d'accès signé cryptographiquement par détenteur de pass, avec expiration facultative (downloadUntil) et vérification par code PIN. |
Guide étape par étape pour les détenteurs de passes
1. Sur iPhone et Apple Watch (Apple Wallet)
-
1
Touchez votre lien de pass personnel pour l'ouvrir dans Safari (si vous avez touché le lien depuis Instagram, TikTok ou LinkedIn, touchez l'icône de navigateur dans le coin inférieur droit pour l'ouvrir dans Safari natif).
-
2
Touchez Ajouter à Apple Cartes (Add to Apple Wallet) — iOS reconnaît immédiatement le paquet
application/vnd.apple.pkpasset fait glisser la feuille d'aperçu native du pass. -
3
Touchez Ajouter dans le coin supérieur droit de l'écran d'aperçu.
-
4
Synchronisation Apple Watch : Si vous portez une Apple Watch jumelée, iOS réplique automatiquement les passes éligibles dans l'application Cartes à votre poignet.
-
5
Accès rapide : Appuyez deux fois sur le bouton latéral de votre iPhone à tout moment pour afficher votre pass enregistré lors du passage en caisse ou à l'entrée d'un événement.
2. Sur Android (Google Wallet)
-
1
Ouvrez votre lien de pass dans Google Chrome ou dans votre navigateur Android par défaut.
-
2
Touchez Ajouter à Google Wallet (Add to Google Wallet) — cela ouvre la feuille d'enregistrement authentifiée de Google (
https://pay.google.com/gp/v/save/<jwt>). -
3
Vérifiez que le compte Google affiché en haut de l'invite correspond au compte connecté à l'application Google Wallet de votre téléphone, puis touchez Ajouter à Wallet.
-
4
Touchez Afficher dans Wallet pour présenter immédiatement votre code-barres ou votre pass sans contact NFC.
3. Ouverture d'un lien de pass sur un ordinateur portable ou de bureau
Les ordinateurs de bureau n'exécutent pas nativement Apple Wallet ou Google Wallet. Lorsque vous ouvrez un lien /d/:slug ou /s/:token sur macOS ou Windows :
{
"detectedPlatform": "DESKTOP",
"handoffMode": "QR_CODE_LANDING_PAGE",
"qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
"instructions": "Scan this QR code with your iPhone or Android camera to add the pass directly to your phone."
}
Pointez l'appareil photo de votre iPhone ou de votre téléphone Android vers le code QR affiché à l'écran et touchez la bannière qui apparaît pour terminer l'installation sur votre téléphone.
Important : Certains émetteurs protègent les cartes VIP de grande valeur ou les badges d'employés par une liaison à un appareil unique (
limitToOneActivePerPass: true) ou par un code PIN de téléchargement. Si vous y êtes invité, saisissez le code PIN envoyé par e-mail ou par SMS avant de toucher Ajouter au portefeuille.
Vous rencontrez des difficultés pour installer votre carte ? Consultez Résoudre les problèmes de portefeuille ou découvrez comment retrouver une carte existante dans Retrouver ou récupérer votre pass.
