> 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/wallet-pass-themes.md). # Thèmes de Cartes Wallet Créez des thèmes de Cartes Apple Wallet et Google Wallet réutilisables. Appliquez les couleurs, images et traductions de la campagne sans modifier le modèle de Carte. Un thème de carte Wallet est une couche visuelle réutilisable pour les cartes Apple Wallet et Google Wallet. Il applique les couleurs de campagne, les images et un texte facultatif. Il ne modifie pas les champs de la carte, les codes-barres ni les modèles. Utilisez les thèmes pour les campagnes saisonnières, le co-branding et les variantes du programme. Un seul thème peut s’appliquer à de nombreuses cartes. La mise à jour du thème met à jour son design partagé. ## Thèmes de carte Wallet : ce qu’ils sont et quand les utiliser Un thème est un ensemble nommé de couleurs, d’images et de contenu traduit facultatif. Il donne à une saison, une campagne ou un partenariat une identité visuelle cohérente. Un thème se superpose à un modèle de carte. Le modèle contrôle les champs, les codes-barres et la structure de la carte. Le thème contrôle l’identité visuelle. Cette séparation évite de dupliquer les modèles pour chaque campagne.
Exemples concrets * Un détaillant de mode habille ses cartes de fidélité des visuels de la collection été en juin, et de ceux de la collection hiver en novembre, tandis que la carte elle-même ne change jamais. * Un organisateur de spectacle donne à chaque carte pour une tournée l’identité visuelle de cette tournée, par-dessus le modèle de carte utilisé pour tous les spectacles. * Une marque menant un partenariat de trois mois applique un thème co-brandé aux cartes des clients concernés, puis le supprime lorsque le partenariat prend fin. * Une carte de personnel ou une carte VIP est volontairement maintenue distincte du reste du programme grâce à son propre thème.
### Fonctionnement des thèmes Quatre règles expliquent le comportement des thèmes : 1. Une carte a **un seul thème ou aucun**. Les thèmes ne s’empilent pas. 2. Les cartes font référence à un thème. Elles ne copient pas ses paramètres. Les modifications apparaissent lorsque les cartes se rafraîchissent. 3. Un thème ne modifie que l’apparence. La validité, le stock et l’utilisation appartiennent à une offre. 4. Les paramètres vides héritent du modèle. Cela inclut les couleurs et les positions des images. ## Ce qu’un thème de carte Wallet modifie Un thème peut définir des images, des couleurs et un texte facultatif. Les images ont le plus grand impact visuel. | Quoi | Détails | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Image par défaut** | Une bannière saisonnière pour les deux plateformes. Elle n’occupe que deux emplacements, le bandeau Apple et le hero Google, et uniquement lorsque le thème ne possède pas de remplacement spécifique pour eux. Le bandeau est plus court sur les cartes événementielles que sur les autres cartes, et une image par défaut sert pour chaque type de carte ; tout ce qui est important doit donc se trouver au centre de l’image. | | **Remplacements d’image** | Remplacez les logos, icônes, vignettes ou arrière-plans individuellement. Chaque remplacement est intentionnel. Chaque emplacement que le thème ne remplace pas conserve l’image du modèle de carte. | | **Couleurs** | Définissez la couleur d’arrière-plan de la carte, les valeurs des champs et les libellés des champs. La couleur des libellés s’applique uniquement à Apple Wallet. Les couleurs ne varient pas selon la langue. | | **Titre et description** | Ajoutez deux textes courts traduisibles. Le modèle doit être configuré pour les afficher. Sinon, ils n’apparaissent pas sur la carte. Le fait qu’ils suivent la langue de l’appareil dépend de la façon dont le modèle les place, comme expliqué dans [Langues](#languages). | ### Ce qu’un thème ne modifie jamais Les thèmes ne modifient pas les champs, la disposition des champs, les codes-barres, les liens, le contenu au verso de la carte ni le comportement de la carte. Ces paramètres restent dans le modèle. Une carte rethématisée affiche de nouveaux visuels sur la même carte. ### Langues Apple Wallet prend en charge des images spécifiques à chaque langue. Google Wallet stocke une image par emplacement et utilise toujours la langue par défaut. Les titres et descriptions des thèmes suivent une règle différente, car le modèle de carte décide de la façon dont ils sont rendus. `{{ theme.title }}` et `{{ theme.description }}` ne suivent la langue de l’appareil que lorsqu’ils sont placés dans les valeurs traduites du modèle, c’est-à-dire les valeurs d’un champ propres à chaque langue. Un champ de modèle écrit une seule fois est rendu une seule fois, dans une seule langue, quelles que soient les traductions contenues dans le thème. Un thème traduit en français n’affichera donc son titre français sur un appareil français que lorsque le champ du modèle qui l’affiche dispose de valeurs par langue. ## Images de carte Wallet qu’un thème peut remplacer L’image par défaut fournit la bannière principale sur les deux plateformes : le bandeau Apple et le hero Google, sauf si le thème en remplace un des deux. Les autres images sont remplacées par emplacement, car Apple Wallet et Google Wallet utilisent des dispositions différentes. Quinze emplacements sont disponibles. Un emplacement que le thème ne remplace pas conserve l’image de son modèle. Dans les deux tableaux ci-dessous, le schéma montre où l’emplacement se situe sur la carte, la zone remplacée étant mise en évidence. {% hint style="info" %} **Pourquoi seuls deux emplacements utilisent l’image par défaut.** Le bandeau Apple et le hero Google sont tous deux de larges bannières. Les logos, icônes et arrière-plans nécessitent des proportions différentes. Chacun de ces emplacements a besoin de son propre fichier. {% endhint %} ### Apple Wallet Chaque emplacement peut afficher une image différente selon la langue. | Où il se place | Emplacement | Taille | Ce que c’est | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![Apple Wallet card with the strip area behind the fields highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fce7SV9RiYJCHAsAxZ2e7%2F01-apple-strip.png?alt=media\&token=74468e78-ad43-4fa8-a5ce-f05abc5f9c0a) | **Bandeau** | 1125 × 294 px sur les cartes événementielles, 1125 × 432 px sur les cartes cadeaux et les offres, 1125 × 369 px sur les cartes de fidélité et de tampons. Ce sont les tailles d’Apple en @3x. [tailles d’Apple](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html) en @3x. | Non affiché sur les cartes génériques ni sur les mises en page poster. Sur une carte événementielle, un bandeau masque l’arrière-plan et la vignette. Utilise l’image par défaut sauf si le thème la remplace. | | ![Apple Wallet poster layout with the full-card artwork highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fy36POriDHQhqvbP69IlE%2F02-apple-artwork.png?alt=media\&token=15fa0108-9873-4f00-9ea7-b6a2a7d2b5c7) | **Visuel** | 1074 × 1344 px | Cartes événementielles poster à partir d’iOS 18, cartes génériques poster à partir d’iOS 27. | | ![Apple Wallet event ticket with the whole card background highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FUbU5QOgSoGEpVarYP7fd%2F03-apple-background.png?alt=media\&token=f2061595-2bea-4884-87bd-ef00b619fe1f) | **Arrière-plan** | 540 × 660 px | Cartes événementielles uniquement, et seulement lorsque la carte n’a pas de bandeau. | | ![Apple Wallet card with the square thumbnail beside the fields highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F6FyAZFij27w37zAtyOMN%2F04-apple-thumbnail.png?alt=media\&token=1e921273-3137-4041-98fd-ffc119d76f71) | **Vignette** | 270 × 270 px | Cartes génériques et cartes événementielles sans bandeau. | | ![Apple Wallet card with the logo in the top-left corner highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2F0Oqe2pORMjsZrwyswe8A%2F05-apple-logo.png?alt=media\&token=44ad1bc7-9cd8-4f9c-b0eb-4f3fe419a9e9) | **Logo** | 480 × 150 px (maximum) | En haut à gauche de chaque style, à côté du nom de la carte. Un PNG transparent laisse apparaître la couleur de la carte. | | ![An iOS notification with the small square pass icon highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fh4f42sSgfx2PVZI5Qwju%2F06-apple-icon.png?alt=media\&token=349ea01b-169e-4d9d-b46d-9ea310284474) | **Icône** | 87 × 87 px | Notifications, écran de verrouillage et cartes envoyées par e-mail. Il n’apparaît jamais sur la carte elle-même. | | ![Apple Wallet poster layout with the primary logo in the top-left highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FALma4tz8O9tZk53CoDMw%2F07-apple-primary-logo.png?alt=media\&token=441f9cdc-d29f-4c53-b800-c8ba1cc902b9) | **Logo principal** | 378 × 90 px | Le logo des mises en page poster, qui utilisent le leur plutôt que le logo standard. | | ![Apple Wallet poster layout with the secondary logo in the footer highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FavRKuveL649emKmbktgH%2F08-apple-secondary-logo.png?alt=media\&token=8b3b6976-10b9-4d42-9375-506ce35a3014) | **Logo secondaire** | 405 × 36 px | Une seconde marque plus large, intégrée dans le pied de page du poster — généralement un lieu ou un partenaire. | ### Google Wallet Une image par emplacement, toujours dans la langue par défaut. | Où il se place | Emplacement | Taille | Ce que c’est | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ![Google Wallet card with the wide hero banner highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FmTQ7z07NAg3SKJTVzzZP%2F09-google-hero.png?alt=media\&token=460864c8-fbfa-41a8-8875-904188a00913) | **Bannière principale** | 1032 × 336 px | La large bannière sur l’avant de la carte, sur les cartes de fidélité, événementielles, cadeaux et offres. L’image la plus visible qu’un thème peut définir sur Google Wallet. Utilise l’image par défaut sauf si le thème la remplace. | | ![Google Wallet card with the square logo in the header highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FHFInfflMnb1wgTR183AJ%2F10-google-logo.png?alt=media\&token=4be23a70-3e78-40b0-a74a-e0a2f97b46ac) | **Logo** | 660 × 660 px | Le logo carré en haut à gauche de la carte, à côté du nom de la marque. Il s’applique aux cartes événementielles et aux cartes génériques. Google le recadre en cercle, alors gardez le contenu à l’intérieur des 70 % centraux. | | ![Google Wallet card with the wide logo across the header highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FgacAmRgzk8IzRaieuw2f%2F11-google-wide-logo.png?alt=media\&token=d422d986-5a62-4dda-93f1-7306bf384d70) | **Logo large** | 1280 × 400 px | Utilisé à la place du logo dans l’en-tête de la carte, lorsque la marque se lit mieux en largeur qu’en carré. Il s’applique aux cartes événementielles et aux cartes génériques. | | ![Google Wallet card with the program logo in the header highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FeFsvFw4i45zsLjpmTRHQ%2F12-google-program-logo.png?alt=media\&token=cfb3f8f4-b976-4ca1-8ffc-fc86c712f0e3) | **Logo du programme** | 660 × 660 px | Le logo du programme de fidélité ou de la carte cadeau, affiché à la fois dans la liste et dans la vue détaillée. Il s’applique aux cartes de fidélité, aux cartes de tampons et aux cartes cadeaux. Google le recadre en cercle, alors gardez le contenu à l’intérieur des 70 % centraux. | | ![Google Wallet card with the wide program logo across the header highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fc0VnNYzozIxXGtcagw8B%2F13-google-wide-program-logo.png?alt=media\&token=5be033d2-4d57-467c-abf8-d56fd6e803dd) | **Logo du programme large** | 1280 × 400 px | Utilisé à la place du logo du programme dans l’en-tête de la carte. | | ![Google Wallet offer card with the title image in the header highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FiPUf4bUgx2D1WfcDQaVc%2F14-google-title-image.png?alt=media\&token=b3f76556-3f57-4761-9f74-ccec6d89f542) | **Image de titre** | 660 × 660 px | L’image de titre d’une offre, affichée à la fois dans la liste et dans la vue détaillée. Elle s’applique aux offres. | | ![Google Wallet offer card with the wide title image across the header highlighted](https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FwUz7eupJ4TDJkJBEPJ5S%2F15-google-wide-title-image.png?alt=media\&token=f7f664df-5f2e-4f55-bda4-9a5dd770580e) | **Image de titre large** | 1280 × 400 px | Utilisée à la place de l’image de titre dans l’en-tête de la carte. | {% hint style="info" %} **Un remplacement de logo carré masque la version large du modèle.** Google Wallet affiche la version large d’un logo dès qu’une version carrée et une version large existent toutes les deux. Un thème qui ne remplace qu’un logo carré — le logo, le logo du programme ou l’image de titre — resterait sinon masqué derrière la version large du modèle. Pour cette raison, la version large du logo du modèle n’est pas affichée sur les cartes portant un tel thème, et c’est le logo carré du thème qui s’affiche à la place. {% endhint %} Les tailles correspondent aux dimensions maximales rendues par chaque plateforme. Les fichiers plus grands sont réduits. Les images sont intégrées dans la carte exactement telles qu’elles sont stockées dans le thème, sans conversion de format ; seul le bandeau et le hero peuvent être recadrés, comme décrit ci-dessous. Utilisez des fichiers PNG transparents pour les logos afin que la couleur de la carte reste visible. ### Comment le bandeau et le hero sont recadrés Le fait que l’image par défaut soit recadrée dépend du modèle de carte, et non du thème. Lorsque l’optimisation des images est activée dans le modèle, l’image est recadrée aux tailles exactes du bandeau Apple et du hero Google. Sans cela, l’image est envoyée telle qu’elle a été téléversée et Apple Wallet ou Google Wallet l’ajuste à l’espace disponible. Dans les deux cas, une seule image par défaut sert à chaque type de carte, et le bandeau est plus court sur les cartes événementielles que sur les autres cartes. Un visuel dont le sujet est au centre et les bords unis se lit bien quelle que soit la façon dont il est finalement cadré. ### Quels emplacements s’appliquent à quel type de carte Cette matrice montre quels emplacements d’image utilise chaque type de carte. Un emplacement non affiché ici n’apparaît pas sur cette carte. | Emplacement | Fidélité | Carte de tampons | Carte cadeau | Offre | Carte événementielle | Générique | Poster | | -------------------------------- | -------- | ---------------- | ------------ | ----- | ------------------------------------------ | --------- | ------ | | Bandeau Apple / image par défaut | Oui | Oui | Oui | Oui | Oui — masque l’arrière-plan et la vignette | Non | Non | | Arrière-plan Apple | — | — | — | — | Oui | — | — | | Vignette Apple | — | — | — | — | Oui, sans bandeau | Oui | — | | Visuel Apple | — | — | — | — | — | — | Oui | | Logo principal Apple | — | — | — | — | — | — | Oui | | Logo secondaire Apple | — | — | — | — | — | — | Oui | | Hero Google | Oui | Oui | Oui | Oui | Oui | Oui | Oui | | Logo Google | — | — | — | — | Oui | Oui | — | | Logo du programme Google | Oui | Oui | Oui | — | — | — | — | | Image de titre Google | — | — | — | Oui | — | — | — | {% hint style="warning" %} Un thème appliqué à des cartes de plusieurs types doit inclure les emplacements du logo, du logo du programme et de l’image de titre, sinon le logo ne change que sur certaines cartes. {% endhint %} ## Créer un thème de carte Wallet Les thèmes se trouvent sous **Wallet → Thèmes**. Recherchez par nom et passez de l’affichage en carte à l’affichage en tableau. Les deux vues montrent les mêmes thèmes. L’affichage en carte montre l’image par défaut, les couleurs, le nom et l’identifiant. C’est le mieux pour choisir un thème visuellement.
The theme list in card view: each theme is a tile showing its artwork, its colours, its name and its identifier.

