> 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/readme.md).

# Guide du développeur de l’API The Wallet Crew

Créez des intégrations de Cartes Apple Wallet et Google Wallet avec l’API The Wallet Crew, notamment l’authentification, les mises à jour de Cartes, les webhooks, les scans et les rapports.

## Guide du développeur de l'API Wallet Crew

Créez des intégrations de cartes Apple Wallet et Google Wallet avec The Wallet Crew. Ce guide couvre l'authentification de l'API, les mises à jour de cartes, les webhooks, les scans, les rapports et les chemins qui prennent en charge chaque flux de travail.

<a href="https://docs.thewalletcrew.io/api-reference/" class="button primary" data-icon="terminal">Ouvrir la référence de l'API</a>

<details>

<summary><strong>Exemples concrets</strong></summary>

* Créez une carte de fidélité après l'inscription ou le paiement.
* Mettez à jour les champs de la carte après un événement CRM, de billetterie ou de POS.
* Transférez les événements du cycle de vie du Wallet vers un backend, un CRM ou une pile analytique.

</details>

### Commencez ici

La plupart des projets de développement suivent le même parcours.

{% stepper %}
{% step %}

#### Obtenir les identifiants

Générez une clé API depuis la console d’administration, dans **Paramètres → Sécurité → Clés API**. Envoyez-la dans le `X-API-KEY` en-tête de chaque requête.
{% endstep %}

{% step %}

#### Ouvrir la référence de l'API

Utilisez la référence de l'API pour examiner les points de terminaison, les corps de requête, les schémas de réponse, les autorisations et les exemples en direct.

[Ouvrir la référence de l'API](https://docs.thewalletcrew.io/api-reference/)
{% endstep %}

{% step %}

#### Faites une première requête

Commencez avec une carte qui existe déjà plutôt qu’avec un flux de création. C’est le moyen le plus rapide de valider l’accès au tenant, l’authentification et le comportement de mise à jour sans mêler la logique de création au premier test.

L’appel initial le plus courant est une mise à jour forcée de la carte. Il indique à la plateforme de récupérer à nouveau les données auprès des fournisseurs configurés, de reconstruire la carte et d’envoyer la version mise à jour à l’appareil :

```http
PATCH /api/{tenantId}/passes?id={passId}
X-API-KEY: {api_key}
Content-Type: application/json

{
  "additionalData": { "loyaltyTier": "gold" },
  "options": { "updateMetadata": true }
}
```

Une carte peut également être ciblée par un identifiant externe au lieu de `passId`, par exemple `id.shopify.customerId={customerId}`. Consultez Concepts clés pour connaître la différence entre les deux. Une `200` réponse signifie que la mise à jour s’est exécutée de manière synchrone ; `202` cela signifie qu’elle a été mise en file d’attente.

Si aucune carte n’existe encore, commencez plutôt par des flux d’inscription ou par la création de carte déclenchée par le connecteur, puis revenez à cet appel une fois qu’une carte a été émise.

Poursuivez avec [Premiers pas avec l'API](/developers-guides/fr/integration-guides/getting-started-with-the-api.md) pour le guide complet.
{% endstep %}

{% step %}

#### Développez l'intégration

Une fois que le premier appel de gestion fonctionne, passez aux flux de création, aux mises à jour, aux webhooks, aux scans et aux rapports.
{% endstep %}
{% endstepper %}

### Authentification

Certaines API à portée de tenant prennent en charge d'autres modèles d'authentification ou des scopes supplémentaires, par exemple le flux OAuth2 utilisé par certaines opérations administratives. Lorsque c'est le cas, le guide du point de terminaison ou la référence de l'API fait foi.

{% hint style="info" %}
Pour une première intégration, commencez par les API documentées autour de `X-API-KEY`. C'est le parcours habituel pour la gestion des cartes, les webhooks, les scans et la référence API interactive.
{% endhint %}

### Référence de l'API

Utilisez la référence de l'API lorsque la forme exacte de la charge utile, le schéma de réponse ou le comportement du point de terminaison est important.

[Ouvrir la référence de l'API](https://docs.thewalletcrew.io/api-reference/)

### Guides pour développeurs

Ces guides couvrent les principaux modèles d'intégration.

* [Concepts clés](/developers-guides/fr/readme/key-concepts.md) couvre les tenants, les identifiants, les modèles et les bases du cycle de vie de la carte.
* [Premiers pas avec l'API](/developers-guides/fr/integration-guides/getting-started-with-the-api.md) décrit pas à pas la première requête à portée de tenant.
* [flux d'inscription](/developers-guides/fr/integration-guides/wallet/enrolment-flows.md) et [création de Carte déclenchée par un connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md) couvrent l'émission de nouvelles cartes.
* [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 afficher les données actuelles de la carte.
* [Webhooks](/developers-guides/fr/integration-guides/webhooks.md), [API de scan](/developers-guides/fr/integration-guides/scan-api.md), et [API Insights](/developers-guides/fr/integration-guides/insights-api.md) couvrent les événements, les scans et les rapports.

### Étapes suivantes courantes

Après la réussite de la première requête, l'étape suivante dépend généralement de l'objectif d'intégration.

* Si des cartes existent déjà, commencez par [Premiers pas avec l'API](/developers-guides/fr/integration-guides/getting-started-with-the-api.md).
* Si l'émission commence lors d'une inscription, d'un paiement ou d'un formulaire hébergé, utilisez [flux d'inscription](/developers-guides/fr/integration-guides/wallet/enrolment-flows.md).
* Si l'émission commence à partir d'un événement du système source, utilisez [création de Carte déclenchée par un connecteur](/developers-guides/fr/integration-guides/wallet/connector-triggered-pass-creation.md).
* Pour maintenir le contenu du Wallet à jour, utilisez [Mettre à jour les données de la Carte dans les gabarits](/developers-guides/fr/integration-guides/wallet/update-pass-data-in-templates.md).
* Pour notifier les systèmes externes en temps réel, utilisez [Webhooks](/developers-guides/fr/integration-guides/webhooks.md).

### FAQ

<details>

<summary><strong>Comment créer une clé API ?</strong></summary>

Générez une clé API depuis la console d’administration, puis envoyez-la dans `X-API-KEY` pour les principales API de la plateforme décrites dans Commencez ici.

</details>

<details>

<summary><strong>Comment une clé API doit-elle être stockée ?</strong></summary>

Conservez les clés API dans un stockage secret côté serveur. Ne les exposez pas dans le code du navigateur, les applications mobiles, les journaux ou le contrôle de source.

</details>

<details>

<summary><strong>Où se trouve la référence de l'API ?</strong></summary>

Utilisation [Référence de l'API](https://docs.thewalletcrew.io/api-reference/) pour le point d'entrée principal de l'API.

</details>

<details>

<summary><strong>Quel est le meilleur premier appel API ?</strong></summary>

Une mise à jour forcée d’une carte existante est généralement le meilleur premier appel, car elle valide l’accès au tenant, l’authentification et le chemin de mise à jour sans dépendre d’un flux de création.

</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/developers-guides/fr/readme.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.