> 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/guides-monitoring/fr/monitor/pass-details.md).

# Détails de la Carte

Examinez et gérez une Carte dans la console d'administration : aperçu, données, avantages, tampons, notifications, historique et actions.

La page de la Carte donne une vue complète d’une Carte : quel modèle et quel thème elle utilise, si elle se trouve dans un Wallet, les données avec lesquelles elle est rendue, ses avantages, les notifications qu’elle a reçues et chaque événement enregistré pour elle. Elle regroupe aussi sur une seule Carte les actions dont les équipes support et opérations ont besoin, comme pousser une mise à jour, envoyer une notification ou accorder un avantage.

La page s’ouvre depuis [Liste des Cartes](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/pass-list.md), avec l’ **Détails** action d’une ligne. Son titre est l’identifiant de la Carte.

<figure><img src="https://1809963934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsokFUBfsbM9mlwavmMB%2Fuploads%2FWqM52IQR8G8idmBNd3Ic%2Fpass-details-overview.png?alt=media&amp;token=b197bc48-3ad1-48cd-abff-e2aa7620df8e" alt="Overview tab of a stamp card pass with the General, Added to Wallet and Identifiers cards next to the live preview"><figcaption><p>La page de la Carte : onglet Vue d’ensemble à gauche et aperçu en direct à droite.</p></figcaption></figure>

## Onglets

La page est organisée en onglets, chacun répondant à une question différente. L’ **Tampons** onglet n’existe que pour les cartes de tampons.