Affichage en carte. Vérifiez que chaque tuile affiche le visuel attendu pour la campagne — ici, un thème se reconnaît à son image plutôt qu’à son nom.

L’affichage en tableau liste chaque thème sous forme de ligne. Utilisez-le pour vérifier l’utilisation, les changements récents et les traductions. Les colonnes peuvent être triées, filtrées et masquées.
The theme list in table view, with columns for tags, colours, slots, languages, passes, created and modified.

Affichage en tableau. La colonne Cartes est celle à lire avant de modifier ou supprimer un thème : elle indique combien de cartes sont concernées.

| Colonne | Ce qu’elle affiche | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Identifiant | La référence fixe utilisée par les cartes, les automatismes et les systèmes externes. Elle est générée lorsque le thème est créé et ne change jamais. | | Étiquettes | Étiquettes en texte libre utilisées pour rechercher et filtrer les thèmes. Utilisez des étiquettes cohérentes pour les saisons, les campagnes et les programmes. | | Couleurs | Nuanciers de couleurs du thème. Une valeur vide hérite de la couleur du modèle. | | Emplacements | Le nombre de remplacements d’image. `0` signifie que toutes les images proviennent du modèle, à l’exception du bandeau Apple et du hero Google, qui utilisent l’image par défaut. | | Langues | Langues avec texte ou images traduits. `—` signifie langue par défaut uniquement. | | Cartes | Le nombre de cartes utilisant le thème. Un thème porté par des cartes ne peut pas être supprimé ; voir [Supprimer un thème de carte Wallet](#delete-a-wallet-pass-theme). | | Créé / Modifié | Date de création et dernière sauvegarde. Un thème actif récemment modifié peut avoir changé l’apparence de la carte. | Le **…** menu dans chaque ligne ou carte propose trois actions : modifier le thème, lister les cartes assignées ou le supprimer. La suppression n’est pas possible tant que des cartes portent le thème ou qu’un automatisme activé l’applique. ### En créer un Créez d’abord les images. Ajoutez ensuite les couleurs et le contenu facultatif. Cet ordre accélère la validation du design. 1. Accédez à **Wallet → Thèmes** et sélectionnez **Créer un thème**. 2. **Nommez-le.** Le nom de la campagne convient bien — *Summer 2026*, *Black Friday*. Le nom est ce que tout le monde verra plus tard dans le sélecteur de thèmes, et l’identifiant en est dérivé à la création et ne change jamais ; il vaut donc la peine de choisir le bon nom dès maintenant. 3. **Ajoutez des étiquettes.** Les étiquettes facilitent la recherche ultérieure des thèmes. Utilisez des libellés courts et cohérents tels que *saisonnier*, *été-2026*, et *fidélité*. 4. **Ajoutez l’image par défaut.** C’est la bannière qui couvre le bandeau Apple et le hero Google, sauf si un remplacement en remplace l’un des deux. Concevez-la en 1125 × 432 px, gardez le sujet au centre et laissez les bords unis : le bandeau est plus court sur les cartes événementielles que sur les autres cartes, et les champs se superposent à lui. 5. **Ajoutez des remplacements du modèle** pour tout ce que l’image par défaut ne couvre pas : sélectionnez **Ajouter un remplacement**, choisissez l’emplacement, téléversez le fichier et répétez l’opération pour chacun. 6. **Définissez les couleurs.** Couleur d’arrière-plan, de premier plan et de libellé pour Apple Wallet. Toute valeur laissée vide conserve celle du modèle. 7. **Rédigez le contenu**, si le thème doit afficher un titre ou une description. Le sélecteur de langue dans l’en-tête de la carte ajoute des traductions. 8. **Enregistrez.** Pour un thème qu’aucune carte n’utilise encore, c’est tout. Pour un thème déjà porté par des cartes, l’enregistrement pose d’abord une question.
The theme editor: default image and colours on the first row, content and template overrides below.

L’éditeur. L’en-tête compte les cartes portant le thème et indique quand elles prendront en compte un changement — vérifiez-le avant d’enregistrer.

The override picker: every position shows its size, which pass types it applies to, and a diagram of where it lands on the card.

Le sélecteur de remplacements. Chaque emplacement indique sa taille et les types de cartes auxquels il s’applique ; les emplacements déjà présents dans le thème sont marqués Ajouté.

Four positions replaced in the theme: Apple logo, thumbnail and icon, plus the Google program logo.

Quatre emplacements remplacés — le logo Apple, la vignette et l’icône, plus le logo du programme Google. Vérifiez que chaque emplacement dont dépend une campagne apparaît ici ; tout ce qui manque provient encore du modèle ou de l’image par défaut.

{% hint style="warning" %} **Il n’existe pas d’état brouillon.** Un thème est mis en ligne dès son enregistrement. Pour tester un design en toute sécurité, il faut créer un second thème et déplacer une carte de test dessus. {% endhint %} ### Enregistrer un thème déjà utilisé par des cartes Modifier un thème change son design partagé. Les cartes Wallet existantes conservent leur version actuelle jusqu’à leur rafraîchissement. La boîte de dialogue d’enregistrement contrôle si ce rafraîchissement se produit immédiatement. Lorsque aucune carte n’utilise le thème, l’enregistrement ne fait que stocker les modifications. Lorsque des cartes l’utilisent, le **Enregistrer le thème** boîte de dialogue affiche le nombre de cartes concernées. Elle propose aussi de rafraîchir ces cartes dans la même action.
The Save theme dialog, stating how many passes use the theme, with the push option switched on.

La boîte de dialogue d’enregistrement. Lisez le nombre de cartes, puis décidez : si le commutateur est désactivé, le thème est enregistré et les cartes se rafraîchissent d’elles-mêmes.

Avec le commutateur désactivé, **Enregistrer** met à jour le thème uniquement. Chaque carte reçoit le nouveau design lors de son prochain rafraîchissement. Utilisez cette option pour des changements mineurs ou la préparation avant lancement. Avec le commutateur activé, **Enregistrer et diffuser la mise à jour** enregistre le thème et rafraîchit chaque carte assignée. La boîte de dialogue affiche une durée estimée. **Paramètres avancés** contrôle la vitesse de rafraîchissement et l’actualisation des métadonnées. Utilisez cette option lorsque le visuel doit être en ligne immédiatement. **Annuler** annule les modifications. Le thème est enregistré avant le début du rafraîchissement. Si le rafraîchissement échoue, le thème reste enregistré. Enregistrez de nouveau avec le commutateur activé, ou utilisez un automatisme, pour réessayer. ### Limites pratiques Les images de thème doivent être au format PNG ou JPEG, car elles sont intégrées dans la carte exactement telles qu’elles sont stockées. Un téléversement dans un autre format, comme WebP, GIF ou SVG, est refusé. Lorsqu’une image est choisie dans le back office, elle est convertie en PNG au moment de son recadrage. Les images sont acceptées jusqu’à **8 Mo** chacune, le PNG transparent étant le format adapté aux logos. Un thème contient jusqu’à **20 étiquettes**, et une image par emplacement — il n’existe pas de second logo Apple. {% hint style="warning" %} **Les images fournies sous forme d’URL ne sont pas vérifiées.** La vérification du format s’applique uniquement aux fichiers téléversés. Une image référencée par une URL externe au lieu d’être téléversée n’est pas vérifiée quant à son format ; elle doit donc déjà être un fichier PNG ou JPEG. {% endhint %} ## Appliquer un thème aux cartes Wallet Un thème ne fait rien tant que des cartes ne pointent pas vers lui. Trois voies permettent cela : une carte à la fois dans le back office, un public entier via un automatisme, ou un système externe via l’API. ### À une seule carte, depuis le back office Utilisez cette voie lorsqu’une carte a besoin d’un design différent. Elle ne concerne que cette carte.
Exemples concrets * **Tester un design avant une campagne.** Le nouveau thème est appliqué à une carte de test et ouvert sur un vrai téléphone, à la fois dans Apple Wallet et dans Google Wallet, avant qu’un automatisme ne le présente à un public. * **Corriger un client.** Une carte qu’un automatisme a manquée, ou une carte qu’un agent du service client voit encore avec le visuel de la saison précédente. * **Une exception volontaire.** Une carte de personnel, une carte VIP ou une carte partenaire qui ne doit pas ressembler à celle de tout le monde.
1. Ouvrez la carte : **Wallet → Cartes**, puis la carte concernée. 2. Sélectionnez **Actions → Appliquer un thème**. 3. Choisissez un thème dans la grille. La boîte de dialogue s’ouvre sur le thème que la carte porte aujourd’hui, ce qui rend le point de départ visible. 4. Confirmez. Retirer le thème signifie plutôt choisir **Aucun — utiliser le type de carte tel qu’il est configuré** et confirmer avec **Retirer le thème**.
A pass detail page showing the Theme field and the Actions menu with Apply a theme.

Une carte porte au maximum un thème. Il est défini depuis le Thème champ de la carte, ou depuis Actions → Appliquer un thème.

The theme picker on a pass, showing each theme's artwork and colours.

Le sélecteur affiche le visuel et les couleurs de chaque thème, de sorte que le choix se fait sur le design plutôt que sur le nom.

La modification s’applique immédiatement. La carte se rafraîchit afin que le nouveau visuel atteigne l’appareil. ### À de nombreuses cartes, avec un automatisme Utilisez un automatisme pour déployer une campagne à grande échelle. Il sélectionne un public et applique un thème en fonction d’une date, d’un calendrier ou d’un événement de carte. 1. Accédez à **Engagement → Automatisations** et créez-en un. 2. Définissez le **déclencheur** : une date de lancement, une récurrence, un événement de carte ou une date relative à un champ de la carte. 3. Définissez le **public** avec des filtres — un type de carte, un niveau, un magasin. Sans filtre, toutes les cartes de la marque sont concernées. 4. Sélectionnez **Ajoutez une action → Appliquer un thème** et choisissez le thème. Retirer le thème signifie plutôt activer **Retirer le thème à la place**. 5. Définissez le **condition de fin**, puis enregistrez et activez l’automatisme.
The Add an action menu in an automation, with Apply a theme among the available actions.

Appliquer un thème est l’une des actions qu’un automatisme peut effectuer sur une carte.

An automation with an Apply a theme step, the audience above it and the theme picker on the right.

L’étape de thème dans une chaîne d’automatisation. Confirmez le public au-dessus de l’étape avant d’activer l’automatisme ; Retirer le thème à la place transforme la même étape en action de nettoyage.

Un automatisme peut combiner plusieurs actions. Il peut appliquer une offre, mettre à jour les données de la carte, modifier un modèle, appliquer un thème et envoyer une notification. La plateforme pousse la carte une seule fois après l’exécution de toutes les actions. Le rafraîchissement est silencieux. Ajoutez une **Envoyer une notification** action lorsqu’un utilisateur final doit être averti. L’application d’un thème laisse inchangés les champs et la structure de la carte. ### Depuis des systèmes externes Un CRM, une plateforme e-commerce ou une autre intégration peut créer une carte avec un thème. Elle peut aussi attribuer plus tard un thème différent. Définissez le champ du thème sur un identifiant de thème pour l’appliquer. Omettez le champ pour conserver le thème actuel. Envoyez une valeur vide pour le supprimer. Deux règles comptent lorsqu’une intégration gère aussi les thèmes eux-mêmes. Un identifiant de thème ne change jamais, car les cartes et les automatismes y font référence : mettre à jour un thème avec un corps `id` différent de `id` dans l’URL est refusé avec `400`. Et toute erreur provenant des points de terminaison des thèmes, comme l’erreur que renvoient les points de terminaison des cartes pour un `themeId`, est renvoyée sous forme de détails du problème (`application/problem+json`). Les erreurs de validation nomment le champ en cause, comme `id`, `file` ou `themeId`, afin que l’intégration puisse indiquer quelle valeur corriger. Les points de terminaison, les charges utiles et les autorisations sont disponibles dans la [référence de l’API](https://docs.thewalletcrew.io/api-reference/). Pour des changements à l’échelle d’un public, un automatisme demande généralement moins de travail d’intégration. ## Supprimer un thème de carte Wallet La suppression d’un thème est bloquée tant que quelque chose en dépend encore, afin qu’aucune carte ni aucun automatisme en cours ne pointe vers un thème disparu. Un thème ne peut pas être supprimé tant qu’une carte le porte, ou tant qu’un automatisme activé l’applique. Un automatisme désactivé ne bloque pas la suppression. Lorsque la suppression est bloquée, le back office explique pourquoi — le nombre de cartes portant le thème et les noms des automatismes qui l’appliquent — et l’action de suppression est désactivée. Le déblocage se fait en deux étapes : 1. Déplacez les cartes vers un autre thème, ou retirez-leur leur thème, une carte à la fois depuis la page de la carte ou pour un public via un automatisme. 2. Désactivez les automatismes listés, ou modifiez le thème qu’ils appliquent. Une fois qu’aucune carte ni aucun automatisme activé ne dépend du thème, l’action de suppression dans le **…** menu redevient disponible. Supprimer un thème supprime aussi ses images ; conservez donc les fichiers sources en dehors de The Wallet Crew. Une carte dont le thème est manquant revient à son modèle et est marquée comme *manquante* sur la page de la carte. ## Événements de thème et mises à jour de cartes Les changements dans le catalogue de thèmes peuvent notifier les webhooks connectés, les outils marketing et les systèmes du back office. Ces événements fournissent une piste d’audit et permettent aux autres systèmes de réagir automatiquement. ### Les trois événements de thème | Événement | Envoyé quand | Ce qu’il contient | | ---------------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Thème créé (`Theme:Created`) | Un thème est ajouté. | Quel thème — identifiant, nom et étiquettes — et qui l’a ajouté. | | Thème mis à jour (`Theme:Updated`) | Un thème existant est enregistré. | Quel thème — identifiant, nom et étiquettes — et qui l’a enregistré. Cela n’indique pas quelles parties du thème ont changé. | | Thème supprimé (`Theme:Deleted`) | Un thème est supprimé. | L’identité du thème — identifiant, nom et étiquettes — telle qu’elle était avant la suppression, ainsi que la personne qui l’a supprimé. Ses couleurs et ses images ne sont pas incluses. | Chaque événement de thème comporte un `thème` objet (`themeId`, `nom`, `étiquettes`) et un `utilisateur` objet (`credentialType`, `id`, `nom`) qui indique qui a effectué la modification. `credentialType` est `User` pour un utilisateur du back-office connecté, `ApiKey` pour une clé API, ou `Unknown` lorsque la modification s’est produite en dehors d’une requête et ne porte aucune identité. Pour un `User`, `id` est l’identifiant utilisateur chez le fournisseur d’identité ; pour un `ApiKey`, il s’agit de `apiKey:{name}` et `nom` est le nom sous lequel la clé a été émise ; pour `Unknown`, `id` peut être vide. Les événements ne contiennent aucune adresse e-mail : l’ [API des utilisateurs](/api-reference/advanced/users.md) associe un identifiant utilisateur à une personne. Cette identité correspond à l’historique de configuration. ### Lorsqu’une Carte est affectée à un thème Les événements de thème décrivent les changements du catalogue. Les événements de Carte décrivent les changements apportés à une Carte individuelle. | Événement | Envoyé quand | Ce qu’il contient | | ------------------------------------------------------------------ | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Thème de Carte modifié (`Carte:ThemeChanged`) | Une Carte est déplacée vers un thème différent, ou son thème lui est retiré. | La Carte, le thème qu’elle porte maintenant, et le thème qu’elle portait auparavant. L’un ou l’autre peut être vide — vide avant signifie qu’elle n’en avait pas, vide après signifie que le thème a été retiré. | | Carte créée / Carte mise à jour (`Carte:Created`, `Carte:Updated`) | Chaque création et chaque mise à jour, avec thème ou non. | Le thème que porte la Carte, ainsi que son modèle et ses identifiants. | *Carte mise à jour* indique l’état actuel de la Carte. *Thème de Carte modifié* enregistre le déplacement et les deux valeurs de thème. Utilisez la seconde pour mesurer l’attribution d’une campagne sans comparer l’historique des Cartes. *Thème de Carte modifié* est envoyé uniquement lorsque le thème assigné diffère. Enregistrer à nouveau le même thème n’envoie aucun événement. Créer une Carte avec un thème envoie *Carte créée*, pas *Thème de Carte modifié*. Le même comportement s’applique aux modifications du back-office, de l’automatisation et de l’API. Comme pour chaque événement de Carte, *Thème de Carte modifié* ne comporte aucun acteur : ni utilisateur ni clé API. L’événement indique ce qui a été déplacé, pas qui l’a déplacé.
Exemples concrets * Conserver une trace de la personne qui a modifié un thème saisonnier, et à quelle date. * Avertir un canal lorsqu’un thème en production est modifié, puisque chaque Carte qui le porte est sur le point de changer. * Mesurer le déploiement d’une campagne en comptant les Cartes qui ont été déplacées vers son thème. * Informer un système en aval qu’un habillage de campagne a été déployé, sans avoir à l’interroger régulièrement.
## Liste de contrôle de lancement pour un thème de carte Wallet Un thème devient actif lorsqu’il est enregistré. Il ne revient pas automatiquement en arrière. Vérifiez les points suivants avant le lancement : * **Planifiez la date de fin.** Créez une deuxième automatisation pour appliquer le thème suivant ou supprimer le thème actuel. * **Vérifiez les deux plateformes.** Apple Wallet et Google Wallet utilisent des emplacements d’image différents. * **Vérifiez les langues.** Lorsque le thème a un titre ou une description traduits, confirmez que le modèle les affiche via des valeurs par langue ; sinon une seule langue s’affiche partout. * **Testez d’abord une Carte.** Installez une Carte de test, appliquez le thème et examinez-le sur chaque type d’appareil. Un thème encore porté par des Cartes, ou appliqué par une automatisation activée, ne peut pas être supprimé. Les étapes pour le libérer se trouvent dans [Supprimer un thème de carte Wallet](#delete-a-wallet-pass-theme). ## FAQ
Quand un thème est-il le bon outil plutôt qu’une modification du modèle ? Utilisez un thème lorsque seul le design visuel change : couleurs, images ou titre saisonnier. Modifiez le modèle lorsque la Carte elle-même change, par exemple ses champs, son code-barres ou sa structure.
Quelle est la différence entre un thème et une offre ? Une offre donne aux utilisateurs finaux quelque chose à utiliser. Elle peut inclure des dates de validité, du stock et une utilisation. Un thème ne change que l’apparence. Une automatisation peut appliquer une offre et un thème ensemble.
Une Carte peut-elle porter deux thèmes ? Non. Une Carte porte un seul thème, ou aucun. Les thèmes ne se cumulent pas.
Quand les utilisateurs finaux voient-ils réellement le nouveau look ? Les utilisateurs finaux voient le changement lorsque leur Carte se rafraîchit. L’application d’un thème directement ou via une automatisation rafraîchit la Carte immédiatement. La modification d’un thème rafraîchit les Cartes assignées uniquement lorsque **Envoyer la mise à jour à ces Cartes également** est activé lors de l’enregistrement. Sinon, chaque Carte attend sa prochaine actualisation. Les actualisations sont silencieuses. Ajoutez une **Envoyer une notification** étape pour avertir les utilisateurs finaux.
Comment rétablir l’apparence précédente ? Rien ne revient automatiquement en arrière. Appliquez le thème suivant ou retirez le thème actuel. Utilisez la page de la Carte pour une Carte, ou une automatisation pour une audience.
Peut-on essayer un thème sans toucher aux Cartes en production ? Oui. La création d’un thème ne modifie aucune Carte. Appliquez-le à une Carte de test et examinez-le sur un appareil physique avant un déploiement plus large.
Quel format d’image doit être utilisé pour un thème de carte Wallet ? PNG ou JPEG, jusqu’à 8 Mo. Les autres formats, comme WebP, GIF ou SVG, sont refusés, car les images sont intégrées dans la Carte exactement comme elles sont stockées. Une image fournie sous forme d’URL externe n’est pas vérifiée, elle doit donc déjà être au format PNG ou JPEG. Utilisez des fichiers PNG transparents pour les logos, et des visuels à la taille indiquée ou plus grands.
Pourquoi le titre du thème s’affiche-t-il dans une seule langue ? C’est le modèle qui décide. `{{ theme.title }}` et `{{ theme.description }}` suivent la langue de l’appareil uniquement lorsque le modèle les place dans ses valeurs traduites, les valeurs par langue d’un champ. Un champ écrit une seule fois est rendu une seule fois, dans une seule langue. Déplacez l’espace réservé dans les valeurs par langue du champ, puis actualisez une Carte de test sur un appareil configuré pour chaque langue.
Apple Wallet et Google Wallet affichent-ils les mêmes images de thème ? Non. L’image par défaut devient la bande Apple Wallet et le visuel principal Google Wallet, sauf si le thème remplace l’un ou l’autre emplacement. Les autres emplacements diffèrent selon la plateforme et conservent l’image du modèle sauf remplacement. Apple Wallet prend en charge des images spécifiques à la langue. Google Wallet utilise l’image de la langue par défaut.
Pourquoi l’image par défaut est-elle recadrée différemment sur deux Cartes ? La bande est plus courte sur les billets d’événement que sur les autres Cartes, et une seule image par défaut sert à tous les types de Carte. Lorsque l’optimisation des images est activée dans le modèle, l’image est recadrée aux dimensions exactes de la bande et du visuel principal ; sans cela, Wallet ajuste l’image telle qu’elle a été importée. Garder le sujet au centre de l’image évite de le perdre dans les deux cas.
Peut-on supprimer un thème actif ? Non. Un thème ne peut pas être supprimé tant qu’une Carte le porte ou qu’une automatisation activée l’applique ; une automatisation désactivée ne le bloque pas. Le back-office indique le nombre de Cartes et les automatisations concernées. Déplacez les Cartes vers un autre thème ou retirez leur thème, puis désactivez ces automatisations ou changez le thème qu’elles appliquent. Conservez les fichiers image source en dehors de The Wallet Crew, car la suppression supprime les images du thème.
--- # 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/wallet-pass-themes.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.