This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Types de Carte et modèles

Comprenez les modèles de Carte et choisissez le bon type de Carte Apple Wallet et Google Wallet pour chaque cas d’usage.

Un modèle définit la structure et la conception d'une carte Wallet. Il contrôle la mise en page, les libellés, les images et les points de données qui apparaissent sur la carte.

Dans The Wallet Crew, chaque modèle part d'un type de carte. Le type de carte définit la forme de base et les contraintes requises par Apple Wallet et Google Wallet. Le modèle applique ensuite la personnalisation de marque et les règles de mappage par-dessus.

Exemples concrets
  • Fidélité en magasin : une carte de fidélité affiche l'ID membre, le niveau, les points et un code-barres.

  • Cartes cadeaux : une carte à valeur stockée affiche le solde actuel et se met à jour après chaque utilisation.

  • Coupons : une carte d'offre affiche une date d'expiration et un code scannable, puis est utilisée.

  • Événements et visites : une carte d'événement affiche le lieu et l'heure, et prend en charge un scan rapide à l'entrée.

  • Adhésion et services : une carte générique prend en charge les badges du personnel, les cartes de garantie ou les justificatifs de retrait.

Modèle

Un modèle est la couche de configuration appliquée par-dessus un type de carte Apple Wallet / Google Wallet. C'est là que la personnalisation de marque et le mappage des champs sont définis une fois, puis réutilisés pour toutes les cartes émises.

Ce qu'un modèle contrôle

Un modèle contrôle l'apparence de la carte et la façon dont les données sont présentées :

  • Conception visuelle (couleurs, logos, images).

  • Disposition des champs (champs recto, champs verso, messages).

  • Libellés, ordre et mise en forme (y compris les traductions).

  • Configuration du code-barres/QR et sa valeur affichée.

  • Contraintes propres au fournisseur (Apple vs Google).

Ce qu'un modèle ne contrôle pas

Un modèle n'est pas la source de vérité pour l'état métier. La validité, les soldes, les droits et les règles d'utilisation restent dans les systèmes amont (CRM, moteur de fidélité, POS, billetterie, e-commerce ou backend).

The Wallet Crew génère et met à jour la carte Wallet à partir de ces données source de vérité. Cela permet à la carte de rester cohérente avec les opérations, tout en bénéficiant de l'expérience Wallet (accès hors ligne, présentation native à l'appareil et mises à jour).

Pourquoi un modèle est nécessaire

Apple Wallet et Google Wallet n'affichent pas des données arbitraires. Ils affichent une carte qui suit un modèle prédéfini. Un modèle est la manière pratique de garder ce modèle stable dans le temps.

Les modèles permettent de :

  • Définir un schéma stable (quels champs existent et ce qu'ils signifient).

  • Décider ce qui apparaît au recto et au verso.

  • Conserver une cohérence de marque sur les cartes émises.

  • Valider tôt les contraintes (champs obligatoires, formats pris en charge, tailles d'image).

Choisir le bon type de carte

The Wallet Crew prend en charge plusieurs types de cartes. Le bon choix dépend du flux de travail opérationnel et des données qui doivent rester à jour.

Carte de fidélité

Utilisez une carte de fidélité lorsque la carte représente une relation client continue et doit être mise à jour au fil du temps.

Le contenu typique comprend un identifiant membre, le niveau/statut, les points ou tampons, et des liens d'assistance. L'échange se fait généralement via un code-barres/QR scanné au point de vente, suivi d'une mise à jour des points ou du niveau.

Plus de détails : Configuration du modèle de carte de fidélité.

Billet d'événement

Utilisez un billet d'événement lorsque le flux principal est un contrôle d'accès avec un scan rapide à l'entrée.

Le contenu typique comprend le nom de l'événement, le lieu, la date/l'heure, le siège/la section, la porte d'entrée et un code-barres/QR. Les mises à jour sont utiles pour les changements d'horaire, les changements de siège ou les messages opérationnels.

Plus de détails : Billet d'événement.

Carte cadeau

Utilisez une carte cadeau lorsque la carte représente une valeur stockée qui doit diminuer ou augmenter au fil du temps.

Le contenu typique comprend un identifiant de carte, le solde et la devise, la date d'expiration le cas échéant, et un code-barres/QR pour utilisation (ou NFC lorsque pris en charge). Les mises à jour du solde après utilisation constituent l'exigence principale.

Plus de détails : Carte cadeau.

Offre

Utilisez une offre pour des coupons ou promotions limités dans le temps, généralement utilisés une seule fois.

Le contenu typique comprend un titre d'offre, une date d'expiration, des conditions et un code d'échange (code-barres/QR ou code promo). L'offre peut être mise à jour pour refléter l'état d'utilisation.

Plus de détails : Offre.

Générique

Utilisez une carte générique lorsqu'aucun type de carte dédié ne correspond au cas d'usage, mais qu'un justificatif scannable ou présentable reste nécessaire.

Les cas courants incluent les cartes d'adhésion qui ne sont pas des programmes de fidélité, les badges du personnel, les cartes de garantie, les réservations de service ou les justificatifs de retrait.

Plus de détails : Générique.

Quand plusieurs modèles ont du sens

La plupart des projets commencent avec un modèle par type de carte. Plusieurs modèles sont utiles lorsque les cartes nécessitent des mises en page différentes, des contraintes différentes ou des règles de contenu différentes.

Les raisons courantes incluent :

  • Plusieurs marques, programmes ou unités commerciales sous un même tenant.

  • Différents produits avec une densité d'information différente (standard vs VIP, basique vs premium).

  • Différents textes juridiques ou contacts de support client selon le programme.

  • Différentes langues nécessitant des libellés et une structure de contenu différentes.

  • Différentes stratégies de code-barres ou contextes de scan (POS vs contrôle d'accès).

Étapes suivantes

La création et la conception d'un modèle sont généralement réalisées une seule fois, puis affinées grâce aux retours opérationnels réels.

FAQ

Quelle est la différence entre un type de carte, un modèle et une carte ?

Le type de carte est le modèle de base requis par Apple Wallet et Google Wallet (fidélité, offre, carte cadeau, billet d'événement, générique).

Un modèle est une instance configurée de ce type de carte dans The Wallet Crew. Il définit la personnalisation de marque, les champs et les règles de mappage.

Une carte est l'objet individuel installé par un client. Elle utilise un seul modèle à la fois et peut être mise à jour tout au long de son cycle de vie.

Une carte peut-elle être mise à jour après l'installation ?

Oui. Les mises à jour sont une fonctionnalité essentielle du portefeuille. The Wallet Crew met à jour la même carte installée, donc les clients n'ont pas besoin de la rajouter.

Un seul modèle suffit-il pour tout un programme ?

Souvent oui. Un modèle par type de carte est une base courante. Plusieurs modèles sont utiles lorsque différentes mises en page ou règles de contenu sont nécessaires.

Un modèle décide-t-il si une carte est valide ?

Non. La validité et l'état métier restent dans les systèmes source. Le modèle contrôle la façon dont cet état est affiché dans Apple Wallet et Google Wallet.