> 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/gift-card.md).

# Carte-cadeau

Configurez un modèle de Carte-cadeau pour Apple Wallet et Google Wallet. Affichez la valeur stockée, prenez en charge l'utilisation du code-barres/NFC et maintenez le solde à jour.

Que vous soyez un nouveau client créant le modèle des cartes cadeau qui seront distribuées aux clients, ou déjà familier avec The Wallet Crew et en train de 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 carte cadeau qui reflète l’identité de la marque, affiche les bonnes informations aux clients et garantisse une expérience fluide sur Apple Wallet et Google Wallet.

Utilisez une **Carte cadeau** carte lorsque la carte représente **une valeur stockée**. Ce modèle est conçu pour l’affichage du solde et les mises à jour du solde.

Cas typiques :

* Solde initial à l’émission
* Utilisations partielles qui diminuent le solde
* Rechargements et remboursements qui mettent à jour la même carte

Si la carte est un coupon de réduction (et non une valeur stockée), utilisez [Offre](/guides-design/fr/conception/offer.md) à la place.

### Architecture

Apple et Google ont leurs propres modèles de carte cadeau, 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%2FqflWMnQj01M5Z3InyRIX%2Fdesign-gift-card-apple-gift-card.png?alt=media&amp;token=f1a8602f-2021-4cc5-8467-813a922ca7ef" alt="Apple gift card template"><figcaption><p>Vérifiez où se trouvent le solde, le code-barres et le contenu du dos de la carte dans la mise en page de la carte cadeau 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%2FbXxFQkk8USoxZRNAkaS4%2Fdesign-gift-card-google-gift-card.png?alt=media&amp;token=a31f21b8-a9e6-4fc3-b894-6bef0837987b" alt="Google gift card template"><figcaption><p>Vérifiez comment Google répartit la même carte cadeau entre les zones d’en-tête, de solde et de messages.</p></figcaption></figure>
{% endtab %}
{% endtabs %}

