Skip to content
Guide du centre d'aide · Distribution des passesPhase d'intégration 5
5 min de lectureVérifié 2026-11-16

Liens de téléchargement & PassFlow

Personnalisez la page PassFlow adaptative iOS/Android, PassTour, code PIN, limites d'installation et mise en pause d'urgence.

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é1 / 2
Éléments clés de l'interface

Limites d'émission et contrôles d'accès (Zoom)

Configurez une émission illimitée ou limitée, les canaux d'accès, le routage Wallet et des sécurités comme le blocage du re-téléchargement et la déduplication des destinataires.

Aperçu & architecture des points d'entrée intelligents

Chaque passe émis et chaque lien de distribution de modèle dans Passinstance est servi par un moteur de téléchargement intelligent adaptatif à la plateforme (modèle DownloadPage et contrôleur Download Page API). Plutôt que de diffuser des liens distincts pour Apple et Android, vous distribuez une URL canonique unique (passAccessUrl, /d/:slug ou /s/:token) qui inspecte dynamiquement l'en-tête HTTP User-Agent, le contexte du navigateur et les règles de sécurité avant de délivrer la charge utile adaptée.

Accès à la distribution et interrupteurs de sécurité des liens
Accès à la distribution et interrupteurs de sécurité des liens
FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
ROUTAGE INTELLIGENT DE TÉLÉCHARGEMENT & RELAIS OS
ÉTAPE 01 REQUÊTE HTTP GET CLIENT ENTRANTE
GET/d/:slug | GET/download/:slug | GET/s/:token
ÉTAPE 02 PIPELINE DE CONTRÔLE D'ACCÈS & VALIDATION DE JETON
1
Vérifier le statut passe/modèle (ACTIVE, passDownloadDeactivated = false)
2
Contrôler date limite & verrou (enableDownloadUntil, limitToOneActivePerPass)
3
Évaluer le code PIN (?pin= / X-Wallet-Experience-Pin si activé)
iOS Safari / WebKit
ÉTAPE 03A Flux binaire .pkpass
Content-Type: application/vnd.apple. pkpass
Android Chrome
ÉTAPE 03B Redirection 302
vers JWT Google pay.google.com/ gp/v/save/<jwt>
Desktop / WebView In-App
ÉTAPE 03C Page PassFlow + QR
dynamique (GET/d/:slug/qr) +
E-mail/SMS & PassTour

Détection dynamique du User-Agent & comportement par plateforme

  1. 1
    iPhone & iPad (iOS Safari) : Transmet directement l'archive .pkpass signée cryptographiquement avec le type MIME Content-Type: application/vnd.apple.pkpass, ouvrant immédiatement la feuille modale native iOS Ajouter à Cartes.
  2. 2
    WebViews intégrées sur iOS (Instagram, TikTok, Facebook, LinkedIn) : Comme les navigateurs intégrés des réseaux sociaux bloquent les flux binaires application/vnd.apple.pkpass, Passinstance détecte ce User-Agent et affiche un écran d'accompagnement guidant le titulaire pour ouvrir le lien dans Safari.
  3. 3
    Appareils Android : Effectue une redirection HTTP 302 (ou affiche un bouton Add to Google Wallet en un tap) vers https://pay.google.com/gp/v/save/<signed_jwt>, provisionnant directement le LoyaltyObject, EventTicketObject ou GenericObject dans Google Wallet.
  4. 4
    Navigateurs sur ordinateur : Affiche une page PassFlow responsive aux couleurs de votre marque avec un QR code dynamique à fort contraste (GET /d/:slug/qr) ainsi que les options d'envoi autonome par e-mail ou SMS (POST /d/:slug/send-link-by-email, POST /d/:slug/send-link-by-sms) pour transférer le passe sur smartphone en quelques secondes.

Important : Lorsque le verrouillage sur un seul appareil (limitToOneActivePerPass: true) est activé sur un modèle ou un passe (sharingProhibited), le lien de téléchargement intelligent se verrouille automatiquement dès qu'un premier appareil termine son enregistrement Apple Wallet Web Service (POST /v1/devices/:deviceLibraryIdentifier/registrations/...) ou son callback save Google Wallet, empêchant tout partage non autorisé du lien.

Points d'entrée API des liens intelligents & pages de téléchargement

