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

# Solicitudes idempotentes

> Reintenta solicitudes POST con una clave de idempotencia para que una solicitud nunca se ejecute dos veces.

Cada `POST` autenticado de la API actual acepta un encabezado `Idempotency-Key`. Cuando una solicitud con una clave se completa correctamente, su respuesta se almacena durante 24 horas. Reintentar con la misma clave reproduce la respuesta almacenada en lugar de ejecutar la solicitud de nuevo. Esto hace que sea seguro reintentar una solicitud que agotó el tiempo de espera o falló por tu lado sin arriesgarte a un cargo, una transferencia o un recurso duplicados.

Cualquier cadena única de hasta 255 bytes sirve como clave; un UUID es una buena opción predeterminada. Genera una clave nueva para cada operación distinta y reutiliza exactamente esa clave solo para reintentar esa operación.

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

| Tu reintento | Obtienes |
| - | - |
| Misma clave, misma solicitud | La respuesta original, reproducida; no una segunda ejecución |
| Misma clave, solicitud diferente | Un error `400` |
| Misma clave, mientras la primera solicitud sigue en ejecución | Un error `409`; reintenta cuando termine la primera solicitud |
| Misma clave, más de 24 horas después | Una ejecución nueva, como si la clave fuera nueva |

Las respuestas reproducidas son idénticas byte a byte a la original, incluido el código de estado, y llevan un encabezado `Idempotent-Replayed: true` para que puedas distinguir una reproducción de una ejecución nueva.

> [!NOTE]
>
> **Las respuestas de error también se reproducen.** Si la solicitud original falló con un `4xx`, reintentar con la misma clave devuelve ese mismo error. Ese fallo fue el resultado real de la solicitud; envía una clave nueva con la solicitud corregida.

Algunos detalles que conviene saber:

* "Misma solicitud" significa que el método, la ruta, la cadena de consulta, el cuerpo y `Api-Version-Date` coinciden exactamente con los originales. Cualquier diferencia se trata como una reutilización de la clave y se rechaza con un `400` cuyo `error.code` es `idempotency_key_mismatch`.
* Las claves están limitadas al llamador autenticado. Dos claves de API o usuarios diferentes pueden usar el mismo valor de clave sin colisionar.
* El encabezado se ignora en solicitudes no autenticadas y en métodos distintos de `POST`: las solicitudes `GET`, `PATCH` y `DELETE` se pueden reintentar con seguridad.
* Mientras la primera solicitud con una clave sigue en ejecución, un reintento devuelve un `409` cuyo `error.code` es `idempotency_request_in_progress`. Si la primera solicitud falló con un resultado desconocido (por ejemplo, una caída del servidor a mitad de la solicitud), los reintentos siguen devolviendo ese `409` hasta que la clave caduca. La API nunca se arriesga a ejecutar una solicitud dos veces.


## Related topics

- [Solución de problemas de integraciones con Whop](https://docs.whop.com/es/developer/troubleshooting.md)
- [API de solicitudes de financiación](https://docs.whop.com/es/api-reference/financing-applications/financing-application.md)
- [Crea apps de Whop con React Native](https://docs.whop.com/es/developer/guides/react-native.md)