| Onglet                          | Question à laquelle il répond                                                                  |
| ------------------------------- | ---------------------------------------------------------------------------------------------- |
| [Vue d’ensemble](#overview)     | Quelle est cette Carte, quel modèle et quel thème utilise-t-elle, et est-elle dans un Wallet ? |
| [Données](#data)                | Avec quelles données la Carte est-elle rendue, et d’où viennent-elles ?                        |
| [Avantages](#benefits)          | Quels avantages la Carte contient-elle, et dans quel état ?                                    |
| [Tampons](#stamps)              | Combien de tampons la carte a-t-elle, et comment le nombre a-t-il évolué ?                     |
| [Notifications](#notifications) | Quelles notifications ont été envoyées à la Carte ?                                            |
| [Historique](#history)          | Qu’est-il arrivé à la Carte, et dans quel ordre ?                                              |

### Vue d’ensemble

L’onglet Vue d’ensemble affiche l’identité de la Carte et permet de modifier son modèle et son thème. Un aperçu en direct de la Carte se trouve à côté, avec un sélecteur Apple / Google, un sélecteur de langue et les mêmes vues et paramètres que dans l’éditeur de modèle (voir [Aperçu et données d’aperçu](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/preview-and-preview-data.md)).

Le **Général** la carte affiche :

* le **type** de la Carte, et pour une carte de tampons, son nombre de tampons ;
* un **Carte liée** badge lorsque la Carte a été émise par un avantage d’une autre Carte. Le **Carte parente** bloc renvoie alors vers cette Carte ("Ouvrir la Carte parente") et vers l’avantage qui l’a émise ("Ouvrir l’avantage"), ou indique quand la parente n’est plus disponible ;
* le **Date de création** et **Dernière mise à jour** date ;
* le **Modèle**. Sélectionner un autre modèle et enregistrer déplace la Carte vers ce modèle. Vérifiez le résultat dans l’aperçu, puis utilisez **Pousser la mise à jour** si la modification doit apparaître immédiatement sur le téléphone ;
* le **Thème**, facultatif, un par Carte. « Aucun » utilise le modèle tel qu’il est configuré ;
* pour un billet d’événement, le **Titre** et **Sous-titre** qui nomment la Carte dans la console d’administration, telle qu’elle est rendue par le modèle (lecture seule) ;
* le **Données scannables** valeurs (code-barres et code QR), lorsque le modèle les stocke (voir [Données scannables](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/general-tab.md#scannable-data)).

Le **Ajoutée au Wallet** la carte affiche, pour Apple Wallet et Google Wallet, la date à laquelle la Carte a été ajoutée ou « Non ajoutée », ainsi que le nombre de **Copies actives**. Son infobulle indique le nombre total de copies, y compris celles supprimées.

{% hint style="info" %}
Un nombre de copies actives de `0` signifie que la Carte a été supprimée de tous les Wallets. La Carte existe toujours sur The Wallet Crew et peut être ajoutée à nouveau ; elle n’est pas supprimée.
{% endhint %}

Le **Identifiants** la carte liste les clés qui lient la Carte à un enregistrement dans un autre système, comme l’identifiant client du CRM ou l’identifiant de carte de fidélité. Les fournisseurs de données les utilisent pour retrouver les données du titulaire, et les modèles les lisent comme `id.<key>`. Les identifiants sont ajoutés avec **Ajouter un identifiant**.

Les modifications du modèle, du thème ou des identifiants sont enregistrées avec **Enregistrer**.

### Données

L’onglet Données affiche les données stockées sur la Carte et les données chargées pour la rendre. Il aide à comprendre pourquoi un champ affiche une valeur, ou aucune. Son en-tête rappelle le modèle, l’heure du rendu et le nombre de fournisseurs de données.

**Stockées sur la Carte**, toujours chargées même lorsqu’un fournisseur échoue :

* **Identifiants**, en lecture seule ici ;
* **Données supplémentaires**: valeurs stockées sur la Carte elle-même, écrites par l’inscription, les imports ou l’API, et modifiées ici avec **Ajouter des données supplémentaires** et le **Enregistrer**. Les modèles les lisent comme `additionalData.<key>`; elles ne servent jamais à rechercher des données ;
* **Métadonnées**: valeurs que le modèle calcule pour la liste des Cartes et pour les automatisations (voir [onglet Général](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/general-tab.md#metadata)). Elles ne servent pas à rendre la Carte.

**Chargées au rendu, par fournisseur**: les données renvoyées par chaque fournisseur de données, avec une recherche sur les variables et les valeurs (« Rechercher une variable ou une valeur… »), une **JSON brut** vue et **Actualiser les données** pour les recharger. Lorsqu’un fournisseur échoue, sa carte indique pourquoi : le script du tenant a échoué, le fournisseur n’a pas répondu à temps, n’a pas pu être joint ou a échoué.

<figure><img src="https://1809963934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsokFUBfsbM9mlwavmMB%2Fuploads%2Fgit-blob-78fa84cab4b3693a321fe225802206b2d574a09a%2Fpass-details-data-single-frame.png?alt=media" alt="Data tab with the identifiers and additional data stored on the pass, and the data loaded at render by provider"><figcaption><p>L’onglet Données : d’abord les données stockées sur la Carte, puis les données chargées depuis chaque fournisseur.</p></figcaption></figure>

### Avantages

L’onglet Avantages liste les avantages de la Carte, avec leur **Statut**, **Comportement**, **Validité**, **Code**, **Utilisations restantes** et **Origine**.

Les nouveaux avantages sont accordés avec **Accorder un avantage**. L’utilisation, l’ajustement, l’extension et la suppression d’un avantage sont décrits dans [Accorder et utiliser des avantages](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/benefit-templates/grant-and-use-benefits.md#manage-a-benefit-on-a-pass).

### Tampons

L’onglet Tampons d’une carte de tampons affiche le tableau des tampons, la liste des mouvements et l’ **Appliquer des tampons** action. Elle est décrite dans [Carte de tampons](https://docs.thewalletcrew.io/guides-design/fr/conception/stamp-card.md#from-the-admin-console).

### Notifications

L’onglet Notifications liste les notifications envoyées à la Carte, sous forme de chronologie. Chacune affiche l’appareil, le pays, l’identifiant client et le contenu, avec ses traductions. Une Carte qui n’a jamais reçu de notification affiche « Aucune notification envoyée n’a été trouvée pour cette Carte. »

{% hint style="info" %}
La synchronisation peut prendre jusqu’à 5 minutes après l’envoi d’une notification avant qu’elle n’apparaisse dans cet onglet. Apple et Google ne confirment pas si une notification a été reçue par l’appareil.
{% endhint %}

### Historique

L’onglet Historique est le journal complet des événements de la Carte. Les puces au-dessus de la chronologie filtrent par type d’événement et indiquent combien d’événements de chaque type existent ; chaque événement se déplie pour afficher les données enregistrées avec lui. La synchronisation peut prendre jusqu’à 5 minutes après qu’un événement se produit. Une nouvelle Carte affiche « Aucun événement enregistré pour cette Carte pour le moment. »

Les événements incluent la création, les mises à jour, l’installation et la suppression, la livraison des mises à jour et des notifications, les scans, les clics sur les liens, les changements d’identifiants, de métadonnées, de modèle ou de thème, les mouvements de carte de tampons et les événements d’avantage. Pour le nom et la signification de chaque événement, voir le [référence des événements](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/what-the-wallet-crew-tracks.md#event-reference).

Pour les événements concernant de nombreuses Cartes, utilisez l’ [API Insights](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/insights-api.md) ou [webhooks](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/send-wallet-events-to-your-tools.md). Pour exporter une liste de Cartes, voir [Exporter les données](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/report.md).

<figure><img src="https://1809963934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsokFUBfsbM9mlwavmMB%2Fuploads%2FRswSaecyjkZGblRJ10e5%2Fpass-details-history.png?alt=media&amp;token=b2710d87-68a5-4bec-8129-417fcd9bd537" alt="History tab with event type filters and an expanded Pass:StampApplied event"><figcaption><p>L’onglet Historique, filtré par type d’événement, avec un événement déplié.</p></figcaption></figure>

## Actions

Le **Actions** menu en haut de la page regroupe les actions sur cette Carte. Chaque action sauf **Voir le code QR** modifie la Carte, donc un utilisateur sans accès en modification ne voit que celle-là. **Ajouter des tampons** n’apparaît que pour les cartes de tampons.

<figure><img src="https://1809963934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsokFUBfsbM9mlwavmMB%2Fuploads%2F9Hk76P6vaFkUfnnpBkeO%2Fpass-details-actions.png?alt=media&amp;token=ca08b4f9-33fb-4e00-b5e7-85dd880146cb" alt="Actions menu of a stamp card pass: Push update, Notify, View QR code, Grant a benefit, Apply a theme and Add stamps"><figcaption><p>Le menu Actions d’une Carte de tampons.</p></figcaption></figure>

| Action                     | Objectif                                                                                                                                                                |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pousser la mise à jour** | Rend la Carte à nouveau avec les données les plus récentes, recalcule ses métadonnées et l’envoie immédiatement, sans attendre dans la file d’attente des mises à jour. |
| **Notifier**               | Ouvre « Notifier la Carte » pour rédiger un message, par langue, et **Envoyer la notification** vers les appareils sur lesquels la Carte est installée.                 |
| **Voir le code QR**        | Affiche le lien et le code QR pour consulter ou ajouter la Carte, par exemple pour l’envoyer de nouveau à un utilisateur final.                                         |
| **Accorder un avantage**   | Ajoute un avantage à la Carte à partir d’un modèle d’avantage.                                                                                                          |
| **Appliquer un thème**     | Modifie le thème de la Carte.                                                                                                                                           |
| **Ajouter des tampons**    | Ajoute ou corrige des tampons sur une carte de tampons.                                                                                                                 |

Une Carte ne peut pas être supprimée ni annulée depuis cette page.

### Ce qu’une mise à jour poussée fait

The Wallet Crew rend et stocke toujours la nouvelle version de la Carte. Un appareil ne la reçoit que lorsque la Carte est dans Apple Wallet ou Google Wallet ; une Carte ajoutée de nouveau plus tard reçoit la dernière version. Voir [Cycle de vie de la Carte](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md#push-notification-behavior).

## FAQ

<details>

<summary><strong>Comment renvoyer une Carte à un utilisateur final qui a changé de téléphone ?</strong></summary>

Ouvrir **Actions → Voir le code QR** et partagez le lien ou le code QR. L’utilisateur final ajoute de nouveau la même Carte ; aucune nouvelle Carte n’est créée.

</details>

<details>

<summary><strong>Pourquoi un champ n’affiche-t-il aucune valeur sur la Carte ?</strong></summary>

Ouvrez l’onglet Données. La variable peut être absente des données, ou un fournisseur de données peut avoir échoué : sa carte affiche alors l’erreur. Utilisez **Actualiser les données** une fois la cause résolue, puis **Pousser la mise à jour**.

</details>

<details>

<summary><strong>Les mises à jour échouées peuvent-elles servir à détecter les Cartes supprimées ?</strong></summary>

Non. Une mise à jour n’échoue pas parce qu’une Carte a été supprimée d’un Wallet. Utilisez les événements Carte:Installed et Carte:Uninstalled, ou la **Ajoutée au Wallet** carte.

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/pass-details.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
