> 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/guides-design/fr/conception/event-ticket.md).

# Billet d’événement

Configurez un modèle de billet d'événement pour Apple Wallet et Google Wallet : image de marque, visuels, lieu, disposition et informations événementielles en temps réel.

Que vous soyez un nouveau client qui doit créer le modèle des billets qui seront distribués aux participants, ou un maître de The Wallet Crew qui doit mettre à jour un modèle existant, cet article est une visite guidée du concepteur de modèles. L’objectif est de configurer un modèle de billet qui reflète l’identité de la marque, affiche clairement les informations essentielles de l’événement et garantisse une expérience fluide et sécurisée sur Apple Wallet et Google Wallet.

## Architecture

Apple et Google ont leurs propres modèles de cartes de billets, comme vous pouvez le voir ci-dessous.

{% tabs %}
{% tab title="Apple" %}

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F3aWK9TVEPV1lnaR7SNyv%2Fdesign-event-ticket-architecture-apple.png?alt=media&amp;token=bba89ace-738b-4f19-bb19-2a8e968fe357" alt="Architecture - Apple"><figcaption><p>Vérifiez où se trouvent le nom de l’événement, la date, le siège et le code-barres dans la mise en page du billet Apple.</p></figcaption></figure>
{% endtab %}

{% tab title="Google" %}

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F5iTi06OTC18NVGwCgtld%2Fdesign-event-ticket-architecture-google.png?alt=media&amp;token=ce8c3e2a-f045-46c2-96db-f70b63a7998f" alt="Architecture - Google"><figcaption><p>Vérifiez comment Google répartit le même billet entre les zones lieu, emplacement et confirmation.</p></figcaption></figure>
{% endtab %}
{% endtabs %}

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Image de couverture</th></tr></thead><tbody><tr><td align="center">Carte Apple</td><td data-object-fit="contain"><a href="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FvOwOsS3vlAbkzfsg1Df4%2Fdesign-event-ticket-image-2026-02-12t154141-948-removebg-preview.png?alt=media&amp;token=aa8c218c-91a2-4bbf-84ea-74ff622571dc">design-event-ticket-image-2026-02-12t154141-948-removebg-preview.png</a></td></tr><tr><td align="center">Carte Apple</td><td data-object-fit="contain"><a href="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F8Ldj7Rqe5MIk4UFNtWnn%2Fdesign-event-ticket-image-2026-02-12t154147-926-removebg-preview.png?alt=media&amp;token=7d355771-7672-4995-b669-7b82dfcdd61f">design-event-ticket-image-2026-02-12t154147-926-removebg-preview.png</a></td></tr><tr><td align="center">Carte Apple</td><td data-object-fit="contain"><a href="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FqglkDu6q5R2EKj5dDnx8%2Fdesign-event-ticket-image-2026-02-12t154144-942-removebg-preview.png?alt=media&amp;token=545e5aca-3170-46ee-bc24-8ef261a325e1">design-event-ticket-image-2026-02-12t154144-942-removebg-preview.png</a></td></tr><tr><td align="center">Carte Google</td><td></td></tr><tr><td align="center">Carte Google</td><td></td></tr><tr><td align="center">Carte Google</td><td data-object-fit="contain"><a href="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FgJ4MQ9KwFtYc7KTFWpUY%2Fdesign-event-ticket-capture-d-e-cran-2026-02-12.png?alt=media&amp;token=fde87ebf-3106-46c1-898b-61fddd1abbbf">design-event-ticket-capture-d-e-cran-2026-02-12.png</a></td></tr></tbody></table>

{% hint style="info" %}
**Pour aller plus loin, retrouvez tous les détails des deux versions :**
{% endhint %}

**Apple :**

{% embed url="<https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html>" %}

**Google :**

{% embed url="<https://developers.google.com/wallet/tickets/events/resources/template?hl=fr>" %}

### Comment la configurer sur The Wallet Crew

The Wallet Crew fournit un **concepteur de modèles** qui sert à **personnaliser les billets d’événement** distribués aux clients. Voyons en détail comment personnaliser chaque section.

## Apple

**Jetons un œil aux différentes sections du concepteur de modèles Apple.**

### Section générale

La section générale comporte deux champs obligatoires :

* **Description**: une brève description de la carte, qui apparaîtra au dos de la carte
* **Nom de l’organisation**: le nom de l’entreprise ou de la marque qui émet la carte

Il est également possible d’ajouter un texte à côté du logo, **activer le partage du billet** afin que les clients puissent le transmettre à d’autres personnes, la fonctionnalité « void » pour les coupons, ainsi qu’une date de validité et une date d’expiration utilisées pour les billets d’événement.

