> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/ticketing/secutix/distribution.md).

# Distribution

Livrez les billets Secutix vers Apple Wallet et Google Wallet via des liens e-mail ou des boutons intégrés « Add to Wallet ».

La distribution est la manière dont les acheteurs ajoutent des billets Secutix à Apple Wallet et Google Wallet. Un lien de téléchargement hébergé peut être partagé, ou un **Ajouter à Wallet** bouton peut être intégré. Placez l'appel à l'action là où se trouvent déjà les acheteurs.

Points de contact courants :

* E-mail de confirmation (lien hébergé)
* Page de confirmation de commande de la billetterie Secutix (bouton intégré)
* Le site web de la marque (bouton intégré)
* Lien SMS (utile quelques heures avant le spectacle)

La plupart des déploiements combinent plusieurs canaux : **Page de téléchargement hébergée** dans les e-mails transactionnels pour la fiabilité et **bouton « Ajouter à Wallet » intégré (SDK)** pour des enregistrements instantanés dans la billetterie ou sur les pages détenues.

## Page de téléchargement hébergée (envoyer par e-mail)

C'est le chemin le plus simple pour les acheteurs. Cela fonctionne bien lorsque Secutix envoie déjà un e-mail de confirmation après l'achat.

{% hint style="info" %}
Cette page ne nécessite pas d'authentification. Les acheteurs peuvent ouvrir l'e-mail quelques minutes avant le spectacle et ajouter les billets à leur Wallet. Ils n'ont pas besoin de se souvenir de leur identifiant et de leur mot de passe de billetterie.
{% endhint %}

The Wallet Crew présente une page de commande optimisée pour mobile. Sur iOS, elle affiche le bouton Apple Wallet. Sur Android, elle affiche le bouton Google Wallet. Sur ordinateur, elle revient à un code QR.

La page liste chaque billet de la commande. Les acheteurs peuvent ajouter les billets depuis le même lien, sans rouvrir l'e-mail.

<div align="center"><figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-7de1ffd7b380eb128fa21cd2a8faec58086b769e%2Fconnect-distribution-hosted-download-ios-showing-ticket-list-apple.png?alt=media" alt="Hosted download page on iOS showing the ticket list and Apple Wallet button." width="250"><figcaption><p>Page de téléchargement hébergée sur iOS.</p></figcaption></figure> <figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-49f31ccca3071546c5008137390765bf5c04d9ad%2Fconnect-distribution-hosted-download-android-showing-ticket-list-google.png?alt=media" alt="Hosted download page on Android showing the ticket list and Google Wallet button." width="245"><figcaption><p>Page de téléchargement hébergée sur Android.</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-4d6b93f2fa015834d51cf819502e784ccd86ecce%2Fconnect-distribution-hosted-download-desktop-showing-ticket-list-qr.png?alt=media" alt="Hosted download page on desktop showing the ticket list and QR code fallback." width="563"><figcaption><p>Page de téléchargement hébergée sur ordinateur.</p></figcaption></figure></div>

### Modèle d'URL

Utilisez cette URL dans les e-mails de confirmation Secutix. Remplacez `<customdomain>` et `<tenantId>` par les valeurs du locataire.

```
https://<customdomain>/<tenantId>/tickets?ids.secutix.orderToken=$document.order.secretToken
```

### Exigence de mise en page

La page hébergée utilise une mise en page nommée `tickets`. Créez-la dans les mises en page The Wallet Crew.

{% code title="Configuration de mise en page (exemple)" %}

```yaml
type: passList
internationalisation :
  resources:
    - /locales/tickets/
headerImage: /public/header.png
```

{% endcode %}

{% hint style="info" %}
Contactez le support The Wallet Crew pour obtenir de l'aide afin de configurer cette mise en page.
{% endhint %}

## « Ajouter à Wallet » dans la billetterie

Utilisez cette option lorsque l'appel à l'action doit apparaître directement dans l'interface de la billetterie. C'est le meilleur flux pour les acheteurs mobiles qui veulent enregistrer le billet immédiatement.

