This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mises à jour, cycle de vie et état d'installation

Comprenez les comportements de mise à jour par rapport à désactivation, les scénarios courants de modification des billets et la façon dont l'état d'installation est répercuté dans Secutix.

Cette intégration est conçue pour le changement. Les billets d’événement sont réimprimés, échangés, déplacés et annulés. The Wallet Crew maintient la Carte Wallet alignée avec Secutix. Parfois, cela signifie mettre à jour une Carte. Parfois, cela signifie l’invalider.

Comment fonctionne l’intégration

Secutix reste la source de vérité pour les données de billet et de contact, et The Wallet Crew n’ajoute que la couche Wallet. The Wallet Crew ne stocke pas l’ensemble de vos données de billets. Chaque Carte reste liée à Secutix via des identifiants externes : secutix.movementId pour les billets d’événement et secutix.contactNumber pour les cartes membres. Lorsqu’une Carte est créée ou mise à jour, The Wallet Crew appelle les services web Secutix pour récupérer les dernières données, puis reconstruit la charge utile de la Carte et envoie la mise à jour aux appareils.

Integration schema showing Secutix as the source of truth, The Wallet Crew syncing ticket changes, and Apple Wallet / Google Wallet passes being updated.
Schéma d’intégration : The Wallet Crew récupère les changements et pousse le billet Secutix vers Apple Wallet et Google Wallet.

Comment fonctionnent les mises à jour

Secutix peut modifier les billets de plusieurs façons, comme via la billetterie (en libre-service) ou le back office (actions d’agent). Lorsqu’un changement survient, Secutix avertit The Wallet Crew via webhook. Ensuite, le connecteur met à jour la Carte existante ou invalide l’ancienne.

Exemples concrets
  • Le changement de l’heure de début dans le back office Secutix. La Carte Wallet se met à jour en quelques secondes.

  • Le client réimprime. Le code-barres change. La Carte Wallet se rafraîchit.

  • L’échange crée un nouveau billet. L’ancienne Carte est invalidée. La nouvelle Carte devient valide.

  • Le remboursement désactive la Carte afin qu’elle ne puisse pas être scannée.

Matrice des scénarios de mise à jour de Carte

Utilisez cette matrice pour prévoir ce que les utilisateurs Wallet vivront. Elle aide aussi les équipes support à répondre rapidement à « pourquoi mon billet a-t-il changé ? ».

Cas d’usage
Possible depuis la billetterie
Possible dans le back office
Nouvelle transaction Secutix
Nouveau billet généré
Nouvel ID de mouvement
Nouvel ID de commande
Nouvel ID de fichier
E-mail transactionnel Secutix envoyé
Carte à mettre à jour dans Wallet
Ancienne Carte à désactiver dans Wallet

Changement du titre ou de l’horaire d’un événement

Oui

Oui

Réimpression d’un billet

Oui

Oui

Oui

Oui

Changement du nom du titulaire du billet

Oui

Oui

Oui

Oui

Changement du contact culturel

Oui

Oui

Remplacement d’un spectateur

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Échange de billet

Oui

Oui

Oui

Oui

Oui

Oui

Oui

Annulation d’un billet

Oui

Oui

Oui

Oui

Mise à jour du statut d’installation

Références externes de mouvement

Le statut d’installation est utile pour le reporting et l’automatisation post-achat. Lorsqu’il est activé, il écrit les signaux d’installation de Wallet dans Secutix.

Si vous activez Conserver le statut d’installation, The Wallet Crew conserve le statut d’installation du billet dans les références externes de mouvement.

Ces données sont tenues à jour dans le temps. Si un utilisateur désinstalle la Carte, le statut est mis à jour en conséquence. S’il la réinstalle plus tard, les mêmes champs sont écrasés avec le dernier statut et l’appareil.

Persist installation status option in the Secutix connector settings.
Option Conserver le statut d’installation dans les paramètres du connecteur Secutix.

Ces clés sont ajoutées :

  • twc.passId: identifiant de Carte The Wallet Crew

  • twc.passType: nom du modèle utilisé pour le billet

  • twc.status: installée ou désinstallée

  • twc.device: apple, google, apple+google ou - après désinstallation de la Carte.

Statut d’impression

Lors du premier ajout à Apple Wallet ou Google Wallet, The Wallet Crew définit le statut du billet Secutix sur IMPRIMÉ. Dans Secutix, IMPRIMÉ signifie que l’acheteur a récupéré le billet.

Utilisez cela lorsque vous avez besoin du suivi natif de récupération de Secutix. Cela aide pour les rapports de conformité. Cela peut aussi permettre des flux de revente (selon votre configuration de revente Secutix) qui nécessitent IMPRIMÉ.

C’est à sens unique. The Wallet Crew ne rétablit pas IMPRIMÉ si la Carte est supprimée. La suppression ne signifie pas que le billet est inutilisable.

Update printing status option in the Secutix connector settings.
Option de mise à jour du statut d’impression dans les paramètres du connecteur Secutix.

FAQ

À quelle vitesse les billets Secutix se mettent-ils à jour dans Apple Wallet et Google Wallet ?

Par défaut, les webhooks de changement Secutix s’exécutent toutes les ~10 minutes.

Après que The Wallet Crew reçoit le webhook, la mise à jour du Wallet est généralement envoyée en quelques secondes.

Qu’est-ce qui déclenche la mise à jour d’une Carte Wallet par rapport à un billet invalidé (annulé) ?

Les modifications simples généralement mettent à jour la Carte existante.

Les actions qui génèrent un nouveau billet (échange, remplacement) invalident l’ancienne Carte et activent la nouvelle.

Les participants doivent-ils rajouter le billet après un changement ?

Non. La Carte est automatiquement mise à jour ou invalidée.

Mon billet semble obsolète. Que dois-je faire ?

Il s’agit généralement d’un problème d’actualisation de l’appareil.

Demandez au participant de :

  • Vérifier la connexion.

  • Fermer puis rouvrir l’application Wallet.

Si nécessaire, supprimer puis ajouter de nouveau à partir du lien d’origine.

Puis-je envoyer une notification Wallet pour des changements de dernière minute ?

Oui. Utilisez les notifications Wallet pour les mises à jour urgentes le jour de l’événement.

Texte suggéré :

  • « Mise à jour : les détails de votre billet ont changé. Veuillez ouvrir votre carte Wallet. »

  • « Mise à jour : vos informations d’entrée ont changé. Votre carte Wallet est à jour. »

Notifications géolocalisées : pouvons-nous notifier les utilisateurs lorsqu’ils sont près du lieu ?

Oui. Vous pouvez déclencher une notification lorsque les participants sont près du lieu. Cela fonctionne pour Apple Wallet et Google Wallet.

Rayon de départ recommandé : 50 mètres. Augmentez-le pour les grands lieux ou les sites à entrées multiples.

Example of geolocated notification
Exemple de notification géolocalisée.
Max distance setting for geolocated notifications
Paramètre de distance maximale pour les notifications géolocalisées.

Si vous devez vérifier à nouveau comment les billets sont livrés aux utilisateurs, allez à Distribution.

Mis à jour