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.
Fonctionnement du connecteur
Le connecteur écoute les événements du cycle de vie Yurplan et les convertit en actions Wallet.
Commande confirmée: The Wallet Crew crée une carte Wallet par billet.
Identification du billet: chaque carte porte l'identifiant
yurplan.ticketId, au formateventId|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.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étatetscanCount.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.
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/confirmedhttps://api.thewalletcrew.io/api/<tenantId>/webhooks/listeners/yurplan/<eventId>/ticket/canceledhttps://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
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

