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

Ajouter un passe à votre Wallet

Guide grand public pour enregistrer une carte sur iPhone (Apple Wallet), Android (Google Wallet) ou depuis un PC.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé
Éléments clés de l'interface

Aperçu en direct double Wallet (Zoom)

Basculez entre Apple et Google dans le panneau d'aperçu pour vérifier les visuels, le formatage du solde, la lisibilité du QR code et l'alignement des champs.

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.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : ROUTAGE INTELLIGENT ET TRANSFERT AU PORTEFEUILLE
ÉTAPE 01 LE DÉTENTEUR OUVRE LE LIEN (GET/d/:slug, /download/:slug ou /s/:token)
Public Download Page inspecte User-Agent et les contrôles
ÉTAPE 02A FLUX APPLE WALLET
Diffuse un ZIP signé application/vnd. apple.pkpass
Synchro Apple Watch
ÉTAPE 02B REDIRECTION JWT GOOGLE
Signe le JWT Objet RS256
Redirige vers https:// pay.google.com/gp/v/save
Enregistre sur Google
ÉTAPE 02C TRANSFERT QR BUREAU
Affiche une page adaptative avec un code QR scannable par l'appareil photo

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 routeMéthodeObjectif
/d/:slugGETLien 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/:slugGETPage 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/:tokenGETLien à 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. 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. 2
    Touchez Ajouter à Apple Cartes (Add to Apple Wallet) — iOS reconnaît immédiatement le paquet application/vnd.apple.pkpass et fait glisser la feuille d'aperçu native du pass.
  3. 3
    Touchez Ajouter dans le coin supérieur droit de l'écran d'aperçu.
  4. 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. 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. 1
    Ouvrez votre lien de pass dans Google Chrome ou dans votre navigateur Android par défaut.
  2. 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. 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. 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 :

JSON
{
  "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.

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.