> 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/configure/fr/advanced-configuration/wallet/template-configuration/apple-tab.md).
# Onglet Apple
Configurez l’apparence et le comportement des cartes d’un modèle dans Apple Wallet : style, mise en page du poster, code-barres, couleurs, images, champs, emplacements, NFC et guide de l’événement.
L’onglet Apple définit tout ce qu’Apple Wallet affiche pour les Cartes du modèle. Apple Wallet utilise un ensemble fixe de styles de Carte, chacun avec ses propres zones pour les images et les champs, de sorte que les sections disponibles dans cet onglet dépendent du type de modèle et de la mise en page choisie. Le style est décidé par le type de modèle ; le mappage se trouve dans [Paramètres par type](/configure/fr/advanced-configuration/wallet/template-configuration.md#settings-by-type).
L’onglet Apple, avec ses sections à gauche et l’aperçu Apple Wallet à droite.
## Style et mise en page de Carte
### Mise en page poster
La mise en page poster est le design en pleine hauteur introduit avec iOS 27, construit autour d’une grande illustration. **Utiliser la nouvelle mise en page poster** l’active pour les modèles Carte client, billet d’événement et Carte de tampons. Les modèles génériques affichent toujours les paramètres du poster et sont affichés comme un poster dès qu’une illustration est définie ; les modèles Carte cadeau et Offre n’utilisent jamais la mise en page poster. Les sections et champs qui n’existent que dans la mise en page poster portent une **Poster - iOS 27+** puce.
La désactivation de l’option supprime les paramètres réservés au poster. Lorsqu’ils étaient renseignés, une confirmation (« Désactiver la mise en page poster ? ») permet de les laisser désactivés ou de les restaurer ; réactiver l’option avant l’enregistrement les restaure aussi.
Les iPhone plus anciens continuent d’afficher la mise en page classique, c’est pourquoi les réglages classiques, comme l’image de bandeau, restent configurés à côté de ceux du poster. L’aperçu bascule entre les deux mises en page depuis son menu d’affichage.
## Général
Cette section contient l’identité et la validité de la Carte dans Apple Wallet.
* **Texte du logo**: texte affiché à côté du logo. **Texte du logo de l’événement** le remplace sur les billets d’événement au format poster.
* **Description** (obligatoire, localisable) : une brève description de la Carte, utilisée par les technologies d’accessibilité d’iOS.
* **Nom de l’organisation** (obligatoire).
* **Identifiant de regroupement**: regroupe les Cartes associées sur l’écran verrouillé et dans Wallet.
* **Partage interdit**: désactive le partage de la Carte.
* **Utiliser la nouvelle mise en page poster**: voir [Mise en page poster](#poster-layout).
* **Supprimer le brillant du bandeau**: empêche l’effet de brillance que les anciennes versions d’iOS ajoutent à l’image de bandeau.
* **Utiliser des couleurs automatiques** (mise en page poster) : iOS déduit les couleurs du premier plan et des libellés à partir de l’illustration, au lieu des couleurs configurées. Décochez-la pour imposer les couleurs de la marque.
* **Supprimer l’assombrissement de l’en-tête** (mise en page poster) : empêche iOS d’assombrir l’en-tête du poster pour améliorer la lisibilité.
* **Annulée**: indique que la Carte est annulée, par exemple un coupon à usage unique déjà utilisé. Wallet déplace une Carte annulée vers Expiré.
* **Date pertinente**: moment où la Carte devient pertinente, par exemple l’heure de début d’un film. Recommandée pour les billets d’événement.
* **Date d’expiration**: quand la Carte expire. Wallet déplace une Carte expirée vers Expiré.
* **Distance maximale**: la distance maximale, en mètres, à partir d’un lieu, dans laquelle la Carte est pertinente.
## Code-barres
Le code-barres est ce qu’un scanner lit à la caisse ou à l’entrée. Cette section définit son **Type**, son **Valeur du code-barres** (généralement un identifiant de la Carte) et un **Texte alternatif**, affiché près du code-barres, par exemple une version lisible de la valeur si le code-barres ne se scanne pas.
Les types pris en charge sont QR, PDF417, Code128 et Aztec sur toutes les versions d’iOS. Code 39, Codabar, EAN-13 et ITF / I2of5 nécessitent iOS 27 ; un code QR de secours est automatiquement inclus pour les appareils plus anciens. Vérifiez que les terminaux en magasin peuvent lire le format choisi sur l’écran d’un téléphone.
Lorsque la valeur du code-barres est utilisée pour trouver la Carte avec Scanner de Carte, activez [Conserver les données scannables](/configure/fr/advanced-configuration/wallet/template-configuration/general-tab.md#scannable-data) dans l’onglet Général.
## Couleurs
Les couleurs permettent de conserver la cohérence de la Carte avec la marque et de la rendre lisible :
* **Arrière-plan**, **Premier plan** (valeurs) et **Libellé** couleurs ;
* **Arrière-plan du pied de page** (mise en page poster).
L’aperçu vérifie le contraste entre les valeurs ou les libellés et l’arrière-plan, et signale lorsqu’il est inférieur à 3:1. La vérification est ignorée lorsque les couleurs automatiques sont activées.
## Images
Les images disponibles dépendent du type et de la mise en page. Le texte d’aide de chaque image dans l’éditeur indique sa taille exacte et la façon dont Wallet la recadre.
| Image | Utilisée par |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Icône** (obligatoire) | Toutes les Cartes. Affichée dans les notifications, dans les e-mails avec la Carte jointe et sur l’écran verrouillé. |
| **Logo** | Toutes les Cartes, en haut à gauche de la mise en page classique. Wallet l’ajuste à 286 × 50 points. |
| **Bande** | Carte client, Carte de tampons, Carte cadeau, Offre et billet d’événement, derrière le champ principal. Non affichée par les Cartes génériques et les posters, mais conservée pour la mise en page classique. |
| **Vignette** | Cartes génériques et billets d'événement sans bande. |
| **Arrière-plan (billet d’événement classique)** | Billets d’événement classiques. Wallet le floute derrière la Carte. |
| **Illustration (arrière-plan du poster)** | Mise en page poster : l’arrière-plan en pleine hauteur. |
| **Logo (mise en page poster)** | Mise en page poster, en haut à gauche. |
| **Logo secondaire** | Billets d’événement au format poster, en bas à droite. |
### Images de tampon
Les modèles de Carte de tampons ajoutent une image par nombre de tampons sous **Images → Images de tampon**: un **bandeau Apple** pour chaque nombre de tampons et, lorsque la mise en page poster est activée, une **poster Apple** illustration poster pour chaque nombre. Le nombre d’images, leurs tailles et les autres règles figurent sur la [Carte à tampons](/guides-design/fr/conception/stamp-card.md#stamp-images) page.
## Champs
Les champs contiennent le texte de la Carte. Apple Wallet les place dans des zones qui dépendent du style et de la mise en page :
* **Champs d’en-tête**, visibles même lorsque les Cartes sont empilées dans Apple Wallet ;
* **Champs de face**: champs principal, secondaire et auxiliaire ;
* **Champs récapitulatifs** (Cartes au format poster autres que les billets d’événement) : affichés sous le code-barres, où ils remplacent les champs principaux. La mise en page classique conserve son propre champ principal au-dessus du bandeau, donc les deux sont configurés ;
* **Champs de pied de page** (mise en page poster) ;
* **Champs d’informations supplémentaires** (billets d’événement au format poster) : affichés dans la page « Informations supplémentaires sur le billet ». Avec la mise en page classique, iOS 27 les regroupe dans une tuile « Informations supplémentaires de la Carte » et les versions antérieures n’affichent rien, donc tout ce que chaque appareil doit afficher va dans les champs de face ou de dos ;
* **Champs de dos**, affichés dans les détails de la Carte.
Chaque champ possède un **Libellé**, un **Valeur** et un **Alignement du texte**. Le libellé est le même pour chaque détenteur (par langue) ; la valeur peut être personnalisée, par exemple avec le nom de l’événement ou le siège du client. **Format** affiche la valeur sous forme de nombre (décimal, pourcentage, devise…) ou de date et heure, formatée sur le téléphone du détenteur dans sa langue ; désactivé, la valeur s’affiche telle qu’écrite. **Notifier en cas de changement** affiche une alerte sur l’appareil du détenteur lorsque la valeur change ; son message de modification doit contenir `%@`, qui est remplacé par la nouvelle valeur. Dans la plupart des cas, une automatisation avec notification est préférable.
## Lieux et balises
**Lieux** (libellé, latitude, longitude, altitude) et **Balises** (balises Bluetooth Low Energy, avec un UUID, des identifiants major et minor) rendent la Carte pertinente à proximité d’un magasin ou d’un lieu. Le libellé d’une balise est le texte affiché sur l’écran verrouillé lorsque la Carte est pertinente, par exemple « Magasin à proximité sur 1st et Main ». **Distance maximale** dans la section Général limite la distance à partir d’un lieu.
## Identifiants d’app et de magasin
**Identifiants de magasin associés** sont les identifiants App Store des applications associées à la Carte (par exemple 123456789) ; un lien pour lancer l’application est affiché avec la Carte. Les billets d’événement au format poster ont aussi **Identifiants de magasin auxiliaires**, pour les applications liées au billet.
## Liens d’action (guide de l’événement)
Les billets d’événement au format poster peuvent afficher un **guide de l’événement**: une page d’actions utiles autour de l’événement. La **Liens d’action** section les répertorie : transférer, vendre ou gérer le billet, expériences additionnelles, commander de la nourriture, des produits dérivés, acheter un parking, informations sur le parking, itinéraire, informations sur les transports, accessibilité, politique relative aux sacs, ainsi que l’e-mail, le téléphone et le site Web du lieu.
Apple Wallet n’affiche le guide de l’événement que lorsque toutes les conditions sont remplies :
1. le billet est affiché comme un poster : il utilise la mise en page poster, avec une illustration et un nom d’événement, ainsi que les deux abréviations d’équipe pour un événement sportif ou un artiste pour une représentation en direct ;
2. les balises sémantiques définissent la date d’ouverture des portes du lieu ou la politique de tailgating ;
3. au moins un lien d’action est défini.
Un billet d’événement au format poster auquel il manque une illustration ou une balise sémantique requise est affiché avec la mise en page classique à la place. L’aperçu indique ce qui manque.
## NFC
Les Cartes compatibles NFC peuvent envoyer leurs informations à un terminal compatible, par exemple une Carte de fidélité lue lors d’une transaction Apple Pay. Cette section définit le message NFC **Message**. Cela nécessite un certificat Apple compatible NFC : sinon la section s’affiche comme « NFC (certificat non compatible) ». Lorsque NFC n’est pas configuré pour le locataire, la section l’indique et renvoie à la configuration ; les Cartes sont émises sans NFC jusqu’à ce qu’il le soit. Avec un message NFC, Wallet retire le code-barres de la face avant : il n’est visible que dans les détails de la Carte.
## Actions mises en avant
Les actions mises en avant apparaissent sous forme de cartes sous la Carte dans Wallet, au maximum deux par Carte. Elles sont ignorées sur iOS 26 et versions antérieures, donc il vaut mieux dupliquer les liens importants dans les champs de dos. Chaque action a un **Type d’action**, un **URL** (lien Web, lien profond, `tel:` lien ou lien Maps) ou, pour « Aller à l’emplacement », un **Lieu**et une **Icône (SF Symbol)**.
Types disponibles : Voir le programme, Regarder la bande-annonce, Écouter de la musique, Appeler, Aller à l’emplacement, Ajouter au solde, Commander la livraison ou le retrait, Acheter en ligne ou dans l’application, Voir les avantages d’adhésion, Prendre rendez-vous, Réserver une voiture, Réserver un vol, Réserver un séjour, Voir Offres et récompenses.
Les billets d’événement au format poster utilisent le guide de l’événement à la place des actions mises en avant. La **Lieu** de « Aller à l’emplacement » est recherché dans Apple Maps ou collé en tant que lien Apple Maps ou ID de lieu ; l’ID de lieu Apple est stocké et vérifié avec Apple Maps.
## Balises sémantiques
Les balises sémantiques décrivent la Carte de manière structurée afin qu’Apple Wallet puisse utiliser les informations, par exemple pour afficher un billet d’événement au format poster et son guide de l’événement. Elles sont regroupées en Détails de l’événement, Lieu, Médias (Apple Music), Sports (billet d’événement), Montants, réseaux Wi‑Fi, sièges et informations de date de l’événement.
## FAQ
Pourquoi le billet d’événement n’utilise-t-il pas la mise en page poster sur le téléphone ?
Voir [Liens d’action (guide de l’événement)](#action-links-event-guide). L’aperçu indique ce qui manque.
Pourquoi le guide de l’événement n’est-il pas affiché ?
Voir [Liens d’action (guide de l’événement)](#action-links-event-guide). L’aperçu indique ce qui manque.
---
# 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/configure/fr/advanced-configuration/wallet/template-configuration/apple-tab.md?ask=&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.
