# Exploiter les données de carte mises à jour avec l’API The Wallet Crew

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

Les Cartes sont les plus utiles lorsqu'elles restent exactes au fil du 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 en utilisant 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 `portail` et `siège` après un changement d'horaire.
* Une carte de membre affiche `statut` et `dateExpiration` après un renouvellement.

</details>

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

Dans The Wallet Crew, une Carte peut contenir plusieurs blocs de données (identifiants, métadonnées, données supplémentaires). Ces blocs sont ce que vous pouvez mettre à jour via l'API, et ce que vous pouvez ensuite afficher dans les modèles.

Si vous ne savez pas où stocker un champ, commencez par [Structure des Cartes sur The Wallet Crew](https://docs.thewalletcrew.io/fr/developper/architecture/structure).

### Étape par étape : 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 en utilisant l'API Pass. C'est la même API que vous utilisez pour les mises à jour push et le rafraîchissement des données.

Utilisez le point de terminaison décrit dans la [référence de l'API Pass](https://docs.thewalletcrew.io/fr/developper/guides/wallet/broken-reference) (cherchez **Mettre à jour une Carte**).

Si vous ne créez pas encore de Cartes, commencez par [Comment créer des passes via l'API dans The Wallet Crew](https://docs.thewalletcrew.io/fr/developper/guides/wallet/how-to-create-passes-via-api-in-the-wallet-crew).
{% endstep %}

{% step %}

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

Ouvrez une Carte et regardez la charge utile JSON. C'est votre source de vérité lorsque vous référencez ensuite des champs dans Liquid.

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

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-e2b5fc2d9233944f127265eaad1bbfab4c87e188%2Fleveraging_updated_pass_data_with_the_wallet_crew_api_1.png?alt=media" alt="Pass details screen showing the “View data” action in the pass menu."><figcaption><p>Utilisez « Voir les données » pour confirmer les clés et les valeurs qui existent 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="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-ef2ce83e685e2d34dcf1c20be4fc59848769422e%2Fleveraging_updated_pass_data_with_the_wallet_crew_api_2.png?alt=media" alt="Template list showing where to edit a pass template."><figcaption><p>Modifiez le modèle qui correspond au type de votre Carte.</p></figcaption></figure></div>

Ensuite, sélectionnez la section que vous souhaitez modifier. Les sections sont groupées afin que vous puissiez développer uniquement ce dont vous avez besoin.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-f053ab077f87e06625968203cd0a8fb887268601%2Fleveraging_updated_pass_data_with_the_wallet_crew_api_3.png?alt=media" 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, formatage ou chaînes calculées), ouvrez l'éditeur de code (`<>`) et utilisez Liquid.

<div data-with-frame="true"><figure><img src="https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-40c7dbe1883c7ccf445c46f7ac8f66d518418997%2Fleveraging_updated_pass_data_with_the_wallet_crew_api_4.png?alt=media" alt="Template editor code view where Liquid can be written."><figcaption><p>Utilisez Liquid lorsque les champs de texte simples ne suffisent pas.</p></figcaption></figure></div>

Référence de la syntaxe Liquid : [Documentation Shopify Liquid](https://shopify.github.io/liquid/).

{% hint style="info" %}
Évitez de deviner les chemins de variables. Utilisez **Voir les données** pour confirmer ce qui existe sur la Carte, puis référez-vous à ces clés exactes 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 vous distribuez des Cartes via une page web (y compris les flux avec code QR), commencez par [Sur votre site web](https://docs.thewalletcrew.io/fr/inscription/on-your-website). Si vous distribuez depuis une application native, utilisez [Sur votre application mobile](https://docs.thewalletcrew.io/fr/inscription/on-your-mobile-app).
{% 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 **Voir les données**. Si la valeur y est manquante, le problème se situe dans votre appel de mise à jour. Si elle existe dans **Voir les données** mais pas sur la Carte rendue, le problème se situe dans le mapping de votre modèle ou la logique Liquid.

### FAQ

<details>

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

Utilisez les identifiants pour lier la Carte à des systèmes externes (CRM, billetterie, e‑commerce). Utilisez les métadonnées pour segmenter les Cartes pour les opérations (ciblage, filtres). Utilisez les données supplémentaires pour des valeurs supplémentaires que vous souhaitez conserver et afficher (points, niveau, code magasin, indicateurs de campagne).

Si vous voulez un aperçu rapide, lisez [Structure des Cartes sur The Wallet Crew](https://docs.thewalletcrew.io/fr/developper/architecture/structure).

</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. Confirmez que le champ existe dans **Voir 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 changement de données ?</strong></summary>

Non. Les modèles définissent comment afficher les données. Vous ne modifiez généralement un modèle que lorsque vous changez la mise en page ou ajoutez de nouveaux champs. Les modifications quotidiennes doivent être effectuées en mettant à jour les données de la Carte via l'API.

</details>