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

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 le billet Wallet aligné avec Secutix. Parfois, cela signifie mettre à jour une Carte. Parfois, cela signifie l’invalider.

## Fonctionnement de l’intégration

Secutix reste la source de vérité pour les données de billet et de contact, et The Wallet Crew ajoute uniquement la couche Wallet. The Wallet Crew ne stocke pas l’ensemble complet 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 de membre. Lorsqu’une Carte est créée ou mise à jour, The Wallet Crew appelle les services web Secutix pour récupérer les données les plus récentes, puis reconstruit la charge utile de la Carte et envoie la mise à jour aux appareils.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F3504hifkqVrJQtA32wK3%2Fimage.png?alt=media&#x26;token=1e9d022e-31f5-4951-8c9e-743eccaea3b7" alt="Integration schema showing Secutix as the source of truth, The Wallet Crew syncing ticket changes, and Apple Wallet / Google Wallet passes being updated."><figcaption><p>Schéma d’intégration : The Wallet Crew récupère les modifications et envoie le billet Secutix vers Apple Wallet et Google Wallet.</p></figcaption></figure></div>

## Comment fonctionnent les mises à jour

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

<details>

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

* L’horaire de début change dans le back office Secutix. La Carte Wallet se met à jour en quelques secondes.
* L’acheteur réimprime. Le code-barres change. La Carte Wallet est actualisée.
* 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.

</details>

## Matrice des scénarios de mise à jour de Carte

Utilisez cette matrice pour prévoir ce que les utilisateurs du Wallet vont constater. Elle aide également les équipes de support à répondre rapidement à la question « pourquoi mon billet a-t-il changé ? ».

| Cas d’usage                                        | Possible depuis la billetterie | Possible en 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é | Billet à mettre à jour dans Wallet | Ancien billet à 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 de 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 du mouvement

Le statut d’installation est utile pour le reporting et l’automatisation post-achat. The Wallet Crew réécrit par défaut les signaux d’installation Wallet dans Secutix.

Le statut d’installation du billet est enregistré dans les **références externes du mouvement**.

Ces données sont maintenues à 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 le dernier appareil.

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é` ou `désinstallé`
* `twc.device`: `apple`, `google`, `apple+google` ou `-` après la 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 **PRINTED**. Dans Secutix, **PRINTED** signifie que l’acheteur a récupéré le billet.

Utilisez ceci lorsque vous avez besoin d’un suivi natif de la récupération dans Secutix. Cela aide pour les rapports de conformité. Cela peut également activer des flux de revente (selon votre configuration de revente Secutix) qui nécessitent **PRINTED**.

Ceci est à sens unique. The Wallet Crew ne rétablit pas **PRINTED** si la Carte est supprimée. La suppression ne signifie pas que le billet est inutilisable.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FqqlvDUo6R4Gf5v356iNX%2Fimage.png?alt=media&#x26;token=85671df1-1c27-44ca-aca0-2c50c8a4f595" alt="Update printing status option in the Secutix connector settings." width="443"><figcaption><p>Option de mise à jour du statut d’impression dans les paramètres du connecteur Secutix.</p></figcaption></figure></div>

### FAQ

<details>

<summary><strong>À quelle vitesse les billets Secutix se mettent-ils à jour dans Apple Wallet et Google Wallet ?</strong></summary>

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

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

</details>

<details>

<summary><strong>Qu’est-ce qui déclenche une mise à jour du billet Wallet par rapport à un billet invalidé (annulé) ?</strong></summary>

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

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

</details>

<details>

<summary><strong>Les participants doivent-ils rajouter le billet après un changement ?</strong></summary>

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

</details>

<details>

<summary><strong>Mon billet semble obsolète. Que dois-je faire ?</strong></summary>

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

Demandez au participant de :

* Vérifier la connectivité.
* Fermer et rouvrir l’application Wallet.

Si nécessaire, supprimer puis rajouter depuis le lien d’origine.

</details>

<details>

<summary><strong>Puis-je envoyer une notification Wallet pour des changements de dernière minute ?</strong></summary>

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 billet Wallet."**
* **"Mise à jour : vos informations d’entrée ont changé. Votre billet Wallet est à jour."**

</details>

<details>

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

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.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2F9fqkSb1VX3G0R4gPHJT7%2Fimage.png?alt=media&#x26;token=eba175ae-3339-443c-a512-6333dbb7f78d" alt="Example of geolocated notification"><figcaption><p>Exemple de notification géolocalisée.</p></figcaption></figure>

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FlbMbKHaPAj36hfE2NxRB%2Fimage.png?alt=media&#x26;token=f43e1037-9103-42b1-aa85-402430275c08" alt="Max distance setting for geolocated notifications"><figcaption><p>Paramètre de distance maximale pour les notifications géolocalisées.</p></figcaption></figure>

</details>

Si vous devez revérifier comment les billets sont distribués aux utilisateurs, allez à [Distribution](https://docs.thewalletcrew.io/fr/connecter/ticketing/secutix/distribution).