> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Requêtes idempotentes

> Relancez des requêtes POST avec une clé d'idempotence, afin qu'une requête ne soit jamais exécutée deux fois.

Chaque requête `POST` authentifiée sur la Current API accepte un en-tête `Idempotency-Key`. Lorsqu'une requête avec une clé réussit, sa réponse est conservée pendant 24 heures. Une nouvelle tentative avec la même clé renvoie la réponse conservée au lieu d'exécuter à nouveau la requête. Vous pouvez ainsi relancer sans risque une requête qui a expiré ou échoué de votre côté, sans craindre un double débit, un double transfert ou une ressource en double.

N'importe quelle chaîne unique de 255 octets maximum peut servir de clé — un UUID est un bon choix par défaut. Générez une nouvelle clé pour chaque opération distincte, et ne réutilisez exactement cette clé que pour relancer cette opération.

```bash theme={null}
curl -X POST https://api.whop.com/api/v1/transfers \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Idempotency-Key: d9105228-4a08-46b1-8b91-42fed586d383" \
  -H "Content-Type: application/json" \
  -d '{"type": "balance", "amount": "10.00", "currency": "usd", "destination_id": "user_XXXXXXXX"}'
```

| Votre nouvelle tentative | Vous obtenez |
| - | - |
| Même clé, même requête | La réponse d'origine, renvoyée à l'identique — pas une seconde exécution |
| Même clé, requête différente | Une erreur `400` |
| Même clé, alors que la première requête est encore en cours | Une erreur `409` — réessayez une fois la première requête terminée |
| Même clé, plus de 24 heures plus tard | Une nouvelle exécution, comme si la clé était nouvelle |

Les réponses rejouées sont identiques octet pour octet à l'originale — code de statut compris — et portent un en-tête `Idempotent-Replayed: true` afin que vous puissiez distinguer une réponse rejouée d'une nouvelle exécution.

> [!NOTE]
>
> **Les réponses d'erreur sont aussi rejouées.** Si la requête d'origine a échoué avec une erreur `4xx`, une nouvelle tentative avec la même clé renvoie cette même erreur. Cet échec était le résultat réel de la requête — envoyez plutôt une nouvelle clé avec la requête corrigée.

Quelques détails à connaître :

* « Même requête » signifie que la méthode, le chemin, la chaîne de requête, le corps et `Api-Version-Date` correspondent tous exactement à l'original. Toute différence est considérée comme une réutilisation de clé et rejetée avec une erreur `400` dont le `error.code` est `idempotency_key_mismatch`.
* Les clés sont limitées à l'appelant authentifié. Deux clés API ou utilisateurs différents peuvent utiliser la même valeur de clé sans conflit.
* L'en-tête est ignoré sur les requêtes non authentifiées et sur les méthodes autres que `POST` — les requêtes `GET`, `PATCH` et `DELETE` peuvent être relancées sans risque.
* Tant que la première requête avec une clé est en cours, une nouvelle tentative renvoie une erreur `409` dont le `error.code` est `idempotency_request_in_progress`. Si la première requête a échoué avec un résultat inconnu (par exemple, une panne du serveur en cours de requête), les nouvelles tentatives continuent de renvoyer cette erreur `409` jusqu'à l'expiration de la clé. L'API ne prend jamais le risque d'exécuter une requête deux fois.


## Related topics

- [Dépanner les intégrations Whop](https://docs.whop.com/fr/developer/troubleshooting.md)
- [Créer des apps Whop avec React Native](https://docs.whop.com/fr/developer/guides/react-native.md)
- [API Search](https://docs.whop.com/fr/api-reference/search/search.md)
