> 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/docs/fr/demarrer/readme/wallet-fundamentals.md).

# Apprenez les bases du wallet

Comprenez les bases d’Apple Wallet et de Google Wallet, ainsi que les types de Carte que vous pouvez configurer dans The Wallet Crew.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FwQtX0NRpm6UFjJTFxStt%2Fimage.png?alt=media&amp;token=c23b21f0-f9de-4110-a831-6146137a7cc4" alt="Overview of wallet fundamentals across Apple Wallet and Google Wallet."><figcaption><p>Les fondamentaux de Wallet commencent par le même principe sur les deux plateformes : une Carte reste facile à enregistrer, facile à trouver et facile à présenter.</p></figcaption></figure></div>

Les Wallet mobiles comme Apple Wallet et Google Wallet ne sont plus de simples dossiers numériques pour les coupons. Ils sont devenus centraux dans la manière dont les gens organisent l’essentiel de la vie quotidienne. Les clients ajoutent des Carte à leur Wallet parce qu’il garde les éléments les plus utilisés (cartes de fidélité, billets, offres et plus encore) à portée de main sans fouiller dans les e-mails, les applications ou les cartes physiques. Avoir une Carte dans le Wallet signifie un accès instantané au moment où cela compte : en caisse, au portail ou à l’entrée d’un événement, ce qui rend chaque expérience plus fluide et plus rapide pour les clients.

Au-delà des simples Carte, les Wallet mobiles stockent en toute sécurité les **cartes bancaires**permettant des paiements sans contact depuis un téléphone ou une montre connectée, ce qui fait des applications Wallet une habitude quotidienne pour les achats, les voyages et l’accès. L’ajout de Carte de marque, comme une carte de récompenses, un billet de concert ou une offre en magasin, s’intègre naturellement à cette routine, en gardant la Brand visible chaque fois que les clients ouvrent leur Wallet. Les Wallets servent aussi de **hub unique, toujours disponible** pour les justificatifs personnels, où les billets, cartes de membre, cartes d’embarquement et autres Carte vivent côte à côte, et cette utilisation fréquente et pratique augmente la probabilité que les clients conservent et utilisent les Carte fournies par une Brand, ce qui favorise des interactions répétées et une fidélité plus profonde au fil du temps.

### Un seul endroit pour les justificatifs quotidiens

Les applications Apple Wallet et Google Wallet regroupent les éléments dont les clients ont besoin sur le moment. Cela comprend les coupons, cartes de fidélité, cartes de membre, billets d’événement et plus encore. Les clients n’ont pas besoin de chercher dans leurs e-mails ni d’installer une application.

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/WLc8AHXW4tdrAXUBfrYF/blobs/AmRbS6zlzxJf99jJjSDH/inline" alt="Apple Wallet and Google Wallet shown as the two main mobile wallet apps used by customers on iOS and Android."><figcaption><p>Les Wallet mobiles sont l’endroit où les clients conservent leur Carte au quotidien.</p></figcaption></figure></div>

### Accès instantané en caisse ou à l’entrée

La plupart des Carte Apple Wallet et des Carte Google Wallet sont utilisées avec un code-barres ou un code QR. Certaines utilisent le NFC lorsque du matériel de lecture compatible est disponible. Les clients ouvrent la Carte et la présentent en quelques secondes.

### Toujours à jour

Une Carte n’est pas un PDF statique. Une Carte Apple Wallet et une Carte Google Wallet peuvent être mises à jour au fil du temps. C’est important lorsque les points changent, que les soldes diminuent ou que les détails du billet sont actualisés.

Les mises à jour font partie du cycle de vie principal. Pour les mécanismes de mise à jour et les contraintes de livraison, voir [Notifications push](/guides-animation/fr/engager-and-animer/automatisation/notifications-push.md). Pour les identifiants et les bases du modèle de données, voir [Structure](/developers-guides/fr/pass-architecture/structure.md).

## Types de Carte que vous pouvez configurer dans The Wallet Crew

The Wallet Crew permet aux Brands de créer des modèles pour plusieurs **Carte Apple Wallet** et **Carte Google Wallet** types. Chaque type de Carte s’accompagne de contraintes Apple et Google. Le modèle définit ensuite la mise en page, les champs, les images et le code-barres.

Lorsque le choix du modèle n’est pas clair, [Types de Carte et modèles](/guides-design/fr/conception/readme-1.md) aide à préciser le bon point de départ. Lorsque le type de Carte est déjà connu, la section pertinente ci-dessous est le bon point d’entrée. La configuration se fait ensuite dans le Template Designer.

{% hint style="info" %}
Les applications Wallet peuvent stocker des cartes de paiement pour les paiements sans contact (Apple Pay / Google Pay). The Wallet Crew couvre les Carte Wallet (fidélité, billets, offres, cartes-cadeaux), pas les cartes de paiement.
{% endhint %}

