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.

Concepts clés

Comprenez les concepts clés derrière The Wallet Crew : locataire, modèle de Carte, Carte et environnement.

The Wallet Crew repose sur un petit ensemble de concepts qui apparaissent tout au long de la plateforme. Les comprendre une fois rend la navigation sur toutes les autres pages plus rapide.

Les cartes de paiement comme Apple Pay et Google Pay ne relèvent pas du périmètre ici. The Wallet Crew gère des cartes Wallet comme les cartes de fidélité, les billets, les offres et les cartes-cadeaux — pas des instruments de paiement.

Exemples concrets
  • Une marque de distribution peut utiliser un seul tenant, un seul modèle de fidélité et des millions de cartes clients.

  • Une marque de billetterie peut utiliser un modèle de billet par famille d’événements, puis émettre une carte par participant.

  • Un groupe international peut conserver un tenant par pays lorsque les équipes, les identifiants et les données doivent rester séparés.

Tenant

Un tenant est l’espace de travail isolé pour une marque ou un programme Wallet au sein de The Wallet Crew. Tout ce qui y est configuré vit dans ce tenant : les designs Wallet, les cartes, les données et l’accès de l’équipe.

Une façon simple de l’imaginer est un bâtiment privé, et non un espace ouvert partagé. Ce qui existe dans un tenant ne se mélange pas avec un autre tenant.

La plupart des marques ont un seul tenant. Certains groupes gèrent plusieurs tenants lorsque des marques, des pays ou des programmes distincts doivent rester indépendants, avec leurs propres identifiants Apple et Google, leurs propres données et leurs propres équipes.

Un tenant n’est pas un dossier ni un sous-compte dans un espace de travail partagé. Chaque tenant est un environnement entièrement isolé. Aucun accès croisé aux données entre tenants n’existe par conception.

Modèle de Carte

Un modèle de Carte est le modèle d’une catégorie de carte Wallet. Il définit quelle plateforme Wallet est ciblée, à quoi ressemble la Carte, quels champs apparaissent, quel format de code-barres est utilisé et comment fonctionne la personnalisation.

L’analogie la plus simple est un plan. Le modèle définit les règles une fois, puis The Wallet Crew réutilise ces règles chaque fois qu’une nouvelle Carte est créée à partir de celui-ci.

Un modèle n’est pas une Carte. Il n’appartient pas à un seul client. C’est la définition réutilisable derrière de nombreuses Cartes.

Une marque peut utiliser plusieurs modèles en même temps. Une carte de fidélité, une carte-cadeau et un billet d’événement nécessitent généralement chacun leur propre modèle.

Carte

Une Carte est une carte Wallet, un billet ou un bon émis à un client. Elle est créée à partir d’un modèle et reliée aux systèmes de la marque, comme un CRM, un moteur de fidélité, un POS ou une plateforme de billetterie.

Si le modèle est le plan, la Carte est l’élément fini dans le portefeuille du client. Un seul modèle peut créer des milliers ou des millions de Cartes individuelles.

Les Cartes passent par un cycle de vie :

  • Créée — la Carte existe sur la plateforme.

  • Installée — le client l’a ajoutée à Apple Wallet ou Google Wallet.

  • Mise à jour — le contenu de la Carte a changé, comme un solde de points, un statut ou un message.

  • Désinstallée — le client l’a retirée du portefeuille.

Créée et installée sont deux moments distincts. Une Carte peut exister avant qu’un client l’enregistre dans le Wallet.

The Wallet Crew ne stocke pas les données personnelles des clients par défaut. Les Cartes sont généralement liées par des identifiants stables, comme un ID CRM ou un numéro de fidélité, tandis que les données clients essentielles restent dans les systèmes de la marque.

Environnement

Les environnements séparent les tests des opérations en direct. En pratique, The Wallet Crew fournit QA pour les tests et production pour les vrais clients.

QA est la phase de répétition. La production est la phase en direct. QA reproduit de très près la production afin que les tests reflètent les conditions réelles avant le lancement.

Ces environnements sont entièrement isolés. Une Carte créée dans QA n’apparaît jamais en production, et les identifiants de production ou les données en direct ne sont pas partagés avec QA.

La configuration peut être copiée entre les environnements si nécessaire. Un troisième environnement, dev, existe uniquement pour un usage d’ingénierie interne et n’est pas accessible aux clients.

Et ensuite

FAQ

Un seul modèle peut-il créer de nombreuses Cartes ?

Oui. C’est le modèle normal. Un modèle est réutilisé pour émettre de nombreuses Cartes individuelles qui partagent la même structure et le même design.

Un même client peut-il avoir plusieurs Cartes ?

Oui. Un client peut détenir plusieurs Cartes de la même marque, comme une carte de fidélité et plusieurs billets d’événement. Chaque Carte reste néanmoins son propre enregistrement.

Pourquoi garder QA et la production séparés ?

La séparation réduit les risques. Les équipes peuvent tester les designs, les liens et les flux de données dans QA sans affecter les clients en direct ni les identifiants en production.

Mis à jour