> 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 carte dans les modèles

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

Les Cartes sont les plus utiles lorsqu’elles restent exactes dans le temps. Le schéma habituel est simple : vous mettez à jour une Carte via l’API The Wallet Crew, puis vos 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 `les points` et `le niveau` et se met à jour après chaque achat.
* Un billet d’événement affiche le dernier `portail` et `siège` après un changement de programme.
* Une carte d’adhésion affiche `le 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 du Wallet proviennent généralement de deux endroits : les données supplémentaires stockées sur la Carte et les 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 le Wallet.

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

### Étape par étape : mettre à jour les données, puis les afficher

{% stepper %}
{% step %}

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

Mettez à jour la Carte en utilisant l’API Carte. C’est la même API que vous utilisez 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 connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md).
{% endstep %}

{% step %}

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

Ouvrez une Carte et examinez la charge JSON. C’est votre source de vérité lorsque vous référez ensuite des champs dans Liquid.

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

<div data-with-frame="true"><figure><img src="/files/6441e20c1fe8a1ac692ba85812a5ab34ec836b8e" 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 votre modèle de Carte

Allez à `Wallet > Modèles` et modifiez le modèle utilisé par votre Carte.

<div data-with-frame="true"><figure><img src="/files/3db23542986fe73c218c2207264be1963e388160" alt="Template list showing where to edit a pass template."><figcaption><p>Modifiez le modèle qui correspond à votre type de Carte.</p></figcaption></figure></div>

Sélectionnez ensuite la section que vous souhaitez modifier. Les sections sont regroupées afin que vous puissiez développer uniquement ce dont vous avez besoin.

<div data-with-frame="true"><figure><img src="/files/5251340da5a28ca8534b582f7f1cec3ab7615d5e" alt="Template editor showing expandable sections for Apple and Google fields."><figcaption><p>Choisissez le champ où la valeur mise à jour doit apparaître.</p></figcaption></figure></div>

Lorsque vous avez besoin de contenu dynamique (conditions, mise en forme ou chaînes calculées), ouvrez l’éditeur de code (`<>`) et utilisez Liquid.

<div data-with-frame="true"><figure><img src="/files/e887c9af48a7fa3e723fc82f25f11ce88ae17407" 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/liquid-templating.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 référencez exactement ces clés dans votre modèle.
{% endhint %}
{% endstep %}

{% step %}

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

Enregistrez vos modifications de modèle, puis validez avec une Carte que vous pouvez installer sur un téléphone.

Si les Cartes sont distribuées via une page Web ou un flux QR, validez la vue hébergée sur un véritable 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 vous ne voyez pas la nouvelle valeur 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 se situe dans l’appel de mise à jour ou dans le système source utilisé par le connecteur. Si elle existe dans **Afficher les données** mais pas sur la Carte rendue, le problème se situe dans le mappage du modèle ou dans la logique Liquid.

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

### Liste de contrôle de validation

Après une mise à jour, confirmez 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 a eu lieu, comme un aperçu, une installation ou une mise à jour push.
* La Carte finale est validée sur un véritable 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 à des systèmes externes. Utilisez les métadonnées pour segmenter les Cartes à des fins opérationnelles. Utilisez les données supplémentaires pour les valeurs qui doivent persister sur la Carte et apparaître dans les champs du 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 précise. Vérifiez que le champ existe dans **Afficher les données**, puis assurez-vous que votre 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 façon d’afficher les données. En général, vous ne mettez à jour un modèle que lorsque vous modifiez la mise en page ou ajoutez de nouveaux champs. 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.