Cette intégration est généralement implémentée par Secutix. Confirmez qu'elle est incluse dans le périmètre Secutix si elle n'est pas visible.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-7fdd474dbd29459c7e43498308f3214670d45433%2Fconnect-distribution-add-wallet-button-embedded-secutix-ticket-shop.png?alt=media" alt="Add to Wallet button embedded in the Secutix ticket shop order confirmation page."><figcaption><p>Bouton « Ajouter à Wallet » dans la billetterie.</p></figcaption></figure>

## Ajoutez le bouton « Ajouter à Wallet » sur un site web propriétaire

Utilisez cette option lorsque la page est sous le contrôle de la marque. Les exemples typiques sont une page de compte, une page « Mes billets » ou une page d'atterrissage post-achat.

Le SDK The Wallet Crew (`cinto`) affiche le bouton et détecte l'appareil. Il affiche **Apple Wallet** sur iOS et **Google Wallet** sur Android. Sur ordinateur, il revient à un code QR.

Il respecte les recommandations de boutons Apple et Google. Il reste compatible grâce aux mises à jour du SDK. Il prend en charge la localisation selon la langue de l'utilisateur. Il protège également l'intégrité de la distribution.

### Prérequis

Avant d'intégrer le SDK, confirmez trois points. Le locataire The Wallet Crew dispose du bon **Billet d'événement** modèle(s). The Wallet Crew est connecté à Secutix via le connecteur Secutix. La page sur laquelle le bouton doit s'afficher peut être modifiée.

{% hint style="info" %}
L'intégration Secutix de The Wallet Crew utilise Secutix `movementId` pour identifier de manière unique une carte de billet.
{% endhint %}

### Initialisation du script

Copiez l'extrait prêt à l'emploi depuis les paramètres d'intégration Secutix dans la console d'administration. Chargez-le une seule fois par page, idéalement dans le pied de page.

<figure><img src="https://3852727835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlP7d71aYydav6e0pRkxc%2Fuploads%2Fgit-blob-c844fccabded96d9497b7b6bf377485731d26f1a%2Fconnect-distribution-sdk-snippet-shown-secutix-integration-settings.png?alt=media" alt="SDK snippet shown in the Secutix integration settings page."><figcaption><p>Extrait du SDK disponible dans les paramètres d'intégration Secutix.</p></figcaption></figure>

```html
<script type="text/javascript">
(function (n, e, o) {
    var s=n.createElement("script");
    s.src="https://sdk.neostore.cloud/scripts/"+e+"/cinto@1";
    s.async=1;
    s.onload=function(){neostore.cinto.initialize(e,o);n.body.appendChild(s);};
})(document, "{tenantId}", { });
</script>
```

Remplacez `{tenantId}` avec l'ID du locataire The Wallet Crew.

### Exemples de boutons

Toutes les options ci-dessous affichent le même bouton. Elles diffèrent seulement dans la manière dont le bouton identifie le billet.

<details>

<summary>En utilisant <code>movementId</code>, <code>fileId</code>, <code>contactId</code>, et <code>ticketId</code></summary>

```html
<div data-neostore-addToWalletButton
     data-neostore-externalIdentifiers-secutix.movementId-value="<movementId>"
     data-neostore-externalIdentifiers-secutix.movementId-secret="<fileId>|<contactId>|<ticketId>">
</div>
```

</details>

<details>

<summary>En utilisant le calcul HMAC</summary>

```html
<div data-neostore-addToWalletButton
     data-neostore-externalIdentifiers-secutix.movementId-value="<movementId>"
     data-neostore-externalIdentifiers-secutix.movementId-hmac="<hmac_sha256(secret, movementId)>">
</div>
```

</details>

<details>

<summary>En utilisant <code>passId</code> uniquement (résolu côté serveur)</summary>

```html
<div data-neostore-addToWalletButton
     data-neostore-passId="<passId>">
</div>
```

</details>

### Notes

