Flux d’inscription
Comprenez comment les flux d’inscription créent des cartes et à quel moment des identifiants sont associés à une carte.
flux d’inscription
Un flux d’enrôlement est le moment où une Carte est créée et liée à un véritable dossier client ou dossier entreprise. C’est là que les identifiants externes sont rattachés à la Carte pour la première fois. Cette étape est importante, car les rendus ultérieurs dépendent de ces identifiants pour récupérer des données en direct depuis les systèmes sources.
L’enrôlement n’est pas une étape de synchronisation ultérieure. La Carte est créée pendant le flux lui-même, puis l’artéfact Wallet peut être construit à partir de ce nouveau dossier Carte. Si des identifiants sont manquants ou incorrects au moment de l’enrôlement, les données pilotées par le connecteur manqueront lors des rendus ultérieurs.
Exemples concrets
Un flux d’inscription au programme de fidélité crée une Carte après la création du compte client dans un CRM.
Un flux d’achat de billet crée une Carte après le paiement et y associe l’ID du billet.
Un flux de renouvellement d’adhésion crée une Carte de remplacement et la relie au dossier client existant.
Ce qu’un flux d’enrôlement fait
Un flux d’enrôlement crée une Carte et y attache les données minimales nécessaires aux rendus futurs.
En pratique, cela signifie généralement :
Un système source ou un flux de frontend identifie le client ou la transaction.
Le flux crée une Carte ou déclenche la création de Carte.
Les identifiants externes sont rattachés à la Carte au moment de la création.
La Carte peut ensuite être rendue pour l’installation dans Wallet.
L’enregistrement Carte créé lors de l’enrôlement est volontairement léger. Il stocke les identifiants, des données supplémentaires facultatives et des champs internes de la plateforme. Les données source restent dans les systèmes en amont.
Si le modèle de données de Carte a besoin d’un rappel, commencez par Données de Carte et synchronisation.
Schémas d’enrôlement courants
Flux du SDK Cinto
Le SDK Cinto est l’option principale lorsqu’un flux web ou d’application personnalisé doit créer des Cartes directement pendant l’enrôlement.
Ce schéma est courant lorsqu’un frontend gère déjà l’inscription, le paiement, l’enregistrement ou la complétion du profil. Le SDK crée la Carte dans le cadre de ce flux et fournit les identifiants externes dont les connecteurs auront besoin plus tard.
Utilisez le documentation du SDK Cinto pour le flux d’implémentation.
Enrôlement piloté par le backend (API personnalisée)
Utilisez ce schéma lorsqu’un backend crée le client, la commande, l’adhésion ou l’enregistrement du billet. Les identifiants externes doivent exister dans ce backend avant la création de la Carte.
Appelez POST /passes avec ces identifiants pour créer la Carte. Voir Cycle de vie de la Carte → Création d’une carte.
Construisez l’URL de livraison résultante avec un identifiant externe signé. Voir URLs de livraison de Carte.
Formulaire d’enrôlement intégré
La plateforme inclut également un formulaire d’enrôlement intégré avec une étape de Carte.
Ce schéma est utile lorsque le projet souhaite un flux d’enrôlement hébergé plutôt qu’une implémentation entièrement personnalisée. La même règle s’applique : la Carte est créée pendant le flux, et les identifiants doivent être disponibles à ce moment-là.
Cette page se concentre sur le moment de la création et les identifiants requis. Les détails de configuration de l’interface utilisateur peuvent être documentés séparément si nécessaire.
Création déclenchée par la source
Certains projets créent des Cartes à partir d’un événement côté source plutôt qu’à partir d’un formulaire destiné à l’utilisateur. Dans ce modèle, un événement du système externe déclenche la création de Carte et le client installe la Carte plus tard.
Ce schéma est abordé dans création de carte déclenchée par connecteur.
Ce qui doit exister au moment de la création
L’entrée la plus importante au moment de l’enrôlement est l’ensemble des identifiants externes.
Sans eux, les connecteurs ne peuvent pas localiser le bon client, la bonne commande, la bonne adhésion ou le bon enregistrement de billet lors des rendus ultérieurs. Une Carte peut exister sans identifiants utiles, mais elle se comportera comme un enregistrement isolé sans moyen fiable de récupérer les données source.
Des données supplémentaires peuvent également être définies au moment de la création lorsqu’une valeur doit résider sur la Carte elle-même. C’est utile pour des remplacements au niveau de la Carte ou pour des valeurs qui n’existent dans aucun système source.
Utilisez le documentation du SDK Cinto pour les détails d’implémentation lorsque le flux crée des Cartes directement, et utilisez Données de Carte et synchronisation pour savoir comment les identifiants et les données supplémentaires sont utilisés plus tard.
Ce qui se passe après l’enrôlement
La création de la Carte ne crée pas de lien en arrière-plan qui maintient automatiquement le contenu de Wallet à jour.
Après l’enrôlement, le contenu de Wallet ne change que lorsqu’un déclencheur de rendu se produit, comme l’installation, l’aperçu ou la mise à jour push. Chaque rendu récupère à nouveau les données en direct du connecteur à l’aide des identifiants stockés pendant l’enrôlement.
Utilisez Premiers pas avec l’API pour les premiers appels de mise à jour au niveau du tenant une fois qu’une Carte existe déjà.
Liste de validation
Un flux d’enrôlement valide doit confirmer trois choses.
La Carte est créée avec succès.
Les identifiants externes attendus existent sur la Carte.
Un rendu ultérieur peut récupérer les données source à l’aide de ces identifiants.
Un schéma de validation rapide consiste à créer une Carte de test, à inspecter les identifiants dans le back-office, puis à déclencher un rendu ou une mise à jour push et à confirmer que les champs alimentés par le connecteur se résolvent correctement.
FAQ
Les identifiants externes peuvent-ils être rattachés plus tard s’ils manquaient au moment de l’enrôlement ?
Ils doivent être considérés comme des données de création. Un flux est plus fiable lorsque les identifiants sont corrects au moment où la Carte est créée.
Mis à jour