La section **définit également la distance** à partir d’une latitude et d’une longitude pertinentes auxquelles la carte s’applique, pour **les notifications de géorepérage.**

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FP64TqE2YtSL0JT28s3cc%2Fdesign-event-ticket-event-ticket-general-apple.png?alt=media&amp;token=0f8cba64-0563-48b8-acbe-ea0381ff77a7" alt="Event ticket - General section Apple"><figcaption><p>Vérifiez que Description et Nom de l’organisation sont tous deux renseignés avant d’enregistrer.</p></figcaption></figure>

### Code-barres

Choisissez le **type de code-barres** compatible avec le matériel de contrôle. La valeur du code-barres correspond aux **identifiants** qui permettent d’identifier le billet à l’entrée par le terminal de contrôle. Enfin, le texte alternatif peut être utilisé pour afficher les données du code-barres si celui-ci ne peut pas être scanné.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FeAYGwVXS2ghgxEJwk5EI%2Fdesign-event-ticket-event-ticket-barcode-apple.png?alt=media&amp;token=98a85df8-7b54-4c1c-8295-93459142ff23" alt="Event ticket - Barcode Apple"><figcaption><p>Vérifiez que le type de code-barres correspond à ce que les scanners de contrôle d’accès acceptent.</p></figcaption></figure>

### Couleurs et images

Pour changer la couleur d’arrière-plan du billet, il suffit de **saisir le code couleur dans les champs** prévus à cet effet. Pour ajouter une image, importez-la depuis l’appareil utilisé.

### Champs d’en-tête <a href="#header-fields" id="header-fields"></a>

Cette section est particulièrement importante dans la version Apple, car les billets sont **empilés les uns sur les autres**. Seul l’en-tête du billet reste visible. Il est donc important que cette section attire l’œil et incite à cliquer sur la carte, notamment en affichant les informations les plus importantes comme la date, ou d’autres informations pertinentes.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FcvgC17oDsY4KuqEhnKAJ%2Fdesign-event-ticket-event-ticket-header-fields-apple.png?alt=media&amp;token=7b912efc-5a7d-4b1e-ae93-a9f569ee12c0" alt="Event ticket - Header fields Apple"><figcaption><p>Vérifiez que la date de l’événement est bien la valeur affichée dans le champ d’en-tête.</p></figcaption></figure>

### Champs du recto

Les champs du recto sont les champs utilisés pour **afficher les informations sur le recto du billet**, sous l’image bandeau. L’étiquette est la même pour chaque utilisateur (par langue), mais la valeur peut être personnalisée pour afficher le nom de l’événement ou le siège du client.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FPkBazd6FNUhk8Nv8vXkM%2Fdesign-event-ticket-event-ticket-front-field-apple.png?alt=media&amp;token=a7b78c4f-993c-421e-ba57-c61a536e9bed" alt="Event ticket - Front field Apple"><figcaption><p>Vérifiez que chaque champ du recto comporte une étiquette statique et une valeur dynamique.</p></figcaption></figure>

{% hint style="warning" %}
**Pour personnaliser les champs du recto, demandez à l’équipe technique quelle valeur dynamique renseigner.**
{% endhint %}

### Champs du verso <a href="#backfields" id="backfields"></a>

Cette section, située au dos du billet de l’événement, comprend plusieurs informations utiles pour le client :

* Comment se rendre à l’événement
* Informations concernant l’entrée
* Reçus
* La possibilité d’ajouter des liens, comme un lien pour écouter les artistes, accéder aux conditions générales, etc.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FAJIkHN2KE2ZshRGvcfkH%2Fdesign-event-ticket-event-ticket-backfields-apple.png?alt=media&amp;token=0e348ebc-cf35-435e-b445-7fa5807ebb55" alt="Event ticket - Backfields Apple"><figcaption><p>Vérifiez que les informations d’accès et le lien vers les conditions générales sont tous deux présents.</p></figcaption></figure>

### Autres sections

Sur Apple, il existe quatre autres sections :

* **Emplacements**: utilisés pour les notifications de géorepérage.
* **Balises**: également utilisées pour les notifications de géorepérage.
* **Identifiant de boutique associée**: utilisé pour lier une application publiée sur l’Apple Store
* **NFC**: une fonctionnalité qui permet aux clients d’échanger du contenu numérique et de connecter des appareils électroniques par simple contact.

{% hint style="warning" %}
**Veuillez contacter The Wallet Crew pour activer ces fonctionnalités**
{% endhint %}

