# Yurplan

### Pourquoi connecter Yurplan à The Wallet Crew

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, afin que les billets Yurplan puissent être distribués en tant que **Apple Wallet** et **Google Wallet** Cartes.

Cette intégration permet d'exposer un **Ajouter au Wallet** bouton directement sur la page de confirmation Yurplan et dans l'e-mail de confirmation. Cela maintient la distribution proche du flux d'achat et supprime la nécessité d'un parcours distinct spécifique à une application.

Yurplan reste la source de vérité. Les données des billets restent dans Yurplan, et les cartes wallet restent synchronisées avec celles-ci dans le temps. Lorsque les informations du billet changent dans Yurplan, la carte installée est mise à jour automatiquement.

{% hint style="info" %}
Yurplan contrôle les données et l'état des billets. The Wallet Crew gère la création des cartes, la distribution et les mises à jour côté wallet.
{% endhint %}

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Distribution depuis la page de confirmation**: après le paiement, les participants ajoutent leur billet à Apple Wallet ou Google Wallet directement depuis la page de confirmation Yurplan.
* **Repli par e-mail de confirmation**: la même commande peut aussi exposer un **Ajouter au Wallet** point d'entrée dans l'e-mail de confirmation.
* **Modification du billet après l'achat**: si les données de l'événement ou du billet changent dans Yurplan, la carte wallet se rafraîchit automatiquement.
* **Annulation de billet**: lorsqu'un billet est annulé dans Yurplan, la carte correspondante est mise à jour pour rester alignée avec le statut du billet.
* **Suivi du contrôle d'accès**: lorsqu'un billet est contrôlé sur le lieu, les métadonnées de la carte correspondante peuvent être mises à jour depuis le flux d'événement Yurplan.

</details>

### Ce que débloque cette intégration

Ce connecteur transforme les billets Yurplan en identifiants wallet vivants. Chaque billet confirmé peut devenir une carte wallet, prête à être stockée sur le téléphone et présentée à l'entrée.

La valeur opérationnelle est immédiate. Les cartes wallet sont faciles à récupérer, prêtes hors ligne à la porte, et maintenues à jour sans demander aux participants de rechercher des PDF ou d'anciens e-mails. Pour les équipes événementielles, cela réduit les frictions de livraison et rend les mises à jour des billets plus fiables.

Parce que la distribution se fait depuis la page de confirmation et l'e-mail de confirmation, l'intégration s'intègre naturellement dans le parcours d'achat Yurplan existant. Aucune base de données de billets dupliquée n'est nécessaire dans The Wallet Crew.

### Comment fonctionne le 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 billet est stocké avec un identifiant unique au format `eventId|ticketToken`.
3. **Billet annulé ou contrôlé**: le connecteur reçoit l'événement Yurplan, trouve la carte correspondante via `yurplan.ticketId`, et met à jour les métadonnées de la carte.
4. **Enrichissement des données**: les données client et de la carte sont récupérées depuis les API Yurplan, y compris le nom du participant, le jeton du code-barres, le type de billet, le prix, les informations de l'événement, les informations du lieu, les images et le nombre de scans.

Le connecteur utilise un type de carte par défaut au niveau du tenant lors de la création des cartes Yurplan. Cela permet de garder une émission cohérente entre les événements sauf si une configuration plus spécifique est ajoutée ultérieurement.

### Distribution dans Yurplan

Cette intégration prend en charge les deux points de contact clés de billetterie déjà présents dans Yurplan.

Le premier point de contact est la **page de confirmation**. Elle prend en charge une **Ajouter au Wallet** action directe immédiatement après l'achat, lorsque l'intention est la plus forte et que le billet est encore présent à l'esprit.

Le deuxième point de contact est l' **e-mail de confirmation**. Il agit à la fois comme canal de distribution standard et comme voie de récupération lorsque la page de confirmation est fermée ou que l'achat a été effectué sur un ordinateur de bureau.

Ensemble, ces deux points de contact couvrent la plupart des parcours de livraison de billets sans ajouter de complexité opérationnelle supplémentaire.

### Synchronisation des données et cycle de vie des billets

Le principe de base est simple : Yurplan reste autoritatif pour les données des billets. The Wallet Crew ne devient pas le système principal de billetterie. Il lit les informations des billets depuis Yurplan et les reflète au format wallet.

Le connecteur reçoit les webhooks Yurplan pour les événements clés du cycle de vie :

* `commande confirmée`
* `billet annulé`
* `billet contrôlé`

Ce modèle piloté par les événements maintient les cartes alignées avec l'état actuel du billet. Il est particulièrement utile pour les opérations d'événements, où un billet peut changer après l'achat et doit rester digne de confiance à l'entrée.

### FAQ

<details>

<summary><strong>The Wallet Crew peut-il être connecté à Yurplan ?</strong></summary>

Oui. The Wallet Crew peut se connecter à Yurplan et transformer les billets Yurplan en cartes Apple Wallet et Google Wallet.

</details>

<details>

<summary><strong>Où le bouton « Ajouter au Wallet » peut-il être affiché ?</strong></summary>

L'intégration prend en charge la page de confirmation Yurplan et l'e-mail de confirmation Yurplan. Ce sont les deux points de contact post-achat standard pour la livraison des billets.

</details>

<details>

<summary><strong>Où les données des billets sont-elles gérées une fois l'intégration activée ?</strong></summary>

Les données des billets restent gérées dans Yurplan. The Wallet Crew lit les données Yurplan et maintient la carte wallet synchronisée avec celles-ci.

</details>

<details>

<summary><strong>Combien de cartes wallet sont créées pour une commande ?</strong></summary>

Le connecteur crée une carte wallet par billet lorsque la commande est confirmée.

</details>

<details>

<summary><strong>Que se passe-t-il lorsqu'un billet est annulé ou contrôlé dans Yurplan ?</strong></summary>

L'événement Yurplan est reçu par le connecteur. La carte correspondante est trouvée via l'identifiant du billet Yurplan, puis les métadonnées de la carte sont mises à jour afin que les données du wallet restent alignées avec Yurplan.

</details>

<details>

<summary><strong>Les modifications des billets sont-elles reflétées automatiquement dans la carte wallet ?</strong></summary>

Oui. Lorsque les informations du billet changent dans Yurplan, la carte wallet est mise à jour automatiquement.

</details>