> 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/developers-guides/fr/pass-architecture/structure.md).

# Structure

Comprenez comment les données de carte sont organisées dans The Wallet Crew, y compris les identifiants, les métadonnées, les données supplémentaires et les données externes.

## Structure

Cette page explique comment les données de Carte sont organisées dans The Wallet Crew. Elle montre quelles valeurs sont stockées dans l'enregistrement de la Carte, quelles valeurs restent dans les systèmes connectés et quand utiliser chaque type de champ.

{% hint style="info" %}
The Wallet Crew adopte un modèle axé sur la confidentialité. Les données personnelles ne sont pas stockées par défaut. La plateforme stocke des identifiants externes et, lorsque c'est nécessaire, des valeurs limitées non sensibles telles que des métadonnées ou des données supplémentaires.
{% endhint %}

<details>

<summary>Exemples concrets</summary>

* Une Carte de fidélité peut utiliser un ID client CRM comme identifiant externe, un `storeId` comme métadonnées, et un message de campagne comme donnée supplémentaire.
* Une Carte de billetterie peut utiliser un ID de billet issu du système de billetterie, un `venue` champ de métadonnées pour la segmentation, et une note de surclassement de siège comme donnée supplémentaire.
* Une Carte d'adhésion peut combiner plusieurs identifiants lorsque les données proviennent de plusieurs systèmes, comme Shopify, Klaviyo et un CRM interne.

</details>

### Ce que contient une Carte

Une Carte est composée de plusieurs blocs de données. Chaque bloc a une fonction différente.

* **Informations générales** décrit l'enregistrement de la Carte lui-même.
* **Identifiants externes** connectent la Carte à d'autres systèmes.
* **Métadonnées** permettent la segmentation et le ciblage.
* **Données supplémentaires** enrichissent la Carte lorsqu'aucun système source ne fournit la valeur.
* **Données externes** montrent les données source utilisées pour construire la Carte.

### Informations générales

La section générale contient les détails principaux de l'enregistrement de la Carte. Elle inclut la date de création, la date de dernière mise à jour, l'état d'Apple Wallet et de Google Wallet, ainsi que le type de Carte.

Le type de Carte est la seule valeur de cette section pouvant être modifiée manuellement.

<div data-with-frame="true"><figure><img src="https://4179171865-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOnaDC4sjKAx53j0QV843%2Fuploads%2FoODmwAeJxVzUFS8q0QRJ%2Fdevelop-structure-general-information-pass.png?alt=media&#x26;token=8892e155-0dfa-4ac4-a258-a733b3684156" alt="Pass general information, including creation date, update date, wallet status, and pass type"><figcaption><p>Vérifiez les dates de création et de mise à jour, l'état d'Apple Wallet et de Google Wallet, ainsi que le type de Carte, qui est la seule valeur ici pouvant être modifiée manuellement.</p></figcaption></figure></div>

### Identifiants externes

Les identifiants externes relient une Carte à un ou plusieurs systèmes connectés. Ils permettent de récupérer les données nécessaires pour construire la Carte sans stocker ces données personnelles dans The Wallet Crew.

Une seule Carte peut contenir plusieurs identifiants. Chaque identifiant correspond à un point d'intégration spécifique, comme Shopify, Klaviyo ou Cegid Y2.

<div data-with-frame="true"><figure><img src="https://4179171865-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOnaDC4sjKAx53j0QV843%2Fuploads%2Fx2BSzwSL2J9zVdoE1FzG%2Fdevelop-structure-external-identifiers.png?alt=media&#x26;token=80c92093-e663-42af-b733-e8779eaaea62" alt="List of external identifiers attached to a pass"><figcaption><p>Vérifiez qu'un identifiant est présent pour chaque système connecté dont la Carte dépend.</p></figcaption></figure></div>

Les identifiants sont stockés sous forme de paires clé-valeur. Cela permet d'associer la bonne référence à chaque système source.

<div data-with-frame="true"><figure><img src="https://4179171865-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOnaDC4sjKAx53j0QV843%2Fuploads%2Fbg0BzE7n53bEqim3oiWq%2Fdevelop-structure-what-type-information-is-available-pass.png?alt=media&#x26;token=b536ed43-0f9d-4936-bc50-7507f2466a5f" alt="Form used to add an external identifier to a pass"><figcaption><p>Vérifiez que la clé de l'identifiant correspond à la clé attendue par le système source avant de l'enregistrer.</p></figcaption></figure></div>

