> 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/readme-1.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 commence à partir 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 l’identité visuelle et les règles de correspondance par-dessus.

<details>

<summary><strong>Exemples concrets</strong></summary>

* Fidélité en magasin : une carte de fidélité affiche l’identifiant du 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 promotionnelle affiche une date d’expiration et un code scannable, puis est marquée comme utilisée.
* Événements et visites : un 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.

</details>

## Modèle

Un modèle est la couche de configuration appliquée sur un type de carte Apple Wallet / Google Wallet. C’est là que l’identité visuelle et le mappage des champs sont définis une fois, puis réutilisés sur toutes les cartes émises.

#### Ce que contrôle un modè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 avant, champs arrière, messages).
* Libellés, ordre et formatage (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é de 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 restitue et met à jour la carte Wallet à partir de ces données source de vérité. Cela permet à la carte de rester cohérente avec les opérations, tout en bénéficiant de l’UX du 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 ne rendent pas de données arbitraires. Ils affichent une carte qui suit un modèle prédéfini. Un modèle est le moyen pratique de maintenir 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 identité visuelle cohérente sur les 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 cartes. Le bon choix dépend du flux de travail 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 au fil du temps.

Le contenu type comprend un identifiant de membre, un niveau/statut, des points ou des tampons, et des liens d’assistance. L’utilisation se fait généralement via un code-barres/QR scanné au POS, puis 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/loyalty-card-template-configuration.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 type comprend le nom de l’événement, le lieu, la date/l’heure, le siège/la section, la porte 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/event-ticket.md).

#### Carte-cadeau

Utilisez une carte-cadeau lorsque la carte représente une valeur stockée qui doit diminuer ou augmenter au fil du temps.

Le contenu type comprend un identifiant de carte, le solde et la devise, la date d’expiration le cas échéant, et un code-barres/QR d’utilisation (ou NFC lorsque pris en charge). Les mises à jour du solde après utilisation constituent l’exigence principale.

Plus de détails : [Carte-cadeau](/guides-design/fr/conception/gift-card.md).

#### Offre

Utilisez une offre pour les coupons ou promotions limités dans le temps, généralement utilisables une seule fois.

Le contenu type comprend un titre d’offre, une date d’expiration, des conditions et un code de validation (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/offer.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 scannable ou présentable 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/generic.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 différentes mises en page, différentes contraintes ou différentes règles de contenu.

Raisons courantes :

* Plusieurs marques, programmes ou unités commerciales sous un même locataire.
* Différents produits avec une densité d’information différente (standard vs VIP, basique vs premium).
* Différents textes juridiques ou contacts du support client selon le programme.
* Différentes langues nécessitant des libellés et une structure de contenu différents.
* Différentes stratégies de code-barres ou contextes de scan (POS vs contrôle d’accès).

### Étapes suivantes

La création et la conception du modèle sont généralement faites une seule fois, puis itérées avec un retour opérationnel réel.

* Commencez par [Comment créer un modèle](/configure/fr/advanced-configuration/wallet/template-configuration/how-to-create-a-template.md).
* Pour les règles de mise en page et les exigences relatives aux ressources, utilisez [Conception des cartes (couleurs, images et champs)](/configure/fr/advanced-configuration/wallet/template-configuration/cards-design-colors-images-and-fields.md).
* Pour les programmes multilingues, utilisez [Comment traduire un modèle](/configure/fr/advanced-configuration/wallet/template-configuration/how-to-translate-a-template.md).

## FAQ

<details>

<summary><strong>Quelle est la différence entre un type de carte, un modèle et une carte ?</strong></summary>

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 l’identité visuelle, les champs et les règles de correspondance.

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.

</details>

<details>

<summary><strong>Une carte peut-elle être mise à jour après l’installation ?</strong></summary>

Oui. Les mises à jour sont une capacité clé du Wallet. The Wallet Crew met à jour la même carte installée, donc les clients n’ont pas besoin de la rajouter.

</details>

<details>

<summary><strong>Un seul modèle suffit-il pour tout un programme ?</strong></summary>

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.

</details>

<details>

<summary><strong>Un modèle décide-t-il si une carte est valide ?</strong></summary>

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.

</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 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/readme-1.md?ask=<question>&goal=<endgoal>
```

`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.