### Carte de fidélité

Une carte de fidélité est un programme de fidélité **Carte Apple Wallet** / **Carte Google Wallet**. Elle récompense les clients qui reviennent. Elle rend aussi le programme de fidélité plus concret.

* **Idéal pour :** les points, les tampons, l’adhésion par niveaux et l’identification du compte en caisse.
* **Champs clés :** ID membre, code-barres/QR, solde de points, niveau/statut et liens clés.
* **Utilisation typique :** scanner en caisse pour identifier le client, puis mettre à jour les points/le niveau.

Pour la Brand, l’objectif est la fidélisation. Les Brands récompensent les clients qui achètent régulièrement. Les Brands peuvent offrir des points, des remises, des cadeaux et d’autres avantages. Une carte de fidélité peut aussi être un point d’entrée vers un compte client. Cela aide à centraliser les données et à personnaliser les expériences.

Pour les clients, la valeur est immédiate. Ils peuvent voir leur statut de fidélité et leurs récompenses. Ils n’ont pas besoin de mémoriser un numéro de carte ni d’emporter une carte plastique.

Lorsque la carte de fidélité est ajoutée à Apple Wallet ou Google Wallet, elle devient plus simple à utiliser. Les clients peuvent ouvrir l’application Wallet et sélectionner la carte en quelques secondes. Ils ne manquent aucune opportunité de récompense, car les points et avantages restent visibles sur la Carte.

<details>

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

* Commerce de détail : solde de points et niveau (Silver/Gold) mis à jour après chaque achat.
* Restauration rapide : carte à tampons (achetez 8, obtenez 1 gratuit) avec la progression affichée sur la Carte.
* Beauté : ID membre utilisé en caisse, plus récompense d’anniversaire affichée comme champ.

</details>

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

Un billet d’événement est un outil de contrôle d’accès **Carte Apple Wallet** / **Carte Google Wallet**. Il est conçu pour un scan rapide à l’entrée. Il permet aussi aux participants de trouver facilement le bon billet.

* **Idéal pour :** des événements à entrée contrôlée et un flux de travail « scan au portail ».
* **Champs clés :** nom de l’événement, date/heure, lieu, place/section, porte, code-barres/QR.
* **Utilisation typique :** scanner à l’entrée pour valider l’accès et éviter les doublons.

Pour les organisateurs, la dématérialisation des billets réduit les risques de perte et de fraude. Elle accélère l’entrée, car le personnel peut scanner un QR ou un code-barres. Elle prend aussi en charge les changements de dernière minute. Le même billet installé peut être mis à jour lorsque la place, la porte ou l’horaire changent.

Pour les participants, ajouter un billet au Wallet est simple. Ils peuvent l’ajouter depuis un lien d’e-mail, directement depuis un site de billetterie ou en scannant un code QR sur place. Sur le lieu de l’événement, le billet est prêt à être présenté en quelques touches.

<details>

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

* Concert : informations de siège + QR scanné au portail, avec l’heure « ouverture des portes » sur la Carte.
* Musée : billet à entrée horodatée, où la date/l’heure change après reprogrammation.
* Festival : Carte multi-jours, avec la même Carte mise à jour chaque jour avec de nouvelles informations.

</details>

Plus de détails : [Billet d’événement](/guides-design/fr/conception/event-ticket.md).

### Carte-cadeau

Une carte-cadeau est une carte à valeur stockée **Carte Apple Wallet** / **Carte Google Wallet**. Elle est destinée à être utilisée au fil du temps. L’exigence clé est de conserver un solde exact après chaque utilisation, recharge ou remboursement.

* **Idéal pour :** valeur stockée qui diminue au fil du temps (utilisation du solde, recharges, remboursements).
* **Champs clés :** numéro de carte, solde + devise, code-barres/QR (ou NFC), date d’expiration.
* **Utilisation typique :** scanner en caisse, appliquer un montant partiel ou total, puis mettre à jour le solde.

Pour les Brands, les cartes-cadeaux génèrent des revenus à l’avance. Les clients dépensent souvent plus que la valeur de la carte. Les cartes-cadeaux sont aussi fréquemment offertes à quelqu’un d’autre. Cela en fait un canal d’acquisition solide pour de nouveaux clients.

Pour les clients, une Carte-cadeau Wallet est plus simple à conserver et à utiliser. La Carte peut afficher le solde actuel et un code-barres ou un code QR scannable. Elle réduit aussi les cas de « carte perdue », car la carte-cadeau reste sur le téléphone.

<details>

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

* Commerce de détail : carte-cadeau émise avec 100 €, puis solde mis à jour après chaque utilisation.
* Hôtellerie-restauration : bon vendu en ligne, utilisé en plusieurs paiements partiels sur place.
* Service client : crédit de geste commercial ajouté comme recharge, puis dépensé au fil du temps.