### Métadonnées

Les métadonnées servent à segmenter les Cartes. Elles aident à regrouper les Cartes selon des critères opérationnels ou marketing.

Par exemple, un `storeId` champ de métadonnées peut séparer les Cartes par emplacement. Cela permet de cibler une notification push sur les Cartes liées à une seule boutique.

<div data-with-frame="true"><figure><img src="https://4179171865-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOnaDC4sjKAx53j0QV843%2Fuploads%2FYGAZBuCPxCTkp2kGcIC9%2Fdevelop-structure-segment.png?alt=media&#x26;token=ef43d1ba-1e71-4232-9215-c1ded3b1fabe" alt="Metadata fields used to segment passes"><figcaption><p>Vérifiez que les champs nécessaires au filtrage, au ciblage et au reporting sont présents dans les métadonnées.</p></figcaption></figure></div>

### Données supplémentaires

Les données supplémentaires sont des informations facultatives au niveau de la Carte. Elles ne sont pas requises pour créer la Carte et ne sont pas destinées à la segmentation.

Ces données sont utiles lorsqu'une valeur n'existe pas dans un système connecté mais améliore tout de même l'expérience Wallet. Un message de bienvenue personnalisé est un exemple courant.

<div data-with-frame="true"><figure><img src="https://4179171865-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOnaDC4sjKAx53j0QV843%2Fuploads%2FdI8fcLWJKAhr1oTgQVds%2Fdevelop-structure-additional-data-refers-optional-information-that-is.png?alt=media&#x26;token=00218999-133d-41e8-8e5c-61bab6c06831" alt="Additional data attached to a pass for wallet enrichment"><figcaption><p>Vérifiez que les valeurs conservées uniquement sur la Carte, comme un message de bienvenue, apparaissent ici plutôt que dans les métadonnées.</p></figcaption></figure></div>

### Données externes

Les données externes montrent les informations source utilisées pour construire la Carte. Elles aident à vérifier quelles valeurs ont été collectées et quel système connecté les a fournies.

Cette vue est utile pour la validation et le dépannage. Elle facilite la confirmation que la Carte reçoit les données attendues avant ou après une mise à jour.

<div data-with-frame="true"><figure><img src="https://4179171865-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOnaDC4sjKAx53j0QV843%2Fuploads%2F9mo0C7dF9vThQDe6qPQ9%2Fdevelop-structure-external-data-is-simply-all-that-were.png?alt=media&#x26;token=f0f6b011-8646-4a7f-bbcd-0b2b933c526b" alt="External data used to build a pass and its source systems"><figcaption><p>Vérifiez quel système connecté a fourni chaque valeur brute derrière la Carte.</p></figcaption></figure></div>

### Choisir le bon type de champ

Choisir le bon type de champ permet de garder un modèle de Carte propre et facile à maintenir.

* Utilisez **les identifiants externes** pour connecter la Carte à un système source.
* Utilisez **les métadonnées** pour segmenter les Cartes.
* Utilisez **les données supplémentaires** pour enrichir des Cartes sélectionnées.
* Utilisez **les données externes** pour valider la charge utile source.

### FAQ

<details>

<summary>The Wallet Crew stocke-t-il des données personnelles dans l'enregistrement de la Carte ?</summary>

Pas par défaut. The Wallet Crew stocke des identifiants externes et peut stocker des valeurs limitées non sensibles lorsque cela est nécessaire, comme des métadonnées ou des données supplémentaires.

</details>

<details>

<summary>Quelle est la différence entre les métadonnées et les données supplémentaires ?</summary>

Les métadonnées sont conçues pour la segmentation. Les données supplémentaires sont conçues pour enrichir la Carte. Si une valeur doit être utilisée pour le ciblage ou le filtrage, elle doit figurer dans les métadonnées.

</details>

<details>

<summary>Une Carte peut-elle être connectée à plusieurs systèmes ?</summary>

Oui. Une seule Carte peut contenir plusieurs identifiants externes. Chaque identifiant peut représenter un système connecté différent.

</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/developers-guides/fr/pass-architecture/structure.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.