> 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/aparte/distribution.md).

# Distribution

Livrez les billets Aparté à Apple Wallet et Google Wallet depuis des parcours e-mail ou des pages web propriétaires.

### Pourquoi la distribution est importante

Un ticket Wallet n’est utile que si le point d’entrée est facile à ouvrir et fiable. La distribution Aparté commence généralement juste après l’achat, sur la page de confirmation, dans l’e-mail de confirmation, ou plus tard depuis une page de compte.

The Wallet Crew prend en charge deux schémas pratiques. Un schéma utilise des pages de billets hébergées. L’autre utilise le SDK sur un site Web contrôlé par la marque ou le partenaire.

<details>

<summary><strong>Exemples réels</strong></summary>

* **E-mail de confirmation**: un lien hébergé ouvre la liste des billets de la réservation.
* **Page Mes billets**: un bouton SDK apparaît à côté de chaque ligne de billet.
* **Parcours de relance**: le même lien hébergé est réutilisé avant l’événement.

</details>

### Envoyer les billets depuis un e-mail

L’e-mail est le canal de distribution Aparté le plus courant. Il fonctionne bien lorsque le parcours de billetterie envoie déjà un e-mail d’achat ou de rappel.

The Wallet Crew propose des pages hébergées qui détectent l’appareil et ouvrent le bon parcours Wallet. Sur mobile, la page affiche l’action native Apple Wallet ou Google Wallet. Sur ordinateur, elle revient à un code QR.

Utilisez toujours un domaine personnalisé pour ces liens. Cela garde visible la marque de l’organisateur et évite d’exposer aux clients un domaine générique The Wallet Crew.

Pour le modèle complet par e-mail, voir [Par e-mail](/guides-enrolment/fr/inscription/via-email.md).

#### Lier plusieurs billets

Utilisez la page hébergée `billets` page lorsqu’un seul élément de commande Aparté correspond à plusieurs billets.

```
https://<customdomain>/<tenantId>/tickets?ids.aparte.orderItemId=<orderItemId>&ids.aparte.orderItemId.hmac=<hmac>
```

`ids.aparte.orderItemId` est l’identifiant multi-billets. Le HMAC correspondant signe exactement cette valeur.

Cette page liste chaque billet résolu à partir de cet élément de commande Aparté. C’est le point d’entrée standard pour un parcours de confirmation de commande lorsque plusieurs billets doivent être affichés à partir d’un seul parcours de réservation.

Un exemple QA suit la même structure :

```
https://app-qa.neostore.cloud/<tenantId>/tickets?ids.aparte.orderItemId=1956141&ids.aparte.orderItemId.hmac=<hmac>
```

#### Lier un seul billet

Utilisez la page hébergée `billet` page lorsque le parcours doit ouvrir directement un billet précis.

```
https://<customdomain>/<tenantId>/ticket?id.aparte.ticketId=<orderItemId>%7C<seatId>&id.aparte.ticketId.hmac=<hmac>
```

`id.aparte.ticketId` est l’identifiant d’un seul billet. Sa valeur est `<orderItemId>|<seatId>`.

Encoder le séparateur en `%7C` est plus sûr que de laisser un `|` brut dans l’URL. Le HMAC doit correspondre à la valeur exacte utilisée dans le lien.

Un exemple QA suit le même modèle :

```
https://app-qa.neostore.cloud/<tenantId>/ticket?id.aparte.ticketId=1956141%7C29737860&id.aparte.ticketId.hmac=<hmac>
```

#### Notes d’implémentation pour l’e-mail

Trois règles comptent pour la fiabilité. Calculez le HMAC côté serveur. Utilisez toujours un domaine personnalisé configuré, pas `localhost`. Conservez l’URL complète dans l’outil d’e-mail afin qu’aucun paramètre de requête ne soit tronqué ou réécrit.

### Ajoutez le bouton sur un site Web avec le SDK

Utilisez le SDK lorsque la marque ou le partenaire contrôle la page où le billet est affiché. Les emplacements typiques sont une page de confirmation de commande, un compte client ou une liste de billets dédiée.

Le SDK gère la détection de l’appareil et affiche la bonne action Wallet. La partie spécifique à Aparté est le contrat d’identifiant envoyé au SDK.

Pour le modèle complet d’intégration sur site Web, voir [Sur votre site web](/guides-enrolment/fr/inscription/on-your-website.md).