</details>

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

### Offre

Une offre est un format de coupon **Carte Apple Wallet** / **Carte Google Wallet**. Elle sert aux remises et aux incitations limitées dans le temps. Les offres sont souvent utilisées une fois, puis deviennent invalides.

* **Idéal pour :** remises, codes promo et campagnes courtes avec des règles d’expiration claires.
* **Champs clés :** titre de l’offre, date d’expiration, conditions, code-barres/QR ou code promo.
* **Utilisation typique :** scanner en magasin ou saisir le code en ligne, puis marquer comme utilisée.

Pour les Brands, les offres sont un moyen pratique de générer du trafic et des conversions. Elles peuvent aussi prendre en charge la segmentation. Différentes offres peuvent être attribuées à différents publics. Une offre peut aussi être arrêtée ou expirée sans nécessiter de réinstallation.

Pour les clients, les offres Wallet sont faciles à retrouver en caisse. La Carte peut afficher clairement la date d’expiration et les conditions. Elle peut aussi présenter un code-barres scannable ou un code à saisir en ligne.

<details>

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

* Commerce de détail : coupon « -20 % ce week-end » avec une date d’expiration et un code-barres à usage unique.
* E-commerce : code promo affiché sur la Carte, utilisé à la caisse.
* CRM : offre de reconquête envoyée aux clients inactifs, puis marquée comme utilisée au POS.

</details>

Plus de détails : [Offre](/guides-design/fr/conception/offer.md).

### Générique

Le modèle Générique est le plus flexible **Carte Apple Wallet** / **Carte Google Wallet** type. Il convient aux cas d’usage qui ne correspondent pas à un modèle dédié. Il est bien adapté aux justificatifs qui doivent être présentés ou scannés.

* **Idéal pour :** cartes de membre, badges du personnel, cartes de garantie, justificatifs de retrait et « autre ».
* **Champs clés :** un identifiant stable, un code-barres/QR, un statut, des informations clés et des liens d’assistance.
* **Utilisation typique :** vérification visuelle ou scan, selon le flux opérationnel.

Pour les Brands, le modèle Générique est utile lorsqu’une mise en page personnalisée est nécessaire. Les champs et l’ordre d’affichage sont entièrement configurables. C’est utile pour les cartes de membre qui ne sont pas des programmes de fidélité, les Cartes du personnel, les badges partenaires, les cartes de garantie ou les justificatifs de retrait.

Pour les clients, une Carte Générique fonctionne comme toute autre Carte. Elle est facile à ajouter, facile à trouver et facile à présenter. Elle peut aussi être mise à jour lorsque les détails changent.

<details>

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

* Badge du personnel : nom de l’employé + rôle + QR pour l’accès aux portes.
* Carte de garantie : numéro de série du produit + date d’achat + lien d’assistance.
* Click & collect : justificatif de retrait avec ID de commande + code-barres pour le retrait.

</details>

Plus de détails : [Générique](/guides-design/fr/conception/generic.md).

## FAQ

<details>

<summary><strong>Les clients ont-ils besoin d’une application mobile pour ajouter une Carte ?</strong></summary>

Non. Les clients peuvent ajouter une Carte depuis le site Web ou l’e-mail d’une Brand. Les codes QR fonctionnent aussi en magasin ou sur site. Si une application mobile existe, un parcours in-app pourra être ajouté plus tard.

</details>

<details>

<summary><strong>Les Carte fonctionnent-elles hors ligne ?</strong></summary>

En général oui au moment de l’utilisation. Le code-barres/QR et les champs visibles sont stockés sur le téléphone. Les mises à jour nécessitent toutefois une connexion à un moment donné pour se synchroniser.

</details>

<details>

<summary><strong>Quelle est la différence entre une Offre et une Carte-cadeau ?</strong></summary>

Les Offres servent aux remises et aux coupons. Les cartes-cadeaux servent à la valeur stockée et aux mises à jour de solde. Si la valeur peut diminuer avec le temps, il s’agit presque toujours d’une carte-cadeau.

</details>

<details>

<summary><strong>Une Carte peut-elle être mise à jour après son installation ?</strong></summary>

Oui. C’est l’un des principaux avantages des Wallet mobiles. The Wallet Crew met à jour la même Carte installée, donc les clients n’ont pas besoin de l’ajouter de nouveau.

</details>

<details>

<summary><strong>Peut-on utiliser plusieurs types de Carte dans un même projet ?</strong></summary>

Oui. De nombreuses Brands commencent avec un type de Carte (souvent la fidélité) puis en ajoutent d’autres plus tard. Les types de Carte peuvent partager les mêmes canaux de distribution et la même configuration opérationnelle.

</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/docs/fr/demarrer/readme/wallet-fundamentals.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.
