> 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

La distribution est la façon dont les acheteurs ajoutent des billets Secutix à Apple Wallet et Google Wallet. Vous pouvez partager un lien de téléchargement hébergé, ou intégrer un **Ajouter à Wallet** bouton. Placez le CTA 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é)
* Votre site web (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 intégré « Ajouter à Wallet » (SDK)** pour des enregistrements instantanés dans la billetterie ou sur les pages détenues.

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

C’est le parcours 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 mémoriser leur identifiant et leur mot de passe de la billetterie.
{% endhint %}

Le Wallet Crew expose 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 bascule vers un code QR.

La page liste chaque billet de la commande. Les acheteurs peuvent ajouter les billets à partir du même lien, sans rouvrir l’e-mail.

<div align="center"><figure><img src="/files/030552996d0183bb9096673dd72dcecc4074358c" 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="/files/4c827e5d5a3b6edd0addb319b54c7f2b0528ba8e" 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="/files/463adcd07c865a99077280346340e6617ec2be50" 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 vos valeurs.

```
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 `billets`. Créez-la dans vos mises en page Wallet Crew.

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

```yaml
type: passList
internationalization:
  ressources :
    - /locales/tickets/
headerImage: /public/header.png
```

{% endcode %}

{% hint style="info" %}
Contactez le support The Wallet Crew si vous avez besoin d’aide pour configurer cette mise en page.
{% endhint %}

## « Ajouter à Wallet » dans la billetterie

Utilisez cela lorsque vous voulez le CTA directement dans l’interface de la billetterie. C’est le meilleur parcours pour les acheteurs mobiles qui souhaitent enregistrer le billet immédiatement.

Cette intégration est généralement mise en œuvre par Secutix. Vérifiez qu’elle est incluse dans le périmètre Secutix si vous ne la voyez pas.

<figure><img src="/files/b3c77b0409de02ea53efe6cba471c5359042f9b5" 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 votre site web

Utilisez cela lorsque vous contrôlez la page. Les exemples typiques sont une page de compte, une page « Mes billets » ou une page d’atterrissage après achat.

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

Il suit les directives des boutons Apple et Google. Il reste compatible lors des 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, vérifiez trois choses. Votre tenant Wallet Crew dispose du bon **Billet d’événement** modèle(s). Wallet Crew est connecté à Secutix via le connecteur Secutix. Vous pouvez modifier la page où vous souhaitez afficher le bouton.

{% hint style="info" %}
L’intégration Wallet Crew Secutix 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 fois par page, idéalement dans le pied de page.

<figure><img src="/files/ab42c4703c27afb8cae0bc03c2e6a3c2f3d6fc8c" alt="SDK snippet shown in the Secutix integration settings page."><figcaption><p>Extrait 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 de tenant Wallet Crew.

### Exemples de boutons

Toutes les options ci-dessous affichent le même bouton. Elles diffèrent seulement par la façon 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 votre secret de signature dans le navigateur.

Si vous avez besoin `passId`, récupérez-le côté serveur en interrogeant les cartes existantes à l’aide du Secutix `movementId` (cela ne **pas** crée une 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 la `passId` à fournir au SDK. Référence de l’API : [GET /api/{tenantId}/passes](https://docs.thewalletcrew.io/develop/api-reference/pass-management/pass#get-api-tenantid-passes).

Besoin du guide d’intégration complet du site web ? Consultez [Sur votre site web](https://github.com/TheWalletCrew/docs/tree/main/enroll/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. Vérifiez que la variable de jeton est renseignée. Vérifiez que votre 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 seulement un code QR) ?</strong></summary>

Le bouton choisit Apple vs Google vs ordinateur à partir de l’agent utilisateur. Les navigateurs intégrés peuvent fausser cette détection. « Demander la version ordinateur du site » casse aussi 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 pour Google et Apple Wallet seront affichés.

</details>

<details>

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

Oui. Un seul lien hébergé peut afficher tous les billets 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, consultez [Mises à jour, cycle de vie et statut d’installation](/connectors/fr/ticketing/secutix/updates-lifecycle-and-installation-status.md).

</details>

## Plus d’informations

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

Si vous voulez valider les échanges, les annulations et le comportement de rafraîchissement, allez à [Mises à jour, cycle de vie et statut d’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.