> ## 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.

# Idempotente verzoeken

> Probeer POST-verzoeken opnieuw met een idempotentiesleutel, zodat een verzoek nooit twee keer wordt uitgevoerd.

Elke geauthenticeerde `POST` op de Current API accepteert een `Idempotency-Key`-header. Wanneer een verzoek met een sleutel slaagt, wordt de respons 24 uur bewaard. Een nieuwe poging met dezelfde sleutel speelt de bewaarde respons opnieuw af in plaats van het verzoek opnieuw uit te voeren. Zo kun je veilig een verzoek opnieuw proberen dat aan jouw kant een time-out of fout gaf, zonder risico op een dubbele afschrijving, overboeking of resource.

Elke unieke string tot 255 bytes werkt als sleutel. Een UUID is een goede standaardkeuze. Genereer voor elke afzonderlijke bewerking een nieuwe sleutel en hergebruik precies die sleutel alleen om die bewerking opnieuw te proberen.

```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"}'
```

| Je nieuwe poging | Je krijgt |
| - | - |
| Zelfde sleutel, zelfde verzoek | De oorspronkelijke respons, opnieuw afgespeeld, geen tweede uitvoering |
| Zelfde sleutel, ander verzoek | Een `400`-fout |
| Zelfde sleutel, terwijl het eerste verzoek nog loopt | Een `409`-fout. Probeer het opnieuw nadat het eerste verzoek is voltooid |
| Zelfde sleutel, meer dan 24 uur later | Een nieuwe uitvoering, alsof de sleutel nieuw is |

Opnieuw afgespeelde responsen zijn byte voor byte identiek aan het origineel, inclusief de statuscode, en bevatten een `Idempotent-Replayed: true`-header, zodat je een herhaling kunt onderscheiden van een nieuwe uitvoering.

> [!NOTE]
>
> **Foutresponsen worden ook opnieuw afgespeeld.** Als het oorspronkelijke verzoek mislukte met een `4xx`, retourneert een nieuwe poging met dezelfde sleutel diezelfde fout. Die mislukking was de werkelijke uitkomst van het verzoek. Stuur in plaats daarvan een nieuwe sleutel met het gecorrigeerde verzoek.

Een paar details die goed zijn om te weten:

* "Zelfde verzoek" betekent dat de methode, het pad, de querystring, de body en `Api-Version-Date` allemaal exact overeenkomen met het origineel. Elk verschil wordt behandeld als hergebruik van de sleutel en geweigerd met een `400` waarvan de `error.code` `idempotency_key_mismatch` is.
* Sleutels zijn gebonden aan de geauthenticeerde aanroeper. Twee verschillende API-sleutels of gebruikers kunnen dezelfde sleutelwaarde gebruiken zonder dat die botsen.
* De header wordt genegeerd bij niet-geauthenticeerde verzoeken en bij andere methoden dan `POST`. `GET`-, `PATCH`- en `DELETE`-verzoeken kun je veilig opnieuw proberen.
* Zolang het eerste verzoek met een sleutel nog loopt, retourneert een nieuwe poging een `409` waarvan de `error.code` `idempotency_request_in_progress` is. Als het eerste verzoek mislukte met een onbekende uitkomst (bijvoorbeeld een servercrash halverwege het verzoek), blijven nieuwe pogingen die `409` retourneren totdat de sleutel verloopt. De API loopt nooit het risico een verzoek twee keer uit te voeren.


## Related topics

- [Problemen met Whop-integraties oplossen](https://docs.whop.com/nl/developer/troubleshooting.md)
- [Overzicht van de Whop API](https://docs.whop.com/nl/api-reference/overview.md)
- [RfiElement](https://docs.whop.com/nl/elements/latest/verifications/rfi.md)