Conservez le calcul HMAC côté serveur. N'exposez jamais le secret de signature dans le navigateur.

Lorsque `passId` est nécessaire, récupérez-le côté serveur en interrogeant les cartes existantes à l'aide de Secutix `movementId` (cela ne **ne** crée pas de carte) :

```bash
curl 'https://app.neostore.cloud/api/{tenantId}/passes?pageIndex=0&pageSize=21&filter%5B0%5D.field=identifiers.secutix.movementId&filter%5B0%5D.operator=equals&filter%5B0%5D.value={movementId}' \\
  -H 'accept: application/json, text/plain, */*' \\
  -H 'X-API-KEY: xxxx'
```

Choisissez le `id` depuis la charge utile de réponse. Cette valeur est l'identifiant `passId` à fournir au SDK. Référence de l'API : [GET /api/{tenantId}/passes](/api-reference/pass-management/pass.md#get-api-tenantid-passes).

Pour le guide complet d'intégration au site web, voir [Sur votre site web](/guides-enrolment/fr/inscription/on-your-website.md).

## FAQ

<details>

<summary><strong>Pourquoi le lien de la page de téléchargement hébergée ne fonctionne-t-il pas (billet introuvable / jeton invalide), et comment le corriger ?</strong></summary>

Cela signifie que la page hébergée ne peut pas résoudre la commande à partir du jeton. Le jeton dans l'URL est manquant ou incorrect.

Utilisez le modèle d'URL exact de cette page. Assurez-vous que la variable de jeton est renseignée. Assurez-vous que l'outil d'e-mail ne tronque pas l'URL. Si la commande a été remplacée, envoyez à l'acheteur un nouveau lien.

</details>

<details>

<summary><strong>Pourquoi le bouton « Ajouter à Wallet » affiche-t-il la mauvaise plateforme (ou uniquement un code QR) ?</strong></summary>

Le bouton choisit Apple, Google ou ordinateur à partir du user agent. Les navigateurs intégrés peuvent fausser cette détection. « Demander la version ordinateur du site » casse également la détection.

Demandez à l'acheteur d'ouvrir la page dans le navigateur système. Utilisez Safari sur iOS. Utilisez Chrome sur Android. Sur ordinateur, le code QR est le repli attendu.

Si cela ne fonctionne toujours pas, un bouton « besoin d'aide » est disponible, et les boutons Google Wallet et Apple Wallet sont affichés.

</details>

<details>

<summary><strong>Un acheteur a plusieurs billets dans une même commande. Peut-il tous les ajouter en une seule fois ?</strong></summary>

Oui. Un seul lien hébergé peut afficher chaque billet de la commande.

Les acheteurs ajoutent les billets depuis la liste. Ils n'ont pas besoin d'un lien par billet.

</details>

<details>

<summary><strong>Que se passe-t-il lorsqu'un billet est échangé, réimprimé ou annulé après avoir été ajouté au Wallet ?</strong></summary>

Les réimpressions et les modifications simples mettent généralement à jour automatiquement la carte Wallet existante.

Les échanges ou remplacements génèrent généralement un nouveau billet. L'ancienne carte est alors désactivée. L'acheteur doit ajouter la nouvelle carte. Rouvrir le lien hébergé suffit généralement.

Les annulations désactivent la carte afin qu'elle ne puisse pas être scannée.

Pour la matrice complète des comportements, voir [Mises à jour, cycle de vie et état de l'installation](/connectors/fr/ticketing/secutix/updates-lifecycle-and-installation-status.md).

</details>

## Plus d'informations

Pour configurer le contenu de la carte, allez à [Modèle de Carte Wallet et mappage des champs](/connectors/fr/ticketing/secutix/wallet-pass-template-and-field-mapping.md).

Pour valider les échanges, les annulations et le comportement de rafraîchissement, allez à [Mises à jour, cycle de vie et état de l'installation](/connectors/fr/ticketing/secutix/updates-lifecycle-and-installation-status.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/fr/ticketing/secutix/distribution.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.