> 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/commencer/readme/wallet-fundamentals.md).

# Découvrir les fondamentaux de 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 avec le même principe sur les deux plateformes : une Carte reste facile à enregistrer, facile à trouver et facile à présenter.</p></figcaption></figure></div>

Les portefeuilles mobiles comme Apple Wallet et Google Wallet ne sont plus seulement des 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 bien plus) à portée de main, sans avoir à fouiller dans leurs e-mails, leurs applications ou leurs cartes physiques. Avoir une Carte dans le Wallet signifie un accès instantané quand cela compte : à la 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 Cartes, les portefeuilles mobiles stockent en toute sécurité les **cartes bancaires**, ce qui permet des paiements sans contact depuis un téléphone ou une montre connectée, et fait des applications de Wallet une habitude quotidienne pour les achats, les déplacements et les accès. Ajouter des Cartes 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 Marque visible à chaque ouverture du Wallet par les clients. Les Wallets servent aussi de **hub unique, toujours disponible** pour les justificatifs personnels, où 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, en stimulant des interactions répétées et une fidélité plus profonde au fil du temps.

### Un seul endroit pour les justificatifs du quotidien

L’application Apple Wallet et l’application Google Wallet regroupent les éléments dont les clients ont besoin sur le moment. Cela inclut les coupons, cartes de fidélité, cartes d’adhésion, billets d’événement et bien plus. Les clients n’ont pas besoin de rechercher 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 portefeuilles 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 validées avec un code-barres ou un code QR. Certaines utilisent la NFC lorsque du matériel de scan 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. Cela compte lorsque les points changent, que les soldes diminuent ou que les détails du billet évoluent.

Les mises à jour font partie du cycle de vie de base. Pour les mécanismes de mise à jour et les contraintes de livraison, voir [Notifications push](/guides-animation/fr/engager-and-animer/automatisation/push-notifications.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 **types de Carte Apple Wallet** et **types de Carte Google Wallet** . Chaque type de Carte est soumis à des 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/pass-types-and-templates.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 concepteur de modèles.

{% hint style="info" %}
Les applications de Wallet peuvent stocker des cartes de paiement pour les paiements sans contact (Apple Pay / Google Pay). The Wallet Crew couvre les Cartes de 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é **types de Carte Apple Wallet** / **types de Carte Google Wallet**. Elle récompense les clients qui reviennent. Elle rend aussi le programme de fidélité plus tangible.

* **Idéale pour :** les points, les tampons, l’adhésion par paliers et l’identification du compte au point de vente.
* **Champs clés :** ID membre, code-barres/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. Les Marques peuvent offrir des points, des réductions, 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 se souvenir d’un numéro de Carte ni d’emporter de carte physique.

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 de Wallet et sélectionner la Carte en quelques secondes. Ils ne manquent pas d’occasions 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 (acheter 8, obtenir 1 gratuit) avec la progression affichée sur la Carte.
* Beauté : ID membre utilisé à la caisse, avec la 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 contrôle d’accès **types de Carte Apple Wallet** / **types de 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éale pour :** des événements avec entrée contrôlée et un flux de travail « scanner au portail ».
* **Champs clés :** nom de l’événement, date/heure, lieu, siège/section, portail, code-barres/QR.
* **Utilisation typique :** scanner à l’entrée pour valider l’accès et empêcher 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 si le siège, le portail ou l’horaire change.

Pour les participants, ajouter un billet au Wallet est simple. Ils peuvent l’ajouter depuis un lien 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 tapotements.

<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 **types de Carte Apple Wallet** / **types de Carte Google Wallet**. Elle est destinée à être utilisée au fil du temps. L’exigence clé est de maintenir le solde exact après chaque utilisation, rechargement ou remboursement.

* **Idéale pour :** valeur stockée qui diminue au fil du temps (utilisation du solde, rechargements, remboursements).
* **Champs clés :** numéro de carte, solde + devise, code-barres/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 à 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 excellent canal d’acquisition pour de nouveaux clients.

Pour les clients, une carte-cadeau dans le 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 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é en plusieurs paiements partiels sur place.
* Service client : crédit de bonne volonté 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 une Carte de type coupon **types de Carte Apple Wallet** / **types de Carte Google Wallet**. Elle est utilisée pour les remises et les incitations à durée limitée. Les offres sont souvent utilisées une seule fois, puis deviennent invalides.

* **Idéale pour :** remises, codes promotionnels 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 Marques, les offres sont un moyen pratique de générer du trafic et de la conversion. 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 du 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 point de vente.

</details>

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

### Générique

Générique est le type le plus flexible **types de Carte Apple Wallet** / **types de Carte Google Wallet** . Il convient aux cas d’usage qui ne correspondent à aucun modèle dédié. C’est un bon choix pour les justificatifs qui doivent être montrés ou scannés.

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

Pour les Marques, 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 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 à 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 récupération.

</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 un site Web de Marque ou un e-mail. Les codes QR fonctionnent aussi en magasin ou sur site. Si une application mobile existe, un flux 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 pour le moment d’utilisation. Le code-barres/QR et les champs visibles sont stockés sur le téléphone. Les mises à jour nécessitent tout de même une connectivité à 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 au fil du 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 portefeuilles mobiles. 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>Plusieurs types de Carte peuvent-ils être utilisés dans un même 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 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/docs/fr/commencer/readme/wallet-fundamentals.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.
