Skip to content
Guide du centre d'aide · Distribution des passes
4 min de lectureVérifié 2026-11-16

Distribution en libre-service

Publiez des liens PassFlow publics, boutons embarqués, URL Wallet dynamiques et tags NFC NDEF en point de vente.

Dans ce guide

Permettre à vos clients de s'inscrire en autonomie 24h/24

Au-delà des imports CSV et des appels API backend, Passinstance vous permet de publier des points d'inscription en libre-service sans authentification préalable sur vos comptoirs physiques, pages de confirmation e-commerce, tickets de caisse et emballages produits :

CanalCas d'usage idéalFonctionnement
Formulaire public PassFlowAffiches comptoir, signatures e-mail, flyers QRLe client remplit un formulaire mobile (/p/:url), valide un code OTP par e-mail/SMS s'il est activé, règle le paiement optionnel et ajoute immédiatement sa carte.
Bouton / Widget Wallet embarquéPortails client, pages de confirmation de commandeIntégrez une iframe interactive ou un script de bouton Ajouter au Wallet directement dans le HTML de votre site web.
URL Wallet dynamiqueE-mails transactionnels, tableaux de bord SaaS, espaces fidélitéTransmettez des attributs clients paramétrés ou passez par upsert-by-external-id afin que l'utilisateur connecté récupère une carte préremplie en un geste.
Tag / autocollant NFC NDEFChevalets de table, comptoirs de caisse, affiches connectéesEncodez une URL publique PassFlow sur un tag NFC NDEF standard (NTAG213/215) pour qu'un simple contact avec un iPhone ou Android ouvre l'inscription sans scanner de QR code.

Architecture d'auto-inscription publique PassFlow

Le moteur PassFlow (PassFlow API exposé sur /api/v1/pass-flows/public/:url, avec l'alias /api/v1/passflows/public/:url et la route UI /f/:url) orchestre la collecte client multi-étapes non authentifiée (PassFlowType, PassFlowSubmissionStatus) avec protection anti-robots intégrée (SpamProtectionMode), vérification OTP, déduplication (externalId) et remise instantanée dans le portefeuille :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
AUTO-INSCRIPTION PUBLIQUE PASSFLOW
ÉTAPE 01 POINT D'ENTRÉE CLIENT (QR / URL / CONTACT NDEF)
GET/api/v1/pass-flows/public/:url (Charge le schéma du flux)
ÉTAPE 02 ÉTAPE 1 : FormStep (Attributs client & validation du consentement)
Récupère le jeton CSRF (/csrf-token) & valide request payload
ÉTAPE 03 ÉTAPES 2 & 3 : EmailStep / OtpStep (Vérification d'identité optionnelle)
Envoie le code via POST/api/v1/pass-flows/public/:url/otp/send
Vérifie le code OTP via POST/api/v1/pass-flows/public/:url/otp/verify
ÉTAPE 04 ÉTAPE 4 : PaymentStep (Abonnements payants, cartes cadeaux & billets optionnels)
Stripe PaymentIntent, PayPal Orders, Paystack, MTN MoMo, Orange Money
ÉTAPE 05 ÉTAPE 5 : PassStep (Upsert idempotent & ajout instantané au portefeuille)
Déduplique par email/phone/externalId (sémantique upsert-by-external-id)
Affiche bouton Apple Wallet .pkpass, JWT Google Wallet Save & QR code

Important : Pour empêcher la création de cartes en double lorsqu'un membre existant soumet à nouveau le formulaire, configurez les règles de déduplication / External ID sur votre modèle ou PassFlow (email, phone ou externalId). Vos portails backend peuvent aussi appeler directement POST /api/v1/passes/upsert-by-external-id pour renvoyer le passe actif existant au lieu d'en émettre un nouveau.

Référence API publique PassFlow & libre-service

MéthodeChemin du point d'entréePortée d'authentificationDescription
GET/api/v1/pass-flows/public/:urlPublicRécupère la configuration des étapes PassFlow (PassFlowStepType), le schéma de formulaire, le thème (page theme : `LIGHT \DARK \CUSTOM`) et les métadonnées d'aperçu du modèle.
GET/api/v1/pass-flows/public/:url/csrf-tokenPublicDélivre le jeton anti-CSRF requis avant la soumission d'une génération de passe publique.
POST/api/v1/pass-flows/public/:url/generatePublicSoumet la charge utile d'inscription (request payload : userData, recaptchaToken?, botProtectionToken?) pour créer ou récupérer le passe.
POST/api/v1/pass-flows/public/:url/otp/sendPublic (limité en débit)Envoie un code à usage unique (POST .../otp/resend pour renvoyer) pendant OtpStep.
POST/api/v1/pass-flows/public/:url/otp/verifyPublic (limité en débit)Vérifie le code OTP saisi et débloque l'émission du passe.
POST/api/v1/pass-flows/public/:url/payment-intentPublicInitialise un PaymentIntent Stripe (GET .../payment-config, /paypal-order, /paystack/initialize, /mtn-momo/request-to-pay, /orange-money/initiate).
POST/api/v1/passes/upsert-by-external-idClé API (passes)request payload — crée (CREATED) ou met à jour (UPDATED) de façon idempotente le passe client indexé par externalId.

Exemple : inscription idempotente depuis un portail via upsert-by-external-id

Lorsqu'un bouton Ajouter au Wallet est intégré dans votre espace client authentifié ou application web, appelez POST /api/v1/passes/upsert-by-external-id depuis votre backend puis redirigez l'utilisateur vers passAccessUrl :

JSON
POST /api/v1/passes/upsert-by-external-id
{
  "templateId": "7b9e4c12-3f81-4a90-b8d2-19c48a70e112",
  "externalId": "USR-90214",
  "status": "ACTIVE",
  "attributes": {
    "firstName": "Elena",
    "lastName": "Rostova",
    "email": "elena.rostova@example.com",
    "tier": "Gold",
    "points": 1250
  }
}

Réponse (200 OK) :

JSON
{
  "success": true,
  "data": {
    "pass": {
      "id": "c41a8d20-6e11-4f3b-9a81-0029d81a4f10",
      "serialNumber": "PI-8849-2026-X9",
      "externalId": "USR-90214",
      "bundleId": null,
      "status": "ACTIVE",
      "walletVoidStatus": "QUEUED",
      "passAccessUrl": "https://app.passinstance.com/p/c41a8d20-6e11-4f3b-9a81-0029d81a4f10"
    },
    "action": "UPDATED"
  },
  "description": "Pass updated successfully",
  "errors": [],
  "statusCode": 200
}

Encodage de tags NFC NDEF en point de vente

Pour déployer des chevalets d'inscription sans contact à la caisse sans matériel lecteur Apple VAS ni Google Smart Tap :

  1. 1
    Copiez votre URL publique PassFlow (par exemple https://app.passinstance.com/f/coffee-club-vip).
  2. 2
    Utilisez n'importe quelle application d'écriture NFC standard (telle que NFC Tools) pour écrire un enregistrement NDEF URI Record sur un autocollant NTAG213, NTAG215 ou NTAG216, puis activez Verrouiller en lecture seule afin qu'aucun client ne puisse écraser l'URL.
  3. 3
    Lorsqu'un client approche son iPhone ou smartphone Android déverrouillé du support, le système ouvre automatiquement la page d'inscription PassFlow dans Safari ou Chrome.

Consultez le guide Formulaires d'inscription & PassFlow ainsi que le Guide des intégrations pour les paramètres d'intégration et les déclencheurs webhook.

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.