# Carte cadeau

Que vous soyez un nouveau client souhaitant créer le modèle des cartes-cadeaux que vous distribuerez à vos clients, ou un expert Wallet Crew cherchant à mettre à jour un modèle existant, cet article vous guidera à travers notre concepteur de modèles. L'objectif est de configurer un modèle de carte-cadeau qui reflète l'identité de votre marque, affiche les bonnes informations à vos clients et garantit une expérience fluide sur Apple Wallet et Google Wallet.

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

Schémas typiques :

* Solde initial lors de l'émission
* Remboursements partiels qui diminuent le solde
* Recharges et remboursements qui mettent à jour la même carte

Si votre carte est un coupon de réduction (pas une valeur stockée), utilisez [Offres](https://docs.thewalletcrew.io/fr/conception/offer) à la place.

### Architecture

Apple et Google ont leurs propres modèles de cartes-cadeaux comme vous pouvez le voir ci-dessous.

{% tabs %}
{% tab title="Apple" %}

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-96d7f7277eac68ec9a16f78c7659404032c3ccd1%2Fgift_card_1.png?alt=media" alt="Apple gift card template"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Google" %}

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-97891e39f3d14769904b07f0b9a0e4f2d0c1915b%2Fgift_card_2.png?alt=media" alt="Google gift card template"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Si vous voulez aller plus loin, trouvez 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

Avec The Wallet Crew, vous avez accès à un **concepteur de modèles** qui vous permet de **personnaliser les cartes-cadeaux** que vous distribuerez à vos clients. Voyons en détail comment personnaliser chaque section.

## Apple

**Jetons un coup d’œil aux différentes sections du concepteur de modèles Apple.**

### Section générale

Dans la section générale, vous avez deux champs obligatoires que vous devez remplir :

* **Description** : une brève description de la carte-cadeau, qui apparaîtra au verso de la carte
* **Nom de l’organisation**  : le nom de votre entreprise ou de votre marque

Vous avez également la possibilité d’ajouter un texte à côté de votre logo, **activer le partage de la carte-cadeau** si vous souhaitez que vos clients puissent la partager ou non avec d'autres personnes, la « fonction d'annulation » pour les coupons, une date pertinente et une date d'expiration utilisées pour les billets d'événement.

Vous pouvez aussi **définir la distance** à partir d'une latitude et d'une longitude pertinentes où la Carte est pertinente, pour **les notifications de géorepérage.**

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FYYR9VEYb554uR5QXWS5c%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2014.34.46.png?alt=media&#x26;token=f3fc18fb-6923-4b84-a5e4-dd5823c6f1db" alt="Gift card - general section Apple"><figcaption></figcaption></figure>

### Code-barres

Choisissez le **type de code-barres** qui est compatible avec votre logiciel de point de vente. La valeur du code-barres correspond au **identifiers** qui vous permettra d'identifier la carte avec votre terminal en magasin. Enfin, le texte alternatif peut être utilisé pour afficher les données du code-barres au cas où le code-barres ne pourrait pas être scanné.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FFqk4obXeLqVQZ9bjVq8T%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2014.36.04.png?alt=media&#x26;token=278548c7-6f8f-4a2d-8de5-61ef5b1d58f2" alt="Gift card - barcode Apple"><figcaption></figcaption></figure>

### Couleurs et images

Pour changer la couleur d'arrière-plan de votre carte, il suffit de **ajouter le code couleur dans les champs** prévu à cet effet. Pour ajouter une image, téléversez-la depuis votre appareil.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FegA8qJwPYgZUGOkX1SOA%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2014.37.44.png?alt=media&#x26;token=a24cf1cb-df93-4d17-b990-8e0220df40ae" alt="gift card - colors and images Apple"><figcaption></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 encourage à cliquer sur la carte, notamment en affichant l'information la plus importante comme le montant disponible.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FYceBWv66HIq7ItRwlaub%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2014.38.56.png?alt=media&#x26;token=50fb4df8-60cc-4f8f-8961-a7c554b6b753" alt="gift card - header fields Apple"><figcaption></figcaption></figure>

### Champs avant

Les champs avant sont les champs qui servent à **afficher des informations au recto de la carte**, sous l'image de la bande. Le libellé que vous choisirez est le même pour chaque utilisateur (par langue), mais vous pouvez personnaliser la valeur à afficher, par exemple la date d'expiration de la carte.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FErGGS3F18uDPxlLVJw6t%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2014.40.23.png?alt=media&#x26;token=dbda8b9c-7bf6-4aaa-b8d4-de3fdbdb594f" alt="display information in the recto of the card"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Pour personnaliser les champs avant, veuillez vous référer à votre équipe technique pour savoir quelle valeur dynamique vous devez renseigner.**
{% endhint %}

#### Champs arrière <a href="#backfields" id="backfields"></a>

Cette section, située au verso de la carte de fidélité, comprend plusieurs informations utiles pour le client :

* La date d'expiration de la carte-cadeau
* Le montant
* Tickets de caisse
* Messages personnalisés
* Liens, tels que les termes et conditions, etc.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FqninhKSg9YIcXXcz8G09%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2014.44.16.png?alt=media&#x26;token=f3038875-c029-424f-ad4c-aa8e064fa9b9" alt="gift card - backfields Apple"><figcaption></figcaption></figure>

### Autres sections

Sur Apple, vous avez également trois autres sections :

* **Emplacements**  : Utilisé pour les notifications de géorepérage.
* **Balises (Beacons)**  : Également utilisé pour les notifications de géorepérage.
* **Identifiant de magasin associé**  : Vous pouvez lier votre application si elle se trouve sur l’App Store
* **NFC**  : Une fonctionnalité qui permet aux clients d’échanger du contenu numérique et de connecter des appareils électroniques par contact.

