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

# Conceptos principales de la API de Whop

> Los objetos con los que está construida la API de Whop: qué es cada uno, cómo se llama y cómo se conectan.

La API de Whop consta de un pequeño número de objetos que se conectan de formas predecibles. Esta página define cada uno y lo indica claramente cuando un objeto tiene más de un nombre.

```mermaid theme={null}
graph LR
  A[cuenta<br/>biz_] --> P[producto<br/>prod_]
  A --> K[claves de API]
  P --> L[variante<br/>plan_]
  P --> E[experiencia<br/>exp_]
  U[usuario<br/>user_] --> M[membresía<br/>mem_]
  M --> P
  PAY[pago<br/>pay_] --> LG[libro mayor<br/>ldgr_]
  LG --> PO[pago saliente]
  LG --> T[transferencia]
```

## Cuentas e identidad

**account** `biz_`

Un negocio en Whop. Es propietario de claves de API, productos, webhooks y dinero. Consulta [Cuentas](https://docs.whop.com/es/api-reference/accounts/account).

**user** `user_`

Una persona con inicio de sesión en Whop. Un usuario puede comprar a muchas cuentas y también puede ayudar a gestionar una. Consulta [Usuarios](https://docs.whop.com/es/api-reference/users/user).

**team member**

Un usuario al que se le concede acceso para operar una cuenta. Su rol determina lo que puede hacer. Consulta [Miembros del equipo](https://docs.whop.com/es/api-reference/team-members/team-member).

**member**

Un usuario visto como cliente: alguien que tiene o tuvo una membresía de algo que vende la cuenta. Consulta [Miembros](https://docs.whop.com/es/api-reference/members/member).

### Subcuenta

Una cuenta que das de alta y en cuyo nombre actúas cuando gestionas un marketplace. Cobras pagos en su nombre y le realizas pagos salientes. Las guías de plataforma a veces la llaman submerchant. Las dos palabras se refieren al mismo objeto. El [inicio rápido de plataformas](https://docs.whop.com/es/developer/platforms/quickstart.md) recorre todo el flujo.

**verification**

La comprobación de identidad que una cuenta debe superar antes de poder recibir pagos salientes. Las personas físicas completan comprobaciones Know Your Customer (KYC). Las empresas completan comprobaciones Know Your Business (KYB). Consulta [Verificaciones](https://docs.whop.com/es/api-reference/verifications/verification).

**identity profile** `idpf_`

El registro de los datos de identidad verificados que produce una verificación.

## Lo que vendes

Una cuenta vende productos. Un producto incluye una o más variantes, que fijan el precio, y se conecta a las experiencias que realmente recibe un comprador.

**product** `prod_`

Algo que vende una cuenta. Contiene la descripción, los medios y las variantes entre las que puede elegir un comprador. Consulta [Productos](https://docs.whop.com/es/api-reference/products/product).

**variant** `plan_`

Una configuración comprable de un producto, con su propio precio, forma de facturación, stock, SKU y atributos. Los ID de variante conservan el prefijo `plan_`. Consulta [Variantes](https://docs.whop.com/es/api-reference/variants/variant).

**membership** `mem_`

Lo que obtiene un comprador cuando paga. Vincula a un usuario con una variante e incluye un estado que te indica si el acceso es válido en este momento. Consulta [Membresías](https://docs.whop.com/es/api-reference/memberships/membership).

### Experiencia

Una unidad de contenido o funcionalidad dentro de lo que vende una cuenta. Un producto se conecta a una o más experiencias, y una membresía de ese producto es lo que concede acceso a ellas.

Este es el sustantivo más específico de la plataforma Whop y el que no puedes deducir por su nombre. Si estás creando una app que se ejecuta dentro de Whop, la experiencia es aquello en lo que se renderiza tu app. Consulta [Vistas de app](https://docs.whop.com/es/developer/guides/app-views.md).

### Derecho de acceso

El registro que indica que un usuario puede usar algo específico en este momento. El acceso es la pregunta, y el derecho de acceso es la respuesta almacenada. Compruébalo con respecto a una cuenta, un producto o una experiencia. Consulta [Autenticación](https://docs.whop.com/es/developer/guides/authentication.md).

## Cómo se mueve el dinero

El dinero llega, se queda en algún lugar y luego sale. Cada objeto a continuación es un paso en ese camino, en el orden en que ocurre.

**checkout configuration** `ch_`

La definición reutilizable de una compra: qué variante, a qué precio y con qué redirección. Produce una página de checkout activa. Consulta [Configuraciones de checkout](https://docs.whop.com/es/api-reference/checkout-configurations/checkout-configuration).

**payment** `pay_`

Un intento de mover dinero de un comprador a una cuenta, con un estado que indica si funcionó.

**charge**

El mismo evento descrito desde el lado de la red de tarjetas. La documentación usa ambas palabras. El objeto de la API es el pago.

### Libro mayor

El registro continuo de cada crédito y débito en el dinero de una cuenta. Es la fuente de verdad de lo que tiene una cuenta y de lo que se le debe. El dinero llega a un libro mayor antes de ir a cualquier otro lugar. Consulta [Actividad del libro mayor](https://docs.whop.com/es/api-reference/ledgers/ledger-activity).

**balance**

El importe que hay en un libro mayor en este momento y que puedes gastar o retirar.

**reserve**

Una parte de un saldo que Whop retiene como garantía frente a futuros reembolsos y disputas. Se libera según un calendario.

**fee**

La parte de un pago que se queda Whop, descontada antes de que el dinero llegue a un saldo.

**deposit**

Dinero añadido a un saldo desde fuera de Whop. Consulta [Depósitos](https://docs.whop.com/es/api-reference/deposits/deposit).

**payout**

Dinero que sale de un saldo hacia una cuenta bancaria o billetera fuera de Whop. Consulta [Pagos salientes](https://docs.whop.com/es/api-reference/payouts/payout).

**transfer**

Dinero que se mueve entre dos cuentas dentro de Whop, sin salir al mundo exterior. Consulta [Transferencias](https://docs.whop.com/es/api-reference/transfers/transfer).

**swap**

Una conversión de un saldo entre tokens, cadenas o destinos de billetera compatibles. Consulta [Swaps](https://docs.whop.com/es/api-reference/swaps/swap).

**card** `icrd_`

Una tarjeta virtual emitida por Whop que gasta del saldo de una cuenta o de un usuario. Consulta [Tarjetas](https://docs.whop.com/es/api-reference/cards/card).

**refund**

Un pago completado que se devuelve al comprador, iniciado por ti.

**dispute**

Un pago revertido por el banco del comprador en su nombre. Puedes impugnarlo. Consulta [Disputas](https://docs.whop.com/es/api-reference/disputes/dispute).

## Construir sobre Whop

> [!NOTE]
>
> **Plataforma** significa dos cosas en esta documentación. Whop como plataforma es el producto con el que te estás integrando. Una plataforma en el sentido de marketplace eres *tú*, una vez que das de alta subcuentas y te quedas con una parte de lo que venden. La frase que lo rodea te indica a cuál se refiere.

**app** `app_`

Software que se ejecuta dentro de Whop y llega a una audiencia a través de su marketplace. Consulta [Apps](https://docs.whop.com/es/api-reference/apps/app).

**app view**

Una pantalla que una app renderiza dentro de Whop: la vista de experiencia orientada al cliente o la vista de panel orientada al creador. Consulta [Vistas de app](https://docs.whop.com/es/developer/guides/app-views.md).

**iframe**

La forma en que Whop incrusta las páginas de tu app en su propia interfaz. Tu app se ejecuta en tus servidores y se renderiza dentro del marco de Whop. Consulta [iframe](https://docs.whop.com/es/developer/guides/iframe.md).

**permission**

Una capacidad individual que una clave de API puede ejercer. Consulta [Permisos](https://docs.whop.com/es/developer/guides/permissions.md).

### Scope

La misma idea que un permiso, pero en un token OAuth: el conjunto de cosas que un usuario ha aceptado que tu app haga en su nombre. Un permiso es lo que tu clave puede hacer. Un scope es lo que un usuario te permitió hacer. Consulta la [guía de OAuth](https://docs.whop.com/es/developer/guides/oauth.md).

**OAuth grant**

El registro de que un usuario aprobó tu app para un conjunto de scopes.

**element**

Un componente de interfaz prediseñado que Whop ofrece y que insertas en tu propio producto, para que no tengas que construir la interfaz tú mismo.

**event**

Algo que ocurrió en una cuenta, como un pago que se completa correctamente.

**webhook**

La solicitud HTTP que Whop envía a tu servidor para indicarte que ocurrió un evento. Consulta [Webhooks](https://docs.whop.com/es/developer/guides/webhooks.md).

## Comunidad

**chat channel**

Una sala donde los miembros se envían mensajes entre sí. Consulta [Chat](https://docs.whop.com/es/developer/guides/chat/quickstart.md).

**message**

Una publicación en un canal de chat o un mensaje directo.

**forum**

Un espacio con hilos para publicaciones más largas, separado del chat en vivo. Consulta [Foros](https://docs.whop.com/es/developer/guides/forums.md).

**forum post**

Un hilo de un foro, con sus respuestas y sus reacciones.

**notification**

Un mensaje enviado a un usuario dentro de Whop. Cada envío se limita a una experiencia o a un usuario. Consulta [Notificaciones](https://docs.whop.com/es/developer/guides/notifications.md).

## Publicidad

**ad campaign** `adcamp_`

El contenedor de nivel superior para anuncios de pago en una red publicitaria. Establece la plataforma, el objetivo y la estrategia de presupuesto. Consulta [Campañas publicitarias](https://docs.whop.com/es/api-reference/ad-campaigns/ad-campaign).

**ad group** `adgrp_`

Se encuentra dentro de una campaña y controla la entrega: la segmentación, el objetivo de optimización y la programación. Consulta [Grupos de anuncios](https://docs.whop.com/es/api-reference/ad-groups/ad-group).

**ad** `ad_`

La unidad creativa que entrega un grupo de anuncios: texto, recursos y la URL de destino. Consulta [Anuncios](https://docs.whop.com/es/api-reference/ads/ad).

**audience**

Una lista de clientes subida a Whop y usada para incluir o excluir personas en un grupo de anuncios. Consulta [Audiencias](https://docs.whop.com/es/api-reference/audiences/audience).

## Referencias y recompensas

**affiliate** `aff_`

Alguien que gana una comisión por enviar compradores a un producto. Consulta [Afiliados](https://docs.whop.com/es/developer/guides/affiliates.md).

**partner**

Un usuario inscrito en el programa de partners de Whop, que gana con los negocios que refiere a Whop. Consulta [Partners](https://docs.whop.com/es/developer/partners/overview.md).

**referred business** `coma_`

Un negocio que un partner trajo a Whop, con las tasas de comisión y la ventana de referencia que se le aplican.

**partner earning**

Una línea de comisión de un negocio referido, que indica la fuente de ingresos de la que proviene y su estado.

**bounty** `bnty_`

Una tarea remunerada cuya recompensa se retiene en depósito de garantía desde el momento en que se publica. Consulta [Recompensas](https://docs.whop.com/es/developer/bounties/overview.md).

**bounty submission** `btys_`

El intento de un trabajador en una recompensa, desde el intento hasta la revisión y el pago.

## Entornos y claves

Whop tiene dos entornos. No comparten nada.

| | Sandbox | Producción |
| - | - | - |
| Dinero | Nunca se mueve | Real |
| Panel | Independiente | Independiente |
| Claves | Conjunto propio | Conjunto propio |
| Datos | Datos de prueba | Datos reales |

Consulta [Prueba en el sandbox](https://docs.whop.com/es/developer/guides/sandbox.md) para saber cómo cambiar de entorno.

> [!WARNING]
>
> Las claves de sandbox y de producción tienen el mismo aspecto. Nada en la cadena de la clave indica a qué entorno pertenece, así que guárdalas con nombres diferentes y compruébalo antes de ejecutar cualquier cosa que mueva dinero.

Cinco tipos de credenciales acceden a la API. Elige según de quién son los datos que necesitas.

| Credencial | Actúa como | Úsala cuando |
| - | - | - |
| Clave de API | Tu cuenta o tu app | Tu servidor trabaja sobre tu propio negocio, o sobre todas las cuentas que instalaron tu app |
| Token de usuario limitado a la cuenta | Un usuario, dentro de una cuenta | Tu producto tiene sus propios usuarios y estos acceden a Whop sin iniciar sesión en Whop |
| Token de acceso de cuenta | Tu cuenta, con permisos reducidos | 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 está viendo tu app | Tu app se renderiza dentro de Whop y necesitas saber quién la está viendo |
| Token OAuth | Un usuario que inició sesión en Whop | Un usuario inició sesión y aprobó tu app |

Consulta [Autenticación y claves de API](https://docs.whop.com/es/developer/guides/auth-scoping.md) para saber cómo elegir y limitar cada una.

**Api-Version-Date**

El encabezado que fija tu integración a una versión fechada de la API, para que los cambios posteriores no alteren las respuestas con las que construiste. Consulta [Versionado de la API](https://docs.whop.com/es/developer/api/versioning.md).

**idempotency key**

Un valor que adjuntas a un `POST` para que, al reintentarlo, se reproduzca la respuesta original en lugar de hacer el trabajo dos veces. Consulta [Solicitudes idempotentes](https://docs.whop.com/es/developer/api/idempotency.md).

## Referencia de ID

Cada objeto tiene un ID con prefijo. Cuando estés mirando un payload, esta tabla te indica qué tienes delante.

| Prefijo | Objeto | Consulta |
| - | - | - |
| `biz_` | Cuenta | [Cuentas](https://docs.whop.com/es/api-reference/accounts/account) |
| `user_` | Usuario | [Usuarios](https://docs.whop.com/es/api-reference/users/user) |
| `prod_` | Producto | [Productos](https://docs.whop.com/es/api-reference/products/product) |
| `plan_` | Variante | [Variantes](https://docs.whop.com/es/api-reference/variants/variant) |
| `mem_` | Membresía | [Membresías](https://docs.whop.com/es/api-reference/memberships/membership) |
| `exp_` | Experiencia | [Vistas de app](https://docs.whop.com/es/developer/guides/app-views.md) |
| `app_` | App | [Apps](https://docs.whop.com/es/api-reference/apps/app) |
| `pay_` | Pago | [Descripción general](https://docs.whop.com/es/api-reference/overview.md) |
| `ch_` | Configuración de checkout | [Configuraciones de checkout](https://docs.whop.com/es/api-reference/checkout-configurations/checkout-configuration) |
| `ldgr_` | Cuenta del libro mayor | [Actividad del libro mayor](https://docs.whop.com/es/api-reference/ledgers/ledger-activity) |
| `idpf_` | Perfil de identidad | [Verificaciones](https://docs.whop.com/es/api-reference/verifications/verification) |
| `sacc_` | Cuenta externa | [Cuentas externas](https://docs.whop.com/es/api-reference/external-accounts/external-account) |
| `aff_` | Afiliado | [Afiliados](https://docs.whop.com/es/developer/guides/affiliates.md) |
| `adcamp_` | Campaña publicitaria | [Campañas publicitarias](https://docs.whop.com/es/api-reference/ad-campaigns/ad-campaign) |
| `adgrp_` | Grupo de anuncios | [Grupos de anuncios](https://docs.whop.com/es/api-reference/ad-groups/ad-group) |
| `ad_` | Anuncio | [Anuncios](https://docs.whop.com/es/api-reference/ads/ad) |
| `bnty_` | Recompensa | [Recompensas](https://docs.whop.com/es/developer/bounties/overview.md) |
| `btys_` | Envío de recompensa | [Recompensas](https://docs.whop.com/es/developer/bounties/overview.md) |
| `coma_` | Negocio referido | [Partners](https://docs.whop.com/es/developer/partners/overview.md) |
| `icrd_` | Tarjeta | [Tarjetas](https://docs.whop.com/es/api-reference/cards/card) |
| `course_` | Curso | [Descripción general](https://docs.whop.com/es/api-reference/overview.md) |
| `file_` | Archivo | [Descripción general](https://docs.whop.com/es/api-reference/overview.md) |

## Próximos pasos

> [card] [Inicio rápido](https://docs.whop.com/es/developer/quickstart.md)
>
> Haz tu primera llamada a la API en pocos minutos.

> [card] [Prueba en el sandbox](https://docs.whop.com/es/developer/guides/sandbox.md)
>
> Pruébalo todo con datos de prueba antes de pasar a producción.

> [card] [Descripción general de la API](https://docs.whop.com/es/api-reference/overview.md)
>
> Cómo funcionan las solicitudes, el versionado y la paginación.

> [card] [Qué puedes crear](https://docs.whop.com/es/developer/start.md)
>
> El mapa completo de capacidades y la guía para lo que estás creando.


## Related topics

- [Descripción general de la API de Whop](https://docs.whop.com/es/api-reference/overview.md)
- [API de Whop Partners](https://docs.whop.com/es/developer/partners/overview.md)
- [Inicio rápido de la API de Whop](https://docs.whop.com/es/developer/quickstart.md)
