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

# Autenticación y claves de API

> Los cinco tipos de credenciales de Whop, cuándo usar cada uno y cómo limitar el alcance de una credencial a las acciones que realmente necesita.

Whop tiene cinco tipos de credenciales. La que necesitas depende de a qué datos accedes y de dónde se ejecuta el código. Elige en esta tabla y luego limita el alcance de la credencial antes de acercarla a producción.

| Credencial | Actúa como | Dónde reside | Úsala cuando |
| - | - | - | - |
| **Clave de API** | Tu cuenta o tu app | Tu servidor | Tu backend accede a tu propia cuenta o a todas las cuentas que instalaron tu app |
| **Token de usuario con alcance de cuenta** | Un usuario, dentro de una cuenta | Se genera en tu servidor y se usa en tu cliente | Tu producto ya tiene sus propios usuarios y necesitas que accedan a Whop sin iniciar sesión en Whop |
| **Token de acceso de cuenta** | Tu cuenta, con permisos restringidos | Se genera en tu servidor y se usa en tu cliente | Un cliente necesita acceso de corta duración a tu cuenta sin tener tu clave de API |
| **Token de usuario de iframe** | El usuario que ve tu app | Lo envía Whop y lo verificas tú | Tu app se muestra dentro de Whop y necesitas saber quién la está viendo |
| **Token de OAuth** | Un usuario que inició sesión en Whop | Tu servidor, tras el flujo de OAuth | Quieres que los usuarios inicien sesión con Whop y concedan a tu app acceso a su cuenta |

## Claves de API

Una clave de API de cuenta autentica tu servidor como una cuenta. Una clave de API de app autentica tu app en todas las cuentas que la instalaron. Ambas son secretas: mantenlas en el servidor.

### Crear una clave de API de cuenta

