# 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 sous forme de **Apple Wallet** et **Google Wallet** Cartes.

Cette intégration permet d'afficher un **Ajouter au Wallet** bouton directement sur la page de confirmation Yurplan et dans l'e-mail de confirmation. Cela rapproche la distribution du parcours d'achat et élimine le besoin d'un parcours distinct propre à l'application.

Yurplan reste la source de vérité. Les données des billets restent dans Yurplan, et les Cartes Wallet restent synchronisées avec elles 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, leur distribution et les mises à jour côté Wallet.
{% endhint %}

<details>

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

* **Distribution via 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 via l'e-mail de confirmation**: la même commande peut aussi afficher 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 met à jour automatiquement.
* **Annulation du billet**: lorsqu'un billet est annulé dans Yurplan, la Carte correspondante est mise à jour pour rester alignée sur le statut du billet.
* **Suivi du contrôle d'entrée**: lorsqu'un billet est contrôlé sur le lieu de l'événement, les métadonnées de la Carte correspondante peuvent être mises à jour depuis le flux d'événements Yurplan.

</details>

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

Ce connecteur transforme les billets Yurplan en identifiants Wallet en temps réel. 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 à retrouver, utilisables hors ligne au contrôle, et restent à 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 distribution et rend les mises à jour des billets plus fiables.

Comme la distribution se fait depuis la page de confirmation et l'e-mail de confirmation, l'intégration s'insère 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 enregistré 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`, puis met à jour les métadonnées de la Carte.
4. **Enrichissement des données**: les données du client et de la Carte sont récupérées depuis les API Yurplan, notamment le nom du participant, le jeton de 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 Wallet Yurplan. Cela garantit une émission cohérente d'un événement à l'autre, sauf si une configuration plus spécifique est ajoutée ultérieurement.

### Distribution dans Yurplan

Cette intégration prend en charge les deux principaux points de contact 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 maximale et que le billet est encore tout frais.

Le deuxième point de contact est l' **e-mail de confirmation**. Il sert à la fois de canal de distribution standard et de solution de secours lorsque la page de confirmation est fermée ou que l'achat a été effectué sur ordinateur.

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 du billet

Le principe de base est simple : Yurplan reste la source de référence pour les données des billets. The Wallet Crew ne devient pas le système de billetterie principal. Il lit les informations des billets depuis Yurplan et les reproduit 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 sur l'état actuel du billet. Il est particulièrement utile pour les opérations événementielles, où un billet peut changer après l'achat tout en devant rester fiable à l'entrée.

### FAQ

<details>

<summary><strong>Peut-on connecter The Wallet Crew à 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 à 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 standard après l'achat pour la livraison des billets.

</details>

<details>

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

Les données du billet restent gérées dans Yurplan. The Wallet Crew lit les données Yurplan et maintient la Carte Wallet synchronisée avec elles.

</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 Wallet restent alignées sur Yurplan.

</details>

<details>

<summary><strong>Les changements de billet sont-ils répercutés automatiquement dans la Carte Wallet ?</strong></summary>

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

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/ticketing/yurplan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.