Les routes publiques de résolution sont exposées hors du préfixe /api/v1 via Public Download Page et Public Pass Recovery API (/d/:slug/* et l'alias /download/:slug/*, en complément des routes d'administration authentifiées sous /api/v1/download-pages/*) :

MéthodeChemin du point d'entréePortée d'authentificationDescription technique
GET/d/:slugPublicRouteur principal du lien intelligent ; redirige les navigateurs vers /download/:slug ou sert les métadonnées JSON selon la requête ; accepte ?pass=:passId, ?lang=, ?pin=.
GET/d/:slug/infoPublicRetourne les métadonnées JSON (request payload), les jetons visuels de marque, les étapes PassTour et la disponibilité du passe.
GET/d/:slug/qrPublicGénère une image QR code scannable encodant l'URL intelligente de téléchargement.
GET/d/:slug/downloadPublicAnalyse le User-Agent et délivre le .pkpass (iOS) ou la redirection JWT Google Save (Android) ; tient compte de ?pin= ou X-Wallet-Experience-Pin.
POST/d/:slug/createPublic (limité en débit)Émet un passe directement depuis la page de téléchargement (request payload : name, email?, phone?, additionalFields?).
POST/d/:slug/send-link-by-emailPublic (limité en débit)request payload ({ email, passLink? }) — envoie le lien de téléchargement par e-mail depuis la vue bureau.
POST/d/:slug/send-link-by-smsPublic (limité en débit)request payload ({ phoneNumber, passLink? }) — expédie le lien de téléchargement par SMS au format E.164.
POST/d/:slug/request-recoveryPublic (limité en débit){ emailOrPhone } — envoie un lien magique de récupération lorsqu'un client change de téléphone ou perd son lien.
GET/s/:tokenPublicLien intelligent canonique rattaché au serialNumber / jeton d'un passe individuel.

Sécurité par jeton, protection par code PIN & envoi secondaire

Vous pouvez définir des garde-fous granulaires au niveau du modèle comme lors de l'émission d'un passe individuel :

  • Expiration du téléchargement (enableDownloadUntil) : Appliquez un horodatage "YYYY-MM-DD HH:mm" ou ISO après lequel les liens non réclamés cessent de délivrer de nouveaux passes, tandis que les cartes déjà installées restent actives dans les portefeuilles clients.
  • Verrouillage sur appareil unique (limitToOneActivePerPass) : Bloque tout nouveau téléchargement dès qu'un enregistrement d'appareil actif existe sur le passe.
  • Protection par code PIN (pin en query param / en-tête X-Wallet-Experience-Pin) : Exigez des titulaires qu'ils déverrouillent les liens de téléchargement et bundles .pkpasses protégés avant installation (vérifié via POST /api/v1/pass-projects/:id/validate-pin sur les Wallet Experiences).
  • Mise en pause d'urgence (passDownloadDeactivated) : Interrupteur d'arrêt immédiat dans les paramètres du modèle qui bloque tout nouveau téléchargement sur l'ensemble des canaux sans révoquer les cartes déjà installées.
  • Priorité de résolution (?pass=:passId) : La résolution publique évalue successivement la disponibilité spécifique du passe (P1), les valeurs par défaut de la page de téléchargement (P2) et les réglages de repli de l'espace de travail (P3), tandis que pass bundle (bundleId) coordonne les téléchargements .pkpasses entre cartes liées.
  • Superpositions PassTour optionnelles : Accompagnez les nouveaux utilisateurs Apple et Google Wallet grâce à des instructions visuelles interactives (Guide PassTour).

Exemple : charges utiles d'envoi secondaire & de récupération

Lorsqu'un client consulte un passe sur ordinateur ou perd l'accès à sa carte wallet, la page PassFlow appelle les points d'entrée d'action publics :

JSON
POST /d/vip-gold-2026/send-link-by-email
{
  "email": "alex.rivera@example.com",
  "passLink": "https://app.passinstance.com/d/vip-gold-2026?pass=pass_01j8k9m2"
}
JSON
POST /d/vip-gold-2026/request-recovery
{
  "emailOrPhone": "alex.rivera@example.com"
}

Consultez également la documentation associée sur Distribution en libre-service, Envoi par e-mail & SMS et Retrouver ou récupérer votre passe.

Documentation produit et développeur associée

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.