Usa una clave de API de cuenta cuando tu servidor actúe en nombre de tu propia cuenta y sus [subcuentas](https://docs.whop.com/es/developer/platforms/enroll-subaccounts.md). En la página Developer del panel, abre **Account API Keys** y selecciona **Create**. El [inicio rápido](https://docs.whop.com/es/developer/quickstart.md) te guía por el proceso en el sandbox.

### Crear una clave de API de app

Usa una clave de API de app cuando crees una app y necesites acceder a los datos de las cuentas que la instalaron.

1. En el panel, abre **Apps**.
2. Selecciona **Create app** y ponle un nombre a tu app. Puedes cambiar el nombre más tarde.
3. Tu clave es el valor oculto que sigue a `WHOP_API_KEY` en la sección **Environment variables**. Usa el botón para mostrarla y guárdala en un lugar seguro.

## Tokens de usuario con alcance de cuenta

Un token de usuario con alcance de cuenta actúa como un usuario concreto dentro de una cuenta concreta. Tu servidor lo genera con tu clave de API y se lo entrega a tu cliente, de modo que tus usuarios acceden a Whop sin iniciar sesión nunca en Whop.

Crea uno con `POST /api/v1/access_tokens` y pasa `account_id`, `user_id` y las acciones que quieres permitir:

```bash theme={null}
curl https://api.whop.com/api/v1/access_tokens \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_XXXXXXXX",
    "user_id": "user_XXXXXXXX",
    "scoped_actions": ["chat:read", "chat:message:create"]
  }'
```

`account_id` empieza por `biz_` y `user_id` empieza por `user_`. Tu clave de API debe tener permiso para acceder a ambos.

Los tokens caducan en **una hora** de forma predeterminada. Establece `expires_at` para cambiarlo, hasta un máximo de **tres horas**. Genéralos cuando los necesites en lugar de almacenarlos en caché.

> [!NOTE]
>
> Consulta [Crear token de acceso](https://docs.whop.com/es/api-reference/legacy/access-tokens/create-access-token.md).

### Limitar el alcance de un token

`scoped_actions` es la lista de cosas que puede hacer el token. Cada entrada es una cadena de acción separada por dos puntos.

> [!WARNING]
>
> Si dejas `scoped_actions` vacío o lo omites, el token **hereda todos los permisos de la credencial que lo genera**. Un token entregado a un navegador tendría entonces todo el alcance de tu clave de API. Pasa siempre una lista explícita.

Una acción debe ser un subconjunto de los propios permisos de la credencial que genera el token. No puedes conceder lo que tu clave de API no tiene.

Estas acciones aparecen hoy en las guías de Whop:

| Acción | Concede |
| - | - |
| `chat:read` | Leer canales y mensajes de chat |
| `chat:message:create` | Enviar mensajes de chat |
| `dms:read` | Leer mensajes directos |
| `dms:message:manage` | Enviar y gestionar mensajes directos |
| `dms:channel:manage` | Crear y gestionar canales de MD |
| `support_chat:read` | Leer chats de soporte |
| `support_chat:message:create` | Enviar mensajes de chat de soporte |
| `company:balance:read` | Leer el saldo de una cuenta |

La API no publica una lista fija, así que considera este el conjunto documentado y no el completo. El límite definitivo siempre son los propios permisos de la credencial que genera el token.

## Tokens de acceso de cuenta

Un token de acceso de cuenta actúa como la propia cuenta, sin ningún usuario asociado. Crea uno con `POST /api/v1/access_tokens` pasando solo `account_id` y las `scoped_actions` que quieres permitir. Caduca con el mismo calendario que un token de usuario con alcance de cuenta.

Úsalo cuando un cliente necesite el acceso de tu cuenta durante poco tiempo, como un componente incrustado, y no intervenga ningún usuario concreto. Los endpoints que actúan como un usuario, como los de notificaciones o preferencias, lo rechazan.

## Tokens de usuario de `iframe`

Cuando tu app se muestra dentro de Whop, cada solicitud del mismo origen lleva un JWT de corta duración en la cabecera `x-whop-user-token`. Verificas su firma para saber quién hace la solicitud y luego compruebas qué puede ver. Los SDK de Python y Ruby incluyen una función auxiliar para ello. El SDK de TypeScript no, así que verifica el JWT tú mismo.

Este token nunca lo generas tú. Lo envía Whop y tú lo validas. Consulta [Autenticación](https://docs.whop.com/es/developer/guides/authentication.md).

## Tokens de OAuth

Un token de OAuth representa a un usuario que inició sesión en Whop y aprobó tu app para un conjunto de alcances. A diferencia de una clave de API, su alcance está limitado por lo que puede hacer ese usuario concreto.

Úsalo para Iniciar sesión con Whop y para actuar en nombre de un usuario sobre su propia cuenta. Consulta [OAuth](https://docs.whop.com/es/developer/guides/oauth.md).

## Lista de comprobación de alcance

Antes de que una credencial llegue a producción:

* Pasa `scoped_actions` explícitas en cada token que generes. No confíes nunca en la herencia.
* Asigna a las claves de API un conjunto de permisos personalizado en cuanto sepas a qué endpoints llamas, en lugar de dejarlas como Admin.
* Mantén las claves de API en el servidor. Solo los tokens de usuario deben ir en un cliente.
* Genera tokens de corta duración cuando los necesites en lugar de almacenar en caché tokens de larga duración.
* Usa credenciales distintas para cada entorno y comprueba cuál tienes antes de ejecutar cualquier cosa que mueva dinero.

## Próximos pasos

> [card] [Inicio rápido](https://docs.whop.com/es/developer/quickstart.md)
>
> Crea una clave del sandbox y haz tu primera llamada.

> [card] [Conceptos principales](https://docs.whop.com/es/developer/concepts.md)
>
> Cómo se relacionan las cuentas, los usuarios y los permisos.

> [card] [OAuth](https://docs.whop.com/es/developer/guides/oauth.md)
>
> El flujo completo de OAuth 2.1 y PKCE.

> [card] [Probar en el sandbox](https://docs.whop.com/es/developer/guides/sandbox.md)
>
> Prueba primero las credenciales con datos de prueba.


## Related topics

- [Inicio rápido de la API de Whop](https://docs.whop.com/es/developer/quickstart.md)
- [Autenticación del chat](https://docs.whop.com/es/developer/guides/chat/authentication.md)
- [Conceptos principales de la API de Whop](https://docs.whop.com/es/developer/concepts.md)
