Wallet

Comprenez comment les cartes sont créées, mises à jour et rendues dans The Wallet Crew.

Wallet

Le travail sur Wallet dans The Wallet Crew suit un cycle de vie simple. Une carte est créée via le SDK Cinto, un événement de connecteur, ou POST /passes. Utilisez POST /passes pour les flux pilotés par le back-end. Après sa création, les modèles contrôlent ce qui apparaît dans Apple Wallet et Google Wallet.

Exemples concrets

• Une carte de fidélité est créée lors de l'inscription du compte, puis actualisée après chaque achat.
• Une carte billet est créée à partir d'un événement de commande, puis mise à jour lorsque les données de porte ou de siège changent.
• Une carte d'adhésion est créée après l'inscription, puis maintenue à jour grâce aux données du connecteur et aux substitutions au niveau de la carte.

Choisissez le bon flux de création

flux d’inscription

Utilisez flux d’inscription lorsque la création de la carte a lieu pendant l'inscription, le paiement, l'enregistrement ou un autre parcours orienté utilisateur. C'est le schéma habituel lorsqu'un flux web, un flux d'application ou un formulaire hébergé contrôle l'émission.

création de carte déclenchée par connecteur

Utilisez création de carte déclenchée par connecteur lorsqu'un système amont décide de l'éligibilité et crée la carte à partir d'un événement. C'est courant pour une émission pilotée par CRM, billetterie ou abonnement.

La création de cartes est prise en charge via le SDK Cinto, les connecteurs et POST /passes. Utilisez POST /passes pour les flux pilotés par le backend. Voir Cycle de vie de la Carte → Création d’une carte.

Créer et maintenir la carte

Une fois qu'une carte existe, l'étape suivante consiste généralement à décider comment les champs du Wallet sont renseignés et actualisés. Mettre à jour les données de la carte dans les modèles explique comment les valeurs stockées et les données du connecteur atteignent le modèle. Moteur de templating documente le comportement Liquid pris en charge utilisé dans ces modèles.

Si le modèle de données de la carte a d'abord besoin d'un rappel, utilisez Données de la carte et synchronisation.

Pages de cette section

• flux d’inscription explique la création de cartes orientée utilisateur.
• création de carte déclenchée par connecteur explique la création de cartes pilotée par la source.
• Mettre à jour les données de la carte dans les modèles explique comment mettre à jour les cartes existantes et afficher les bonnes valeurs.
• Moteur de templating explique la syntaxe Liquid prise en charge, les filtres et le comportement en cas d'erreur.

FAQ

Peut-on créer des cartes directement avec l'API ?

Oui. La création de Carte est prise en charge via le SDK Cinto, les connecteurs et POST /passes. Utilisez POST /passes pour les flux pilotés par le backend. Voir Cycle de vie de la Carte → Création d’une carte.

Quelle page faut-il lire en premier ?

Commencez par le flux de création qui correspond au projet. Poursuivez ensuite avec le guide de mise à jour et la référence de templating.

Quand la référence de templating est-elle nécessaire ?

Utilisez-la lorsqu'un modèle doit afficher des valeurs dynamiques, des conditions ou une sortie formatée. Le guide de mise à jour est généralement un meilleur point de départ pour le travail quotidien.