> 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/integration-guides/wallet/update-pass-data-in-templates.md).

# Mettre à jour les données de la carte dans les modèles

Mettez à jour les données existantes de la Carte via l'API, puis rendez les dernières valeurs dans les modèles Apple Wallet et Google Wallet.

## Mettre à jour les données de carte dans les modèles

Les Cartes sont les plus précieuses lorsqu'elles restent exactes dans le temps. Le schéma habituel est simple : une Carte est mise à jour via l'API The Wallet Crew, puis les modèles de Carte affichent les dernières valeurs à l'aide de Liquid.

<details>

<summary><strong>Exemples concrets</strong></summary>

* Une Carte de fidélité affiche `points` et `niveau` et se met à jour après chaque achat.
* Un billet d'événement affiche le dernier `porte` et `place` après un changement d'horaire.
* Une carte d'adhérent affiche `statut` et `date d'expiration` après un renouvellement.

</details>

### Ce que signifie « données de Carte mises à jour »

Dans The Wallet Crew, les champs Wallet proviennent généralement de deux endroits : des données supplémentaires stockées sur la Carte et des données en direct récupérées par les connecteurs au moment du rendu. Les identifiants externes aident les connecteurs à trouver le bon enregistrement source. Les métadonnées prennent en charge la segmentation et les rapports, pas l'affichage dans Wallet.

Si l'emplacement de stockage approprié n'est pas clair, commencez par [Structure](/developers-guides/fr/pass-architecture/structure.md).

### Pas à pas : mettez à jour les données, puis affichez-les

{% stepper %}
{% step %}

#### 1) Mettez à jour les données de la Carte via l'API

Mettez à jour la Carte à l'aide de l'API Carte. C'est la même API utilisée pour les mises à jour push et l'actualisation des données.

Utilisez la [référence de l’API](https://docs.thewalletcrew.io/api-reference/) et recherchez **Mettre à jour une Carte**.

Si la création de Carte n'est pas encore configurée, commencez par [Parcours d’inscription](/developers-guides/fr/integration-guides/wallet/enrolment-flows.md) ou [Création de carte déclenchée par un connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md).
{% endstep %}

{% step %}

#### 2) Inspectez les données mises à jour sur une Carte réelle

Ouvrez une Carte et examinez la charge utile JSON. C'est la source de vérité lorsque les champs sont ensuite référencés dans Liquid.

Dans la console d'administration, accédez à `Wallet > Cartes`, choisissez une Carte, puis ouvrez le menu (`...`) et cliquez sur **Afficher les données**.

<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%2F7zYs6sPfjLfQwMQAlNzK%2Fdevelop-leveraging-updated-pass-data-pass-details-screen-showing-view-data-action.png?alt=media&#x26;token=978ee85f-f441-468f-b780-0ed742973275" alt="Pass details screen showing the “View data” action in the pass menu."><figcaption><p>Utilisez « Afficher les données » pour confirmer les clés et les valeurs présentes sur cette Carte.</p></figcaption></figure></div>
{% endstep %}

{% step %}

#### 3) Utilisez Liquid dans le modèle de Carte

Accédez à `Wallet > Modèles` et modifiez le modèle utilisé par la Carte.

<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%2FH4Q5nWjOQTeBCeudZQNy%2Fdevelop-leveraging-updated-pass-data-list-showing-where-edit-pass.png?alt=media&#x26;token=4a4617dd-5369-4df0-86e8-bf21b1184a6b" alt="Template list showing where to edit a pass template."><figcaption><p>Modifiez le modèle qui correspond au type de Carte.</p></figcaption></figure></div>

Sélectionnez ensuite la section à modifier. Les sections sont regroupées de sorte que seule la partie pertinente doive être développée.

<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%2Fp8K4rl1PTGDgQxeRAVoC%2Fdevelop-leveraging-updated-pass-data-editor-showing-expandable-sections-apple-google-fields.png?alt=media&#x26;token=6e5ba211-2be9-4a6c-ac52-ef3e06455879" alt="Template editor showing expandable sections for Apple and Google fields."><figcaption><p>Choisissez le champ dans lequel la valeur mise à jour doit apparaître.</p></figcaption></figure></div>

Lorsque du contenu dynamique est nécessaire (conditions, formatage ou chaînes calculées), ouvrez l'éditeur de code (`<>`) et utilisez Liquid.

<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%2Fqi8BOl74Pjr52cpDlSNu%2Fdevelop-leveraging-updated-pass-data-editor-code-view-where-liquid-can-be.png?alt=media&#x26;token=efc32d78-af0f-4071-ac71-e4079d0eaa17" alt="Template editor code view where Liquid can be written."><figcaption><p>Utilisez Liquid lorsque les champs de texte brut ne suffisent pas.</p></figcaption></figure></div>

Utilisation [Moteur de templates](/developers-guides/fr/integration-guides/wallet/templating-engine.md) pour la syntaxe Liquid prise en charge dans The Wallet Crew.

{% hint style="info" %}
Évitez de deviner les chemins des variables. Utilisez **Afficher les données** pour confirmer ce qui existe sur la Carte, puis faites référence à ces clés exactes dans le modèle.
{% endhint %}
{% endstep %}

{% step %}

#### 4) Enregistrez et validez sur un appareil

Enregistrez les modifications du modèle, puis validez avec une Carte qui peut être installée sur un téléphone.

Si les Cartes sont distribuées via une page web ou un flux QR, validez l'affichage hébergé sur un vrai appareil. Si la distribution se fait depuis une application native, validez la même Carte via le flux de l'application utilisé par le projet.
{% endstep %}
{% endstepper %}

### Conseils de dépannage

Si la nouvelle valeur n'apparaît pas dans Apple Wallet ou Google Wallet, commencez par vérifier la charge utile de la Carte dans **Afficher les données**. Si la valeur y est absente, le problème vient de l'appel de mise à jour ou du système source utilisé par le connecteur. Si elle y existe dans **Afficher les données** mais pas sur la Carte rendue, le problème vient du mappage du modèle ou de la logique Liquid.

Si la valeur n'existe que comme métadonnée, elle n'apparaîtra pas sur la Carte Wallet. Les métadonnées servent au ciblage et aux rapports, pas aux champs d'affichage.

### Liste de vérification de validation

Après une mise à jour, vérifiez quatre choses :

* La valeur stockée existe sur la Carte, ou l'enregistrement source du connecteur contient la nouvelle valeur.
* Le modèle fait référence à la clé exacte utilisée au moment du rendu.
* Un déclencheur de rendu s'est produit, comme un aperçu, une installation ou une mise à jour push.
* La Carte finale est validée sur un vrai appareil.

### FAQ

<details>

<summary><strong>Que dois-je utiliser : des identifiants, des métadonnées ou des données supplémentaires ?</strong></summary>

Utilisez des identifiants pour relier la Carte aux systèmes externes. Utilisez des métadonnées pour segmenter les Cartes à des fins opérationnelles. Utilisez des données supplémentaires pour les valeurs qui doivent persister sur la Carte et apparaître dans les champs Wallet.

Si un aperçu rapide est nécessaire, lisez [Structure](/developers-guides/fr/pass-architecture/structure.md).

</details>

<details>

<summary><strong>Pourquoi Liquid affiche-t-il des valeurs vides ?</strong></summary>

Dans la plupart des cas, la clé n'existe pas sur cette Carte spécifique. Vérifiez que le champ existe dans **Afficher les données**, puis assurez-vous que le modèle référence exactement le même nom de clé.

</details>

<details>

<summary><strong>Dois-je mettre à jour le modèle après chaque modification des données ?</strong></summary>

Non. Les modèles définissent la manière d'afficher les données. Un modèle ne change généralement que lorsque la mise en page change ou que de nouveaux champs sont ajoutés. Les changements quotidiens doivent être effectués en mettant à jour les données de la Carte via l'API.

</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/integration-guides/wallet/update-pass-data-in-templates.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.