Cycle de vie du billet
Comprenez comment les billets Aparté sont appariés, créés, actualisés et suivis dans le wallet.
Pourquoi le cycle de vie est important
Un ticket Wallet n'est pas seulement une copie statique d'un billet. Il doit rester aligné sur le dernier état du billet, surtout lorsqu'une place change, qu'un événement est mis à jour ou qu'une Carte est ajoutée à un appareil.
Le connecteur Aparté couvre ce cycle de vie, de la mise en correspondance des billets au suivi des installations Wallet.
Exemples concrets
Commande à plusieurs places: créer une Carte Wallet par place à partir d'une seule ligne de commande.
Mise à jour opérationnelle: actualiser la Carte après une modification du billet dans Aparté.
Suivi de l'adoption: enregistrer qu'un billet a été ajouté à un Wallet ou retiré d'un Wallet.
Comment les billets sont mis en correspondance
Chaque Carte est liée à un billet Aparté via id.aparte.ticketId.
Cette valeur utilise le format <orderItemId>|<seatId>. Elle permet de distinguer clairement les billets lorsqu'un article de commande contient plusieurs places.
Créer des Cartes à partir d'un article de commande
Le connecteur peut fonctionner à partir de aparte.orderItemId.
Lorsque cette valeur est renseignée, The Wallet Crew récupère les billets associés à cette ligne de commande, fait correspondre les Cartes existantes et crée automatiquement celles qui manquent. C'est utile dans les parcours de réservation et de confirmation, où une commande peut inclure plusieurs participants.
Comportement d'actualisation et de mise à jour
Aparté reste la source de vérité pour les données de billet. The Wallet Crew lit les données du billet lorsque la Carte doit être actualisée et utilise ces informations pour maintenir la version Wallet alignée.
Si l'API Aparté est temporairement indisponible, la Carte conserve les dernières informations valides jusqu'à ce qu'une actualisation ultérieure réussisse.
Suivi des installations Wallet
Le connecteur peut notifier Aparté lorsqu'une Carte est installée ou retirée d'Apple Wallet ou de Google Wallet.
Cela rend l'adoption Wallet mesurable au niveau du billet. C'est particulièrement utile pour le reporting, le suivi opérationnel et l'analyse du déploiement.
Routage avancé
Certains projets ont besoin de modèles Wallet différents selon les types de billets. C'est possible grâce au extensions.aparte.ticket.mapper hook et sa GetPassType méthode.
Cette partie n'est généralement nécessaire que pour les implémentations avancées. Une configuration standard peut souvent utiliser un seul modèle par défaut.
FAQ
Une ligne de commande peut-elle générer plusieurs Cartes ?
Oui. Si la ligne de commande contient plusieurs billets ou places, le connecteur peut créer une Carte par billet.
Mis à jour