# Mises à jour, cycle de vie et statut 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 la Carte Wallet alignée avec Secutix. Parfois, cela signifie mettre à jour une Carte. Parfois, cela signifie l'invalider.

## Comment fonctionne l'intégration

Secutix reste la source de vérité pour les données des billets et des contacts, et The Wallet Crew n'ajoute que 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 dernières données, puis reconstruit la charge utile de la Carte et pousse la mise à jour vers les appareils.

<div data-with-frame="true"><figure><img src="/files/ab70d741e0d4f8fe5314fce836f81c73e3a80f29" 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 **boutique de billets** (self-service) ou le **back office** (actions des agents). Lorsqu'un changement se produit, Secutix notifie 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>

* Les changements d'heure de début dans le back office Secutix. La Carte Wallet se met à jour en quelques secondes.
* Réimpression par l'acheteur. Le code-barres change. La Carte Wallet se rafraîchit.
* 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 vivront les utilisateurs Wallet. Elle aide aussi les équipes de support à répondre rapidement à « pourquoi mon billet a-t-il changé ? ».

| Cas d'utilisation                                    | Possible depuis la boutique de billets | Possible dans le 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 |
| ---------------------------------------------------- | -------------------------------------- | ---------------------------- | ---------------------------- | --------------------- | ---------------------- | --------------------- | -------------------- | ------------------------------------ | ---------------------------------- | -------------------------------------- |
| Modification 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 du 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 de mouvement

Le statut d'installation est utile pour les rapports et l'automatisation après achat. Lorsqu'il est activé, il renvoie dans Secutix les signaux d'installation de Wallet.

Si vous activez **Conserver le statut d'installation**, The Wallet Crew conserve le statut d'installation du billet dans les **références externes de mouvement**.

Ces données sont maintenues à jour au fil du 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 remplacés par le dernier statut et l'appareil.

<div data-with-frame="true"><figure><img src="/files/b0fc643b137d15075b0bb674cd818740bae7dbb6" alt="Persist installation status option in the Secutix connector settings." width="443"><figcaption><p>Option Conserver le statut d'installation dans les paramètres du connecteur Secutix.</p></figcaption></figure></div>

Les clés suivantes 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-le lorsque vous avez besoin d'un suivi natif de récupération Secutix. Cela aide pour les rapports de conformité. Cela peut aussi activer des flux de revente (selon votre configuration de revente Secutix) qui nécessitent **PRINTED**.

C'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="/files/8c85742f5d861e6a75a6de9ffbbc477e81ff860b" 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 changement Secutix s'exécutent toutes les **\~10 minutes**.

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

</details>

<details>

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

Les modifications simples **mettent à 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 réajouter 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 puis rouvrir l'application Wallet.

Si nécessaire, supprimer puis rajouter à partir du 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 avertir 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 à plusieurs entrées.

<figure><img src="/files/d3194014ee9e4d95fbeb0b89b01dfedf2c8601b8" alt="Example of geolocated notification"><figcaption><p>Exemple de notification géolocalisée.</p></figcaption></figure>

<figure><img src="/files/fca023f327aae605e146b5f18a910f85efeb5d36" 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, rendez-vous sur [Distribution](/connectors/fr/ticketing/secutix/distribution.md).


---

# 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/secutix/updates-lifecycle-and-installation-status.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.