> 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/types-de-carte-et-modeles.md).
# Types de Carte et modèles
Un modèle définit la structure et la conception d’une Carte Wallet. Il contrôle la mise en page, les libellés, les images et les points de données qui apparaissent sur la Carte.
Dans The Wallet Crew, chaque modèle part d’un **type de Carte**. Le type de Carte définit la forme de base et les contraintes requises par Apple Wallet et Google Wallet. Le modèle applique ensuite la marque et les règles de mappage par-dessus.
Exemples concrets
* Fidélité en magasin : une Carte de fidélité affiche l’ID membre, le niveau, les points et un code-barres.
* Cartes cadeaux : une Carte à valeur stockée affiche le solde actuel et se met à jour après chaque utilisation.
* Coupons : une Carte d’offre affiche une date d’expiration et un code à scanner, puis passe à l’état « utilisée ».
* Événements et visites : une Carte de billet d’événement affiche le lieu et l’heure, et permet un scan rapide à l’entrée.
* Adhésion et services : une Carte générique prend en charge les badges du personnel, les cartes de garantie ou les justificatifs de retrait.
## Modèle
Un modèle est la couche de configuration appliquée au-dessus d’un type de Carte Apple Wallet / Google Wallet. C’est là que la marque et le mappage des champs sont définis une seule fois, puis réutilisés pour toutes les Cartes émises.
#### Ce qu’un modèle contrôle
Un modèle contrôle l’apparence de la Carte et la façon dont les données sont présentées :
* Conception visuelle (couleurs, logos, images).
* Disposition des champs (champs du recto, champs du verso, messages).
* Libellés, ordre et mise en forme (y compris les traductions).
* Configuration du code-barres/QR et valeur affichée.
* Contraintes spécifiques au fournisseur (Apple vs Google).
#### Ce qu’un modèle ne contrôle pas
Un modèle n’est pas la source de vérité pour l’état métier. La validité, les soldes, les droits et les règles d’utilisation restent dans les systèmes en amont (CRM, moteur de fidélité, POS, billetterie, e-commerce ou backend).
The Wallet Crew génère et met à jour la Carte Wallet à partir de ces données source de vérité. Cela maintient la Carte cohérente avec les opérations, tout en profitant de l’expérience Wallet (accès hors ligne, présentation native à l’appareil et mises à jour).
#### Pourquoi un modèle est nécessaire
Apple Wallet et Google Wallet n’affichent pas de données arbitraires. Ils affichent une Carte qui suit un modèle prédéfini. Un modèle est la manière pratique de conserver ce modèle stable dans le temps.
Les modèles permettent de :
* Définir un schéma stable (quels champs existent et ce qu’ils signifient).
* Décider de ce qui apparaît au recto par rapport au verso.
* Conserver une image de marque cohérente sur l’ensemble des Cartes émises.
* Valider les contraintes tôt (champs obligatoires, formats pris en charge, tailles d’image).
### Choisir le bon type de Carte
The Wallet Crew prend en charge plusieurs types de Carte. Le bon choix dépend du flux opérationnel et des données qui doivent rester à jour.
#### Carte de fidélité
Utilisez une Carte de fidélité lorsque la Carte représente une relation client continue et doit être mise à jour dans le temps.
Le contenu typique comprend un identifiant membre, un niveau/statut, des points ou des tampons, ainsi que des liens d’assistance. L’utilisation se fait généralement via un code-barres/QR scanné au POS, suivi d’une mise à jour des points ou du niveau.
Plus de détails : [Configuration du modèle de Carte de fidélité](/guides-design/fr/conception/configuration-du-modele-de-carte-de-fidelite.md).
#### Billet d’événement
Utilisez un billet d’événement lorsque le flux principal est un contrôle d’accès avec un scan rapide à l’entrée.
Le contenu typique comprend le nom de l’événement, le lieu, la date/heure, le siège/la section, la porte d’entrée et un code-barres/QR. Les mises à jour sont utiles pour les changements d’horaire, les changements de siège ou les messages opérationnels.
Plus de détails : [Billet d’événement](/guides-design/fr/conception/billet-devenement.md).
#### Carte cadeau
Utilisez une Carte cadeau lorsque la Carte représente une valeur stockée qui doit diminuer ou augmenter dans le temps.
Le contenu typique comprend un identifiant de carte, un solde et une devise, une date d’expiration le cas échéant, ainsi qu’un code-barres/QR d’utilisation (ou NFC lorsque pris en charge). Les mises à jour du solde après utilisation sont l’exigence principale.
Plus de détails : [Carte cadeau](/guides-design/fr/conception/carte-cadeau.md).
#### Offre
Utilisez une offre pour des coupons ou promotions limités dans le temps, généralement utilisés une seule fois.
Le contenu typique comprend un titre d’offre, une date d’expiration, des conditions et un code d’utilisation (code-barres/QR ou code promo). L’offre peut être mise à jour pour refléter l’état d’utilisation.
Plus de détails : [Offre](/guides-design/fr/conception/offre.md).
#### Générique
Utilisez une Carte générique lorsqu’aucun type de Carte dédié ne correspond au cas d’usage, mais qu’un justificatif à scanner ou à présenter reste nécessaire.
Les cas courants incluent les cartes d’adhésion qui ne sont pas des programmes de fidélité, les badges du personnel, les cartes de garantie, les réservations de service ou les justificatifs de retrait.
Plus de détails : [Générique](/guides-design/fr/conception/generique.md).
### Quand plusieurs modèles ont du sens
La plupart des projets commencent avec un modèle par type de Carte. Plusieurs modèles sont utiles lorsque les Cartes nécessitent des mises en page différentes, des contraintes différentes ou des règles de contenu différentes.
Les raisons courantes incluent :
* Plusieurs marques, programmes ou unités commerciales sous un même tenant.
* Différents produits avec des densités d’information différentes (standard vs VIP, basique vs premium).
* Des mentions légales ou des contacts d’assistance client différents selon le programme.
* Des langues différentes nécessitant des libellés et une structure de contenu différents.
* Des stratégies de code-barres différentes ou des contextes de scan différents (POS vs contrôle d’accès).
### Étapes suivantes
La création et la conception du modèle sont généralement effectuées une seule fois, puis itérées grâce à de vrais retours opérationnels.
* Commencez par [Comment créer un modèle](broken://spaces/rH9XqI2enbyJTGPIB8BO/pages/30a9cb82b130f59a2e866d95b57609c43bbdc97f).
* Pour les règles de mise en page et les exigences concernant les ressources, utilisez [Conception de carte (couleurs, images et champs)](broken://spaces/rH9XqI2enbyJTGPIB8BO/pages/bfd95940a350a5a1e16526ea2fbc577e63907585).
* Pour les programmes multilingues, utilisez [Comment traduire un modèle](broken://spaces/rH9XqI2enbyJTGPIB8BO/pages/79734e5090c0b5a240584f0414c7dc37124082c1).
## FAQ
Quelle est la différence entre un type de Carte, un modèle et une Carte ?
Le type de Carte est le modèle de base requis par Apple Wallet et Google Wallet (fidélité, offre, carte cadeau, billet d’événement, générique).
Un modèle est une instance configurée de ce type de Carte dans The Wallet Crew. Il définit la marque, les champs et les règles de mappage.
Une Carte est l’objet individuel installé par un client. Elle utilise un seul modèle à la fois et peut être mise à jour tout au long de son cycle de vie.
Une Carte peut-elle être mise à jour après l’installation ?
Oui. Les mises à jour sont une fonctionnalité essentielle de Wallet. The Wallet Crew met à jour la même Carte installée, donc les clients n’ont pas besoin de la rajouter.
Un seul modèle suffit-il pour tout un programme ?
Souvent oui. Un modèle par type de Carte est une base courante. Plusieurs modèles sont utiles lorsque différentes mises en page ou règles de contenu sont nécessaires.
Un modèle décide-t-il si une Carte est valide ?
Non. La validité et l’état métier restent dans les systèmes sources. Le modèle contrôle la façon dont cet état est affiché dans Apple Wallet et Google Wallet.
---
# 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/guides-design/fr/conception/types-de-carte-et-modeles.md?ask=&goal=
```
`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.