#### Modèle SDK pour billet unique

Pour un billet, la page doit résoudre l’identifiant Aparté dans le même format que l’URL hébergée pour un seul billet.

Utilisez `aparte.ticketId` comme identifiant externe. Sa valeur est `<orderItemId>|<seatId>`. Le HMAC correspondant doit être généré côté serveur à partir de cette valeur exacte.

C’est le modèle à utiliser lorsqu’un seul bouton Wallet est affiché pour une carte de billet ou une ligne de billet.

#### Modèle de site Web pour plusieurs billets

Pour une page qui affiche plusieurs billets, deux modèles fonctionnent bien.

Le premier modèle affiche un bouton SDK par billet. C’est utile sur une page Mes billets authentifiée. **Mes billets** page.

Le deuxième modèle renvoie vers la page hébergée `/tickets` en utilisant `ids.aparte.orderItemId`. C’est généralement plus simple sur une page de confirmation, car un seul lien peut exposer la liste complète des billets résolus à partir de l’élément de commande.

### Notes de sécurité

La distribution Aparté repose sur des identifiants signés. Le HMAC doit rester côté serveur et ne doit jamais être généré dans le code du navigateur.

La valeur de l’identifiant et la valeur signée doivent rester identiques. Si l’identifiant du billet est signé en tant que `<orderItemId>|<seatId>`, l’URL distribuée doit réutiliser cette valeur exacte. Si le pipe est encodé dans l’URL dans le lien final, le HMAC signe toujours la valeur logique de l’identifiant, et non un identifiant de billet différent.

### FAQ

<details>

<summary><strong>Quelle est la différence entre <code>id.aparte.ticketId</code> et <code>ids.aparte.orderItemId</code>?</strong></summary>

`id.aparte.ticketId` cible un billet précis.

`ids.aparte.orderItemId` cible le parcours de liste hébergée et résout les billets associés à cet élément de commande Aparté.

</details>

<details>

<summary><strong>Pourquoi faut-il toujours utiliser un domaine personnalisé ?</strong></summary>

Un domaine personnalisé maintient visible la marque de l’organisateur pendant le parcours Wallet.

Cela évite d’exposer aux clients un domaine générique The Wallet Crew et crée une expérience plus cohérente entre l’événement, l’e-mail et la page Wallet hébergée.

</details>

<details>

<summary><strong>Un même lien e-mail peut-il exposer plusieurs billets ?</strong></summary>

Oui.

Utilisez la page hébergée `/tickets` page avec `ids.aparte.orderItemId` et son HMAC correspondant.

</details>

<details>

<summary><strong>Quand faut-il privilégier le SDK par rapport à la page hébergée ?</strong></summary>

Utilisez le SDK lorsque la page est entièrement contrôlée et que l’action Wallet doit apparaître intégrée.

Utilisez la page hébergée lorsque la distribution par e-mail ou un lien partagé unique est plus simple.

</details>

<details>

<summary><strong>Que se passe-t-il sur ordinateur au lieu de mobile ?</strong></summary>

La page hébergée détecte automatiquement l’appareil.

Sur mobile, elle affiche l’action Wallet native. Sur ordinateur, elle revient à un code QR afin que la Carte puisse quand même être ouverte depuis un téléphone.

</details>

<details>

<summary><strong>Le HMAC doit-il être généré dans le navigateur ?</strong></summary>

Non.

Le HMAC doit toujours être généré côté serveur. Une signature côté navigateur exposerait le secret et affaiblirait le flux de distribution.

</details>

<details>

<summary><strong>Qu’est-ce qui casse généralement un lien Aparté signé ?</strong></summary>

Le problème le plus courant est une incompatibilité entre la valeur de l’identifiant et la valeur signée.

Cela peut se produire si un séparateur change, si un paramètre de requête est réécrit par l’outil d’e-mail, ou si le lien final ne réutilise pas l’identifiant exact qui a été signé.

</details>

<details>

<summary><strong>Quand faut-il privilégier la page hébergée <code>/tickets</code> plutôt que plusieurs liens pour un seul billet ?</strong></summary>

Utilisez `/tickets` lorsqu’un seul parcours de réservation doit exposer plusieurs billets ensemble.

Cela simplifie l’e-mail ou la page de confirmation et permet à un seul lien signé de résoudre la liste complète des billets associés à l’élément de commande Aparté.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.