> 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/enrolment-flows.md).
# Flux d’inscription
## flux d’inscription
Un flux d’enrôlement est le moment où une Carte est créée et liée à un véritable dossier client ou dossier entreprise. C’est là que les identifiants externes sont rattachés à la Carte pour la première fois. Cette étape est importante, car les rendus ultérieurs dépendent de ces identifiants pour récupérer des données en direct depuis les systèmes sources.
L’enrôlement n’est pas une étape de synchronisation ultérieure. La Carte est créée pendant le flux lui-même, puis l’artéfact Wallet peut être construit à partir de ce nouveau dossier Carte. Si des identifiants sont manquants ou incorrects au moment de l’enrôlement, les données pilotées par le connecteur manqueront lors des rendus ultérieurs.
Exemples concrets
* Un flux d’inscription au programme de fidélité crée une Carte après la création du compte client dans un CRM.
* Un flux d’achat de billet crée une Carte après le paiement et y associe l’ID du billet.
* Un flux de renouvellement d’adhésion crée une Carte de remplacement et la relie au dossier client existant.
### Ce qu’un flux d’enrôlement fait
Un flux d’enrôlement crée une Carte et y attache les données minimales nécessaires aux rendus futurs.
En pratique, cela signifie généralement :
1. Un système source ou un flux de frontend identifie le client ou la transaction.
2. Le flux crée une Carte ou déclenche la création de Carte.
3. Les identifiants externes sont rattachés à la Carte au moment de la création.
4. La Carte peut ensuite être rendue pour l’installation dans Wallet.
L’enregistrement Carte créé lors de l’enrôlement est volontairement léger. Il stocke les identifiants, des données supplémentaires facultatives et des champs internes de la plateforme. Les données source restent dans les systèmes en amont.
Si le modèle de données de Carte a besoin d’un rappel, commencez par [Données de Carte et synchronisation](/developers-guides/fr/pass-architecture/pass-data-and-sync.md).
### Schémas d’enrôlement courants
#### Flux du SDK Cinto
Le SDK Cinto est l’option principale lorsqu’un flux web ou d’application personnalisé doit créer des Cartes directement pendant l’enrôlement.
Ce schéma est courant lorsqu’un frontend gère déjà l’inscription, le paiement, l’enregistrement ou la complétion du profil. Le SDK crée la Carte dans le cadre de ce flux et fournit les identifiants externes dont les connecteurs auront besoin plus tard.
Utilisez le [documentation du SDK Cinto](https://docs.thewalletcrew.io/guides-enrolment/enrolment/on-your-website#npm-module) pour le flux d’implémentation.
#### Enrôlement piloté par le backend (API personnalisée)
Utilisez ce schéma lorsqu’un backend crée le client, la commande, l’adhésion ou l’enregistrement du billet. Les identifiants externes doivent exister dans ce backend avant la création de la Carte.
Appelez `POST /passes` avec ces identifiants pour créer la Carte. Voir [Cycle de vie de la Carte → Création d’une carte](/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md).
Construisez l’URL de livraison résultante avec un identifiant externe signé. Voir [URLs de livraison de Carte](https://docs.thewalletcrew.io/guides-enrolment/enrolment/download-pages).
#### Formulaire d’enrôlement intégré
La plateforme inclut également un formulaire d’enrôlement intégré avec une étape de Carte.
Ce schéma est utile lorsque le projet souhaite un flux d’enrôlement hébergé plutôt qu’une implémentation entièrement personnalisée. La même règle s’applique : la Carte est créée pendant le flux, et les identifiants doivent être disponibles à ce moment-là.
{% hint style="info" %}
Cette page se concentre sur le moment de la création et les identifiants requis. Les détails de configuration de l’interface utilisateur peuvent être documentés séparément si nécessaire.
{% endhint %}
#### Création déclenchée par la source
Certains projets créent des Cartes à partir d’un événement côté source plutôt qu’à partir d’un formulaire destiné à l’utilisateur. Dans ce modèle, un événement du système externe déclenche la création de Carte et le client installe la Carte plus tard.
Ce schéma est abordé dans [création de carte déclenchée par connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md).
### Ce qui doit exister au moment de la création
L’entrée la plus importante au moment de l’enrôlement est l’ensemble des identifiants externes.
Sans eux, les connecteurs ne peuvent pas localiser le bon client, la bonne commande, la bonne adhésion ou le bon enregistrement de billet lors des rendus ultérieurs. Une Carte peut exister sans identifiants utiles, mais elle se comportera comme un enregistrement isolé sans moyen fiable de récupérer les données source.
Des données supplémentaires peuvent également être définies au moment de la création lorsqu’une valeur doit résider sur la Carte elle-même. C’est utile pour des remplacements au niveau de la Carte ou pour des valeurs qui n’existent dans aucun système source.
Utilisez le [documentation du SDK Cinto](https://docs.thewalletcrew.io/guides-enrolment/enrolment/on-your-website#npm-module) pour les détails d’implémentation lorsque le flux crée des Cartes directement, et utilisez [Données de Carte et synchronisation](/developers-guides/fr/pass-architecture/pass-data-and-sync.md) pour savoir comment les identifiants et les données supplémentaires sont utilisés plus tard.
### Ce qui se passe après l’enrôlement
La création de la Carte ne crée pas de lien en arrière-plan qui maintient automatiquement le contenu de Wallet à jour.
Après l’enrôlement, le contenu de Wallet ne change que lorsqu’un déclencheur de rendu se produit, comme l’installation, l’aperçu ou la mise à jour push. Chaque rendu récupère à nouveau les données en direct du connecteur à l’aide des identifiants stockés pendant l’enrôlement.
Utilisez [Premiers pas avec l’API](/developers-guides/fr/integration-guides/getting-started-with-the-api.md) pour les premiers appels de mise à jour au niveau du tenant une fois qu’une Carte existe déjà.
### Liste de validation
Un flux d’enrôlement valide doit confirmer trois choses.
* La Carte est créée avec succès.
* Les identifiants externes attendus existent sur la Carte.
* Un rendu ultérieur peut récupérer les données source à l’aide de ces identifiants.
Un schéma de validation rapide consiste à créer une Carte de test, à inspecter les identifiants dans le back-office, puis à déclencher un rendu ou une mise à jour push et à confirmer que les champs alimentés par le connecteur se résolvent correctement.
### FAQ
Les identifiants externes peuvent-ils être rattachés plus tard s’ils manquaient au moment de l’enrôlement ?
Ils doivent être considérés comme des données de création. Un flux est plus fiable lorsque les identifiants sont corrects au moment où la Carte est créée.
L’enrôlement stocke-t-il les données client dans The Wallet Crew ?
Non. L’enrôlement crée l’enregistrement Carte et stocke les identifiants ainsi que toutes les valeurs au niveau de la Carte qui doivent être conservées. Les données client restent dans les systèmes source.
La création de Carte actualise-t-elle automatiquement le contenu de Wallet plus tard ?
Non. Les actualisations ultérieures dépendent toujours d’un déclencheur de rendu tel que l’installation, l’aperçu ou la mise à jour push.
---
# 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/enrolment-flows.md?ask=&goal=
```
`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.