{% hint style="warning" %}
**Veuillez contacter votre représentant The Wallet Crew pour activer ces fonctionnalités**
{% endhint %}

{% hint style="danger" %}
**Une fois que vous avez effectué des modifications, n’oubliez pas de cliquer sur « enregistrer » en haut de votre écran !**
{% endhint %}

***

## Google

**Le concepteur de modèles Google est un peu différent de celui d’Apple.**

{% hint style="warning" %}
**Voici quelques éléments à connaître avant de configurer votre 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 leurs valeurs prévues, donc conservez le solde dans les champs dédiés solde/valeur
3. Les valeurs dynamiques (par ex., {{balance}}) doivent être **placées dans des champs dynamiques dédiés**. Les champs « Label » sont destinés uniquement au texte statique.

**Passons en revue les différentes sections.**

### Section générale

Dans la section générale, vous avez trois **champs obligatoires** que vous devez remplir :

* **Émetteur** : le nom de la marque ou de l'entreprise qui émet la carte
* **Nom du programme** : il apparaît sur le devant de la carte, cela peut être le nom de votre programme de fidélité par exemple
* **Numéro de carte** : le numéro de la carte-cadeau

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FxMvujpM9aqQQeyLiSuYT%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.12.56.png?alt=media&#x26;token=3230ab93-caf1-455e-96d6-455fb365fdef" alt="gift card - general section Google"><figcaption></figcaption></figure>

### Code-barres

Choisissez le **type de code-barres** qui est compatible avec votre logiciel de point de vente. La valeur du code-barres correspond au **identifiers** qui vous permettra d'identifier la carte avec votre terminal en magasin. Enfin, le texte alternatif peut être utilisé pour afficher les données du code-barres au cas où le code-barres ne pourrait pas être scanné.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FYorxr6pLtpwQ9eLEJv0W%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.15.25.png?alt=media&#x26;token=4de4664f-25ff-4400-9b6b-303540691590" alt="gift card - barcode Google"><figcaption></figcaption></figure>

### Sécurité

Lorsque vous configurez un modèle, vous devez décider **si le client peut partager son pass ou non**. Concernant Google, vous avez trois options :

* **Titulaire multiple** : cela signifie que le client peut partager son pass avec n’importe qui
* **Un utilisateur plusieurs appareils** : un client mais avec plusieurs appareils (une montre par exemple)
* **Un utilisateur un appareil**

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fy8OIU7FsjALtisTs1DRL%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.16.57.png?alt=media&#x26;token=87285872-d51c-4dfb-8f6b-8d178d70c80b" alt="gift card - security Google"><figcaption></figcaption></figure>

### Couleurs et images

Pour changer la couleur d'arrière-plan de votre carte, il suffit de **ajouter le code couleur dans les champs** prévu à cet effet. Pour ajouter une image, téléversez-la depuis votre appareil.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FU8zn8pEhdbIrVhzLji38%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.17.50.png?alt=media&#x26;token=7b82dc20-9aa8-4429-86b4-ea6182cc9244" alt="gift card - colors and images Google"><figcaption></figcaption></figure>

### Solde et code PIN

Dans cette section, vous devez saisir la valeur dynamique pour le montant de la carte-cadeau et la devise car ce sont des champs obligatoires. Vous pouvez également configurer un libellé de PIN et un PIN si nécessaire.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FdoOSDOKfbSbgvs2a8tP6%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.19.46.png?alt=media&#x26;token=7525b86b-9b85-4e2a-9343-f320fd232aaa" alt="gift card - balance and pin Google"><figcaption></figcaption></figure>

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

Vous pouvez décider d’ajouter **des liens supplémentaires** au site Web du client, par exemple votre lien vers le site !

De plus, vous pouvez également configurer la **fonction Smart tap** qui permet à votre client de simplement **valider leur carte-cadeau** en posant leur appareil sur votre terminal compatible.

Enfin, la section Intervalle de validité vous permet de **définir quand une carte-cadeau peut être utilisée !**

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FWL51J0TqaRoGxSLA2bm9%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.21.47.png?alt=media&#x26;token=a9796995-d31d-4ee3-a608-f011fa75af9e" alt="gift card - smart tap Google" width="375"><figcaption></figcaption></figure>

### Messages

Cette section, située au verso de la carte-cadeau, comprend plusieurs informations utiles pour le client :

* La date d'expiration de la carte-cadeau
* Le montant
* Tickets de caisse
* Messages personnalisés
* Liens, tels que les termes et conditions, etc.

<figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FIM2u0rKWJIzz246KsRzl%2FCapture%20d%E2%80%99e%CC%81cran%202026-02-13%20a%CC%80%2015.24.28.png?alt=media&#x26;token=b201fdf4-e594-45f3-aab0-9c2282b88982" alt="gift card - messages Google"><figcaption></figcaption></figure>

### Opportunités de valeur ajoutée

Cette section vous permet d’ajouter une **petite section en bas de la carte-cadeau** . Cela sert à afficher des offres ou des actualités.

### Autres sections

Sur Google, vous avez également quatre autres sections :

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

{% hint style="danger" %}
**Une fois que vous avez effectué des modifications, n’oubliez pas de cliquer sur « enregistrer » en haut de votre écran !**
{% endhint %}

### Prochaines étapes

* Pour les directives de conception, commencez par [Conception de carte](https://docs.thewalletcrew.io/fr/conception/broken-reference).
* Pour distribuer le pass, utilisez [Distribution (SDK)](https://docs.thewalletcrew.io/fr/conception/broken-reference).