> 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.md).
# Cycle de vie de la Carte Wallet
Créez, mettez à jour, rendez et gérez des Cartes Apple Wallet et Google Wallet avec The Wallet Crew.
## Cycle de vie de la carte Wallet
L'équipe Wallet suit un cycle de vie simple pour les cartes. Une carte est créée via le SDK Cinto, un événement de connecteur ou `POST /passes`. Utilisez `POST /passes` pour les flux pilotés par le backend. Les templates contrôlent ensuite ce qui apparaît dans Apple Wallet et Google Wallet.
Exemples concrets
* Une carte de fidélité est créée lors de l'inscription du compte, puis actualisée après chaque achat.
* Une carte de billet est créée à partir d'un événement de commande, puis mise à jour lorsque les données de porte ou de siège changent.
* Une carte d'adhésion est créée après l'inscription, puis maintenue à jour grâce aux données du connecteur et aux remplacements au niveau de la carte.
### Choisissez le bon flux de création
### flux d'inscription
Utilisation [flux d'inscription](/developers-guides/fr/integration-guides/wallet/enrolment-flows.md) lorsque la création de la carte a lieu pendant l'inscription, le paiement, l'enregistrement ou un autre parcours utilisateur. C'est le schéma habituel lorsqu'un flux web, un flux d'application ou un formulaire hébergé contrôle l'émission.
### création de Carte déclenchée par un connecteur
Utilisation [création de Carte déclenchée par un connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md) lorsqu'un système en amont décide de l'éligibilité et crée la carte à partir d'un événement. C'est courant pour une émission pilotée par un CRM, une billetterie ou un abonnement.
{% hint style="info" %}
La création de cartes est prise en charge via le SDK Cinto, les connecteurs et `POST /passes`. Utilisez `POST /passes` pour les flux pilotés par le backend. Voir [Cycle de vie de la Carte → Création d'une Carte](/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md).
{% endhint %}
### Créer et maintenir la carte
Une fois qu'une carte existe, l'étape suivante consiste généralement à décider comment les champs du Wallet sont renseignés et actualisés. [Mettre à jour les données de la Carte dans les gabarits](/developers-guides/fr/integration-guides/wallet/update-pass-data-in-templates.md) explique comment les valeurs stockées et les données du connecteur atteignent le template. [Moteur de templates](/developers-guides/fr/integration-guides/wallet/templating-engine.md) documente le comportement Liquid pris en charge utilisé dans ces templates.
Si vous avez d'abord besoin d'un rappel sur le modèle de données de la carte, utilisez [Données et synchronisation de la Carte](/developers-guides/fr/pass-architecture/pass-data-and-sync.md).
### Gérer les cartes à grande échelle
L'exploitation quotidienne va au-delà de la création et du rendu. [Gérer le cycle de vie de la carte avec l'API](/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md) couvre l'ensemble des opérations d'API sur une carte existante, de la notification à la désactivation. [Opérateurs de filtre et de requête](/developers-guides/fr/integration-guides/wallet/filter-and-query-operators.md) explique comment sélectionner les cartes auxquelles une opération donnée doit s'appliquer. [Opérations par lots](/developers-guides/fr/integration-guides/wallet/batch-operations.md) couvre les mises à jour en masse via l'API de mise à jour push et les imports de fichiers plats SFTP, et [Mises à jour du Wallet](/developers-guides/fr/integration-guides/wallet/wallet-updates.md) explique comment suivre ou annuler l'un de ces lots depuis la console d'administration.
### Pages de cette section
* [flux d'inscription](/developers-guides/fr/integration-guides/wallet/enrolment-flows.md) explique la création de cartes côté utilisateur.
* [création de Carte déclenchée par un connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md) explique la création de cartes pilotée par la source.
* [Mettre à jour les données de la Carte dans les gabarits](/developers-guides/fr/integration-guides/wallet/update-pass-data-in-templates.md) explique comment mettre à jour les cartes existantes et afficher les bonnes valeurs.
* [Moteur de templates](/developers-guides/fr/integration-guides/wallet/templating-engine.md) explique la syntaxe Liquid prise en charge, les filtres et le comportement en cas d'erreur.
* [Gérer le cycle de vie de la carte avec l'API](/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md) explique comment créer, mettre à jour, notifier, désactiver et suivre les cartes avec l'API.
* [Opérateurs de filtre et de requête](/developers-guides/fr/integration-guides/wallet/filter-and-query-operators.md) explique comment filtrer et paginer la liste des cartes.
* [Opérations par lots](/developers-guides/fr/integration-guides/wallet/batch-operations.md) explique les mises à jour en masse via l'API de mise à jour push et les imports de fichiers plats SFTP.
* [Mises à jour du Wallet](/developers-guides/fr/integration-guides/wallet/wallet-updates.md) explique comment surveiller et annuler les opérations de mise à jour push par lot.
### FAQ
Les cartes peuvent-elles être créées directement avec l'API ?
Oui. La création de Carte est prise en charge via le SDK Cinto, les connecteurs et `POST /passes`. Utilisez `POST /passes` pour les flux pilotés par le backend. Voir [Cycle de vie de la Carte → Création d'une Carte](/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md).
Quelle page faut-il lire en premier ?
Commencez par le flux de création qui correspond au projet. Puis continuez avec le guide de mise à jour et la référence de templates.
Quand la référence de templates est-elle nécessaire ?
Utilisez-la lorsqu'un modèle doit afficher des valeurs dynamiques, des conditions ou un rendu formaté. Le guide de mise à jour est généralement un meilleur point de départ pour le travail quotidien.
Comment les cartes sont-elles mises à jour en masse plutôt qu'une par une ?
Utilisation [Opérations par lots](/developers-guides/fr/integration-guides/wallet/batch-operations.md), qui couvre à la fois l'API de mise à jour push et les imports de fichiers plats SFTP. La progression d'un lot en cours est suivie depuis la console d'administration, comme décrit dans [Mises à jour du Wallet](/developers-guides/fr/integration-guides/wallet/wallet-updates.md).
---
# 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/developers-guides/fr/integration-guides/wallet.md?ask=&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.