{% 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/retail/gift-cards/resources/template?hl=fr>" %}

### Comment le configurer sur The Wallet Crew

The Wallet Crew propose un **concepteur de modèles** utilisé pour **personnaliser les cartes cadeau** distribuées aux clients. Voyons en détail comment personnaliser chaque section.

## Apple

**Examinons les 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 cadeau, 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, **d’activer le partage de la carte cadeau** afin que les clients puissent la transmettre à d’autres personnes, la fonctionnalité « void » pour les coupons, ainsi qu’une date de pertinence et une date d’expiration utilisées pour les billets d’événement.

La section **définit également la distance** par rapport à une latitude et une longitude de référence à laquelle la carte est pertinente, 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%2FQAcDuBXWIj1Zxgl0pfnb%2Fdesign-gift-card-gift-card-general-apple.png?alt=media&amp;token=ab7b2713-84b2-4215-919d-3c0afe46763c" alt="Gift card - 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 logiciel de caisse. La valeur du code-barres correspond aux **identifiants** qui permettent à la carte d’être identifiée par le terminal en magasin. Enfin, le texte de remplacement 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%2FqiMO4xy7EXha95JqyUec%2Fdesign-gift-card-gift-card-barcode-apple.png?alt=media&amp;token=cc2a0ec1-f25a-45d2-adc6-c7d945897d41" alt="Gift card - barcode Apple"><figcaption><p>Vérifiez que le type de code-barres correspond à ce que le scanner en magasin accepte.</p></figcaption></figure>

### Couleurs et images

Pour modifier la couleur de fond de la carte, il suffit de **ajouter le code couleur dans les champs** prévus à cet effet. Pour ajouter une image, téléversez-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%2FyHbMewC0mv5Xlg5pTQbh%2Fdesign-gift-card-gift-card-colors-images-apple.png?alt=media&amp;token=6b9d1db9-bcf0-47e9-b9f6-2aaf94e043e9" alt="gift card - colors and images Apple"><figcaption><p>Vérifiez le contraste entre la couleur de fond et le texte une fois le logo téléversé.</p></figcaption></figure>

### Champs d’en-tête

Cette section est particulièrement importante dans la version Apple, car les cartes sont **empilées les unes sur les autres**. Seul l’en-tête de la carte 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 le montant disponible.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FPqOqmnAssRd9JrPQd47r%2Fdesign-gift-card-gift-card-header-fields-apple.png?alt=media&amp;token=bf3692e1-a28e-4b63-a756-ad96695c9fb6" alt="gift card - header fields Apple"><figcaption><p>Vérifiez que le solde restant est la valeur affichée dans le champ d’en-tête.</p></figcaption></figure>

### Champs recto

Les champs recto sont les champs utilisés pour **afficher des informations sur le recto de la carte**, sous l’image du bandeau. Le libellé est le même pour chaque utilisateur (par langue), mais la valeur peut être personnalisée pour afficher, par exemple, la date d’expiration de la carte.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FhwnwCAReZ4TvwsoPbATq%2Fdesign-gift-card-display-information-recto-card.png?alt=media&amp;token=a17c485b-5920-4634-af14-9fe7dddef933" alt="display information in the recto of the card"><figcaption><p>Vérifiez que chaque champ recto comporte un libellé statique et une valeur dynamique.</p></figcaption></figure>

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

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

Cette section, située au dos de la carte cadeau, inclut plusieurs informations utiles pour le client :

* La date d’expiration de la carte cadeau
* Le montant
* Reçus
* Messages personnalisés
* Liens, tels que les 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%2FP7BKUqHtyjFUMrB2wyoo%2Fdesign-gift-card-gift-card-backfields-apple.png?alt=media&amp;token=de68438b-48a3-416f-898f-20829b1ee5e5" alt="gift card - backfields Apple"><figcaption><p>Vérifiez que le lien vers les conditions générales est présent parmi les champs verso.</p></figcaption></figure>

### Autres sections

Sur Apple, il y a quatre autres sections :

* **Lieux** : utilisées pour les notifications de géorepérage.
* **Balises** : également utilisées pour les notifications de géorepérage.
* **Identifiant du magasin associé** : utilisé pour lier une application publiée sur l’App Store
* **NFC** : une fonctionnalité qui permet aux clients d’échanger du contenu numérique et de connecter des appareils électroniques d’un 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 « enregistrer » 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 éléments à connaître avant de configurer le modèle Google :**
{% endhint %}

1. Certains champs, tels que l’émetteur et le nom du programme, sont **obligatoires**
2. Google préconfigure les champs en fonction de leur valeur prévue, donc conservez le solde dans les champs dédiés solde/valeur
3. Les valeurs dynamiques (par ex. {{balance}}) doivent être **placées dans les champs dynamiques dédiés**. Les champs « libellé » sont destinés uniquement au texte statique.

**Examinons les 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 la carte
* **Nom du programme** : il apparaît sur le recto de la carte et correspond généralement au nom du programme de la carte cadeau
* **Numéro de carte** : le numéro de la carte cadeau

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FH4NMlJ7nTJxO1niBYNJJ%2Fdesign-gift-card-gift-card-general-google.png?alt=media&amp;token=2d8a06fe-a6dc-4e07-abfd-cdb90d404321" alt="gift card - general section Google"><figcaption><p>Vérifiez que Émetteur, Nom du programme et Numéro de carte sont tous renseignés.</p></figcaption></figure>

### Code-barres

Choisissez le **type de code-barres** compatible avec le logiciel de caisse. La valeur du code-barres correspond aux **identifiants** qui permettent à la carte d’être identifiée par le terminal en magasin. Enfin, le texte de remplacement 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%2FziAbYWFNDvlxtO31QTwE%2Fdesign-gift-card-gift-card-barcode-google.png?alt=media&amp;token=907c5583-91b8-4620-b343-1f06d64e5a75" alt="gift card - barcode Google"><figcaption><p>Vérifiez que la valeur du code-barres et son texte de remplacement correspondent à l’identifiant de la carte.</p></figcaption></figure>

### Sécurité

Configurer un modèle, c’est décider **si le client peut partager sa carte ou non**. Google propose trois options :

* **Plusieurs titulaires** : 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%2FgYUT6le5vwesK0jhmI2s%2Fdesign-gift-card-gift-card-security-google.png?alt=media&amp;token=cf2275ad-6249-4043-af22-a913d2f282e3" alt="gift card - security Google"><figcaption><p>Vérifiez que l’option de partage sélectionnée correspond aux règles du programme de cartes cadeau.</p></figcaption></figure>

### Couleurs et images

Pour modifier la couleur de fond de la carte, il suffit de **ajouter le code couleur dans les champs** prévus à cet effet. Pour ajouter une image, téléversez-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%2Ftk0K2oh1ba7i6LEdGl3i%2Fdesign-gift-card-gift-card-colors-images-google.png?alt=media&amp;token=16d868e8-6e3d-49d8-a4b4-1db2e1a5ee12" alt="gift card - colors and images Google"><figcaption><p>Vérifiez que l’image principale et le logo s’affichent correctement avec la couleur de fond choisie.</p></figcaption></figure>

### Solde et code PIN

Cette section utilise la valeur dynamique du montant de la carte cadeau et la devise, car ce sont des champs obligatoires. Un libellé PIN et un PIN peuvent également être configurés si nécessaire.

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2FsVutgHg2esocR10hHGgT%2Fdesign-gift-card-gift-card-balance-pin-google.png?alt=media&amp;token=52eaa9da-e0ff-4b6e-b5ed-ad8d16e350f4" alt="gift card - balance and pin Google"><figcaption><p>Vérifiez que le solde utilise une valeur dynamique et que la devise est définie.</p></figcaption></figure>

### Liens supplémentaires, Smart tap et intervalle de validité

**Liens supplémentaires** peuvent être ajoutés à la carte cadeau du client, par exemple un lien vers un site Web.

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

Enfin, la section Intervalle de validité **définit quand une carte cadeau peut être utilisée.**

<figure><img src="https://2331677975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F96iMF0cPuLTC7ZRnUWG9%2Fuploads%2F1uNaubkUNr85KWJ3y170%2Fdesign-gift-card-gift-card-smart-tap-google.png?alt=media&amp;token=30a9c000-dba0-47a8-8e0c-2ddc0303c155" alt="gift card - smart tap Google" width="375"><figcaption><p>Vérifiez le réglage Smart tap ainsi que les dates de début et de fin de la période de validité.</p></figcaption></figure>

### Messages

Cette section, située au dos de la carte cadeau, inclut plusieurs informations utiles pour le client :

* La date d’expiration de la carte cadeau
* Le montant
* Reçus
* Messages personnalisés
* Liens, tels que les 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%2FMMMZG34BZWrHgexqbgy5%2Fdesign-gift-card-gift-card-messages-google.png?alt=media&amp;token=b19a4210-fc85-4dd0-a8df-0796c1fb01b0" alt="gift card - messages 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 de valeur ajoutée

Cette section ajoute une **petite zone en bas de la carte cadeau**. Elle sert à afficher des offres ou des actualités.

### Autres sections

Sur Google, il y a trois autres sections :

* **Liens vers l’application** : utilisé pour ajouter un lien vers une application
* **Page d’accueil** : utilisé pour ajouter le lien du site Web de l’événement
* **Lieux** : utilisé pour les notifications de géorepérage

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

### Étapes suivantes

* Pour les consignes de conception, commencez par [Conception de carte](/configure/fr/advanced-configuration/wallet/template-configuration/cards-design-colors-images-and-fields.md).
* Pour distribuer la carte, utilisez [Ajouter à Wallet sur un site Web](/guides-enrolment/fr/inscription/on-your-website.md).


---

# 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/gift-card.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.
