> 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 fondamentaux Wallet

<div data-with-frame="true"><figure><img src="/files/518f5d2f940ab995120bc9121319e882f636de74" 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 à retrouver et facile à présenter.</p></figcaption></figure></div>

Les portefeuilles mobiles comme Apple Wallet et Google Wallet ne sont plus de simples dossiers numériques pour les coupons. Ils sont devenus centraux dans la façon dont les gens organisent les essentiels de la vie quotidienne. Les clients ajoutent des Cartes à leur Wallet parce que cela garde les éléments les plus utilisés (cartes de fidélité, billets, offres, et plus encore) à portée de main sans avoir à fouiller dans leurs e-mails, applications ou cartes physiques. Avoir une Carte dans le Wallet signifie un accès instantané quand cela compte : à la caisse, à la porte d'embarquement ou à l'entrée d'un événement, rendant chaque expérience plus fluide et plus rapide pour les clients.

Au-delà des Cartes simples, les portefeuilles 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 déplacements et l'accès. Ajouter des Cartes de marque, comme une carte de récompenses, un billet de concert ou une offre de magasin, s'intègre naturellement à cette routine, en gardant la marque visible chaque fois que les clients ouvrent leur Wallet. Les Wallets jouent aussi le rôle de **point d'accès unique, toujours disponible** pour les justificatifs personnels, où les billets, cartes d'adhésion, cartes d'embarquement et autres Cartes cohabitent, et cette utilisation fréquente et pratique augmente la probabilité que les clients conservent et utilisent les Cartes fournies par une marque, favorisant des interactions répétées et une fidélité plus profonde au fil du temps.

### Un seul endroit pour les justificatifs quotidiens

L'application Apple Wallet et l'application Google Wallet regroupent les éléments dont les clients ont besoin à l'instant. Cela inclut les coupons, cartes de fidélité, cartes d'adhésion, billets d'événements, et bien 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="/files/9ce0fdc08813fc0097c2254f6175ea672cf10204" alt="Apple Wallet and Google Wallet shown as the two main mobile wallet apps used by customers on iOS and Android."><figcaption><p>Les Wallets mobiles sont l'endroit où les clients conservent leur Carte au quotidien.</p></figcaption></figure></div>

### Accès instantané à la caisse ou à l'entrée

La plupart des Cartes Apple Wallet et des Cartes Google Wallet sont utilisées avec un code-barres ou un code QR. Certaines utilisent la NFC lorsqu'un 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 se mettre à jour au fil du temps. C'est important lorsque les points changent, que les soldes diminuent ou que les détails du billet sont mis à jour.

Les mises à jour font partie du cycle de vie central. Pour les mécanismes de mise à jour et les contraintes de diffusion, voir [Notifications push](/guides-animation/fr/engagement-et-animation/push-notification.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 marques 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/types-de-carte-et-modeles.md) aide à déterminer 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 Cartes 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 à plusieurs niveaux et l'identification du compte au point de vente.
* **Champs clés :** ID membre, code-barres/code QR, solde de points, niveau/statut et liens clés.
* **Utilisation typique :** scanner à la caisse pour identifier le client, puis mettre à jour les points/le niveau.

Pour la marque, l'objectif est la fidélisation. Les marques récompensent les clients qui achètent régulièrement. Elles 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 facile à 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-en 1 gratuite) avec la progression affichée sur la Carte.
* Beauté : ID membre utilisé à la caisse, plus une 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/configuration-du-modele-de-carte-de-fidelite.md).

### Billet d'événement

Un billet d'événement est un 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 :** événements avec entrée contrôlée et un flux de travail « scan à la porte ».
* **Champs clés :** nom de l'événement, date/heure, lieu, siège/section, porte, code-barres/code 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 code 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 le siège, la porte ou l'horaire changent.

Pour les participants, ajouter un billet au Wallet est simple. Ils peuvent l'ajouter depuis un lien dans un 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 sur le siège + QR scanné à l'entrée, avec l'heure d’« ouverture des portes » sur la Carte.
* Musée : billet à entrée horodatée, où la date/heure change après un report.
* 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/billet-devenement.md).

### Carte-cadeau

Une carte-cadeau est une 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, rechargement 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/code QR (ou NFC), date d'expiration.
* **Utilisation typique :** scanner à la caisse, appliquer un montant partiel ou total, puis mettre à jour le solde.

Pour les marques, les cartes-cadeaux génèrent des revenus d'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 dans le Wallet est plus facile à conserver et à utiliser. La Carte peut afficher le solde actuel et un code-barres ou un code QR scannable. Cela réduit aussi les situations 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 : bon vendu en ligne, utilisé sur place en plusieurs paiements partiels.
* Service client : avoir de geste commercial ajouté en recharge, puis dépensé au fil du temps.

</details>

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

### Offre

Une offre est de type 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/code QR ou code promo.
* **Utilisation typique :** scanner en magasin ou saisir le code en ligne, puis marquer comme utilisée.

Pour les marques, les offres sont un moyen pratique de générer du trafic et des conversions. Elles peuvent aussi soutenir la segmentation. Différentes offres peuvent être émises pour 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 à la 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é au moment du paiement.
* CRM : offre de réactivation envoyée aux clients inactifs, puis marquée comme utilisée en caisse.

</details>

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

### Générique

Le format Générique est le plus flexible **Carte Apple Wallet** / **Carte Google Wallet** type. Il convient aux cas d'utilisation qui ne correspondent à aucun modèle dédié. Il est idéal pour les justificatifs qui doivent être présentés ou scannés.

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

Pour les marques, le format 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 d'adhésion 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 n'importe quelle autre Carte. Elle est facile à ajouter, facile à retrouver 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 la récupération.

</details>

Plus de détails : [Générique](/guides-design/fr/conception/generique.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 d'une marque ou depuis un e-mail. Les codes QR fonctionnent aussi en magasin ou sur site. Si une application mobile existe, un parcours dans l'application peut être ajouté plus tard.

</details>

<details>

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

En général oui au moment de l'utilisation. Le code-barres/code QR et les champs visibles sont stockés sur le téléphone. Les mises à jour nécessitent tout de même 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, c'est presque toujours 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 Wallets mobiles. The Wallet Crew met à jour la même Carte installée, donc les clients n'ont pas besoin de la réajouter.

</details>

<details>

<summary><strong>Plusieurs types de Carte peuvent-ils être utilisés dans un seul projet ?</strong></summary>

Oui. De nombreuses marques commencent avec un type de Carte (souvent la fidélité) et 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.
