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 :
| Canal | Cas d'usage idéal | Fonctionnement |
|---|---|---|
| Formulaire public PassFlow | Affiches comptoir, signatures e-mail, flyers QR | Le 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 commande | Intégrez une iframe interactive ou un script de bouton Ajouter au Wallet directement dans le HTML de votre site web. |
| URL Wallet dynamique | E-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 NDEF | Chevalets de table, comptoirs de caisse, affiches connectées | Encodez 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 :
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 (
phoneouexternalId). Vos portails backend peuvent aussi appeler directementPOST /api/v1/passes/upsert-by-external-idpour renvoyer le passe actif existant au lieu d'en émettre un nouveau.
Référence API publique PassFlow & libre-service
| Méthode | Chemin du point d'entrée | Portée d'authentification | Description | ||
|---|---|---|---|---|---|
| GET | /api/v1/pass-flows/public/:url | Public | Ré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-token | Public | Délivre le jeton anti-CSRF requis avant la soumission d'une génération de passe publique. | ||
| POST | /api/v1/pass-flows/public/:url/generate | Public | Soumet 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/send | Public (limité en débit) | Envoie un code à usage unique (POST .../otp/resend pour renvoyer) pendant OtpStep. | ||
| POST | /api/v1/pass-flows/public/:url/otp/verify | Public (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-intent | Public | Initialise 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-id | Clé 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 :
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) :
{
"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
Copiez votre URL publique PassFlow (par exemple
https://app.passinstance.com/f/coffee-club-vip). -
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
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.
