Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Yurplan

Connecter Yurplan à The Wallet Crew pour distribuer des billets d’événement dans Apple Wallet et Google Wallet depuis les pages de confirmation et les e-mails, avec des données de carte synchronisées.

Yurplan est une plateforme de billetterie pour la vente d'événements et la gestion des participants. The Wallet Crew ajoute la couche Wallet par-dessus, de sorte que les billets Yurplan puissent être distribués comme Apple Wallet et Google Wallet cartes, depuis la page de confirmation Yurplan et l'e-mail de confirmation.

Yurplan reste la source de vérité. Il contrôle les données des billets et l'état des billets. The Wallet Crew gère la création des cartes, la distribution et les mises à jour côté Wallet, et aucune base de données de billets en double n'est nécessaire.

Exemples concrets
  • Solution de secours par e-mail de confirmation: la même commande expose également un Ajouter à Wallet point d'entrée dans l'e-mail de confirmation.

  • Suivi du contrôle à l'entrée: lorsqu'un billet est contrôlé sur le lieu, la carte est actualisée depuis Yurplan, y compris le nombre de scans.

Fonctionnement du connecteur

Le connecteur écoute les événements du cycle de vie Yurplan et les convertit en actions Wallet.

  1. Commande confirmée: The Wallet Crew crée une carte Wallet par billet.

  2. Identification du billet: chaque carte porte l'identifiant yurplan.ticketId, au format eventId|ticketToken. Un billet qui a déjà une carte n'en reçoit pas une nouvelle, donc un webhook rejoué ne crée pas de doublon.

  3. Billet annulé ou contrôlé: le connecteur reçoit l'événement Yurplan, trouve la carte correspondante via yurplan.ticketId, et l'actualise depuis Yurplan. La carte reste installée. Le modèle de carte décide de l'affichage d'un billet annulé ou contrôlé, à partir du billet état et scanCount.

  4. Enrichissement des données: les données client et de carte sont récupérées via les API Yurplan, notamment le nom du participant, le jeton du code-barres, le type de billet, le prix, les informations sur l'événement, les informations sur le lieu, les images et le nombre de scans.

Le connecteur utilise un modèle de carte par défaut au niveau du locataire (defaultPassType) lors de la création des cartes Wallet Yurplan.

Configuration

Le connecteur lit ses paramètres depuis server/yurplan.yml. Les trois paramètres sont requis.

Paramètre
Finalité

connection.username

E-mail du compte Yurplan utilisé pour lire les billets. Le compte doit avoir l'autorisation de lister les billets (admin).

connection.password

Mot de passe de ce compte Yurplan.

defaultPassType

Nom du modèle de carte utilisé pour les cartes Yurplan.

Yurplan appelle trois URL de webhook sur The Wallet Crew, avec un corps JSON dont la charge utile se trouve sous data:

  • https://api.thewalletcrew.io/api/<tenantId>/webhooks/listeners/yurplan/<eventId>/order/confirmed

  • https://api.thewalletcrew.io/api/<tenantId>/webhooks/listeners/yurplan/<eventId>/ticket/canceled

  • https://api.thewalletcrew.io/api/<tenantId>/webhooks/listeners/yurplan/<eventId>/ticket/checked

En QA, utilisez api-qa.thewalletcrew.io.

Distribution

Deux points de contact déjà présents dans Yurplan comportent le bouton Ajouter à Wallet .

  • La page de confirmation prend en charge une action directe immédiatement après l'achat.

  • La e-mail de confirmation est le canal standard et un parcours de secours lorsque la page est fermée ou que l'achat a été effectué sur ordinateur.

Dépannage

Symptôme
À vérifier

Aucune carte n'est créée après une commande

La commande confirmée webhook atteint The Wallet Crew avec le bon eventId, et defaultPassType désigne un modèle de carte existant.

Un billet annulé ou contrôlé ne met pas à jour la carte

La billet annulé ou billet contrôlé webhook atteint The Wallet Crew avec le même eventId. La carte doit porter le yurplan.ticketId: un billet inconnu est accepté et ne change rien.

La carte n'affiche pas l'annulation

Le modèle de carte doit utiliser le billet état pour afficher un billet annulé.

Mis à jour