{% hint style="danger" %}
**Une fois les modifications effectuées, n’oubliez pas de cliquer sur « save » en haut du concepteur de modèles !**
{% endhint %}

***

## Google

**Le concepteur de modèles Google est un peu différent de celui d’Apple.**

{% hint style="warning" %}
**Quelques points à connaître avant de configurer le modèle Google :**
{% endhint %}

1. Certains champs comme « issue » et « program name » sont **obligatoires**
2. Google préconfigure les champs en fonction de leurs valeurs prévues, il est donc préférable de ne pas saisir le nom du client dans Event name par exemple, même si c’est ainsi qu’il doit apparaître sur la carte
3. Les valeurs dynamiques (par exemple, {{firstName}}) doivent être **placées dans des champs dynamiques dédiés**. Les champs « Label » sont destinés uniquement au texte statique.

**Jetons un œil aux différentes sections.**

### Section générale

La section générale comporte trois **champs obligatoires**:

* **Émetteur**: le nom de la marque ou de l’entreprise qui émet le billet
* **Nom de l’événement**: il apparaît sur le recto de la carte et correspond généralement au nom de l’événement
* **État**: l’état du billet (actif, expiré, terminé, inactif)

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FFyHVYnUsStyzwyWOc1Ir%2Fdesign-event-ticket-event-ticket-google-general.png?alt=media&amp;token=cdda529e-7082-41a1-96df-62b4fc7d87e4" alt="Event ticket - Google general"><figcaption><p>Vérifiez qu’Émetteur, Nom de l’événement et État sont tous renseignés.</p></figcaption></figure>

### Code-barres

Choisissez le **type de code-barres** compatible avec le matériel de contrôle. La valeur du code-barres correspond aux **identifiants** qui permettent d’identifier le billet à l’entrée par le terminal de contrôle. Enfin, le texte alternatif peut être utilisé pour afficher les données du code-barres si celui-ci ne peut pas être scanné.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FEWqyw3UEZVWRKrlb47K5%2Fdesign-event-ticket-event-ticket-barcode-google.png?alt=media&amp;token=7037c0be-ef98-4dd9-8500-969c4bd774f6" alt="Event ticket - Barcode Google"><figcaption><p>Vérifiez que la valeur du code-barres et son texte alternatif correspondent à l’identifiant du billet.</p></figcaption></figure>

### Sécurité

Configurer un modèle consiste à décider **si le client peut partager sa carte ou non**. Google propose trois options :

* **Plusieurs détenteurs**: cela signifie que le client peut partager sa carte avec n’importe qui
* **Un utilisateur, tous les appareils**: un client, mais sur plusieurs appareils (une montre par exemple)
* **Un utilisateur, un appareil**

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FhssEGJxYDerAzNrYiE4i%2Fdesign-event-ticket-one-user-device.png?alt=media&amp;token=d6414a03-7347-4cf6-8371-3ec92b135ebc" alt="One user one device"><figcaption><p>Vérifiez que l’option de partage sélectionnée correspond à la politique de billetterie de l’événement.</p></figcaption></figure>

### Couleurs et images

Pour changer la couleur d’arrière-plan du billet, il suffit de **saisir le code couleur dans les champs** prévus à cet effet. Pour ajouter une image, importez-la depuis l’appareil utilisé.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FWLVlg6soUiXnrSePxHJ6%2Fdesign-event-ticket-event-ticket-colors-images-google.png?alt=media&amp;token=ca21dcc2-ab0e-4823-a35d-261d8b1f731c" alt="Event ticket - Colors and Images Google"><figcaption><p>Vérifiez que l’image principale et le logo s’affichent correctement avec la couleur d’arrière-plan choisie.</p></figcaption></figure>

### Lieu

Une section pour saisir les détails du lieu où se déroulera l’événement.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F7tsfPCgsoYlM0tHo9NKY%2Fdesign-event-ticket-event-ticket-venue-google.png?alt=media&amp;token=a646748c-bed9-4d02-85ea-679d8dab2bb5" alt="Event ticket - venue Google"><figcaption><p>Vérifiez que le nom et l’adresse du lieu correspondent à l’annonce de l’événement.</p></figcaption></figure>

### Emplacement

La porte, la rangée, le siège et la section du billet du client peuvent chacun être définis. Chaque champ est facultatif.

{% hint style="warning" %}
**Pour personnaliser les champs d’emplacement, demandez à l’équipe technique quelle valeur dynamique renseigner.**
{% endhint %}

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F798uVPMXDUiF4Z21rELD%2Fdesign-event-ticket-event-ticket-placement-google.png?alt=media&amp;token=4bbb1147-7896-4683-89a8-44827018d441" alt="Event ticket - Placement Google"><figcaption><p>Vérifiez que la porte, la rangée, le siège et la section utilisent chacun une valeur dynamique.</p></figcaption></figure>

### Confirmation

Sur le modèle Google, un code de confirmation peut également être défini et affiché lorsque l’événement en requiert un. Il s’agit d’un champ facultatif ; lorsqu’il n’y a pas de code de confirmation, sélectionnez "Unspecified".

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FnzFX3iIBbj4LcKN71ZqC%2Fdesign-event-ticket-event-ticket-confirmation-google.png?alt=media&amp;token=f26dcfa9-2424-4f21-a99e-1abd09f66b42" alt="Event ticket - Confirmation Google"><figcaption><p>Vérifiez que le champ du code de confirmation est soit renseigné, soit défini sur Unspecified.</p></figcaption></figure>

### Liens supplémentaires, Smart tap et intervalle de temps valide

**Liens supplémentaires** peuvent être ajoutés à la carte du client, par exemple le lien du site web de l’événement.

La **fonctionnalité Smart tap** peut également être configurée, afin que les clients **valident simplement leur billet** en approchant leur appareil d’un terminal matériel compatible.

Enfin, la section Intervalle de temps valide **définit une date de début et une date de fin** pour l’événement.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FBgxlqzRzb2DGMRSspU5e%2Fdesign-event-ticket-event-ticket-smart-tap-google.png?alt=media&amp;token=fab88f7b-a933-43bb-a4a0-a38f41717abf" alt="Event ticket - Smart tap Google"><figcaption><p>Vérifiez le paramètre Smart tap ainsi que les dates de début et de fin de la période de validité de l’événement.</p></figcaption></figure>

### Messages

Cette section, située au dos du billet de l’événement, comprend plusieurs informations utiles pour le client :

* Comment se rendre à l’événement
* Informations concernant l’entrée
* Reçus
* La possibilité d’ajouter des liens, comme un lien pour écouter les artistes, accéder aux conditions générales, etc.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FS4Lc3sRsD1EoFcURXpT0%2Fdesign-event-ticket-event-ticket-backfields-google.png?alt=media&amp;token=ab847f12-ce4b-4673-9670-b05a4f885216" alt="Event ticket - Backfields Google"><figcaption><p>Vérifiez que chaque message comporte un titre et un corps, et qu’aucun texte de remplacement ne subsiste.</p></figcaption></figure>

### Opportunités à valeur ajoutée

Cette section ajoute une **petite section en bas du billet**. Elle sert à afficher des offres ou des actualités.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F3F7oez98q0vRCcxDfB0y%2Fdesign-event-ticket-event-ticket-value-added-opportunity-google.png?alt=media&amp;token=5b0d6cf5-2979-40f2-bd16-b48245975298" alt="Event ticket - Value Added Opportunity Google"><figcaption><p>Vérifiez que le contenu de la section du bas est toujours à jour avant l’événement.</p></figcaption></figure>

### Autres sections

Sur Google, il existe quatre autres sections :

* **Valeur faciale**: le prix du billet
* **Liens d’application**: utilisé pour ajouter un lien vers une application
* **Page d’accueil**: utilisé pour ajouter le lien du site web de l’événement
* **Emplacements**: utilisé pour les notifications de géorepérage

{% hint style="danger" %}
**Une fois les modifications effectuées, n’oubliez pas de cliquer sur « save » en haut du concepteur de modèles !**
{% endhint %}

## FAQ

<details>

<summary><strong>Dois-je enregistrer ma configuration et mettre à jour toutes les cartes en même temps ?</strong></summary>

Une fois le modèle modifié, il y a **deux options :**

* Enregistrer la configuration sans déployer de mise à jour sur toutes les cartes : c’est la meilleure option s’il y a beaucoup de cartes. La configuration peut être enregistrée et une mise à jour planifiée pendant la nuit afin d’éviter l’impact d’une mise à jour de masse.
* Enregistrer la configuration et déployer une mise à jour : c’est la meilleure option pour les tests, ou lorsqu’il n’existe que quelques cartes dans l’environnement.

</details>

<details>

<summary><strong>Comment modifier la configuration pour une autre langue ?</strong></summary>

La conception de la carte peut être modifiée pour chaque langue. Cliquer sur « général » dans le menu permet d’ajouter une langue. Elle apparaît alors dans le concepteur de modèles et peut être modifiée.

</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/guides-design/fr/conception/event-ticket.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.
