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

# Migra desde versiones anteriores

> Migra una integración desde la API v2 o la API GraphQL pública. Encuentra el reemplazo en la API actual para cada ruta u operación y qué se comporta de forma diferente.

Whop va a retirar dos API antiguas. Ambas pasan a la API actual en `https://api.whop.com/api/v1`, con las mismas claves de API.

| Si tu integración llama a | Deja de funcionar | Guía |
| - | - | - |
| `https://api.whop.com/api/v2` o `https://api.whop.com/v2` | 13 de noviembre de 2026 | [API v2](#v2) |
| `https://api.whop.com/public-graphql`, o usa el paquete `@whop/api` | 26 de octubre de 2026 | [GraphQL pública](#public-graphql) |

## Cambia a la API actual

**1. Conserva tu clave de API**

La API actual usa las mismas claves de API de cuenta y de app. Si una solicitud devuelve `403`, a la clave le falta el permiso que necesita ese endpoint. Añádelo en **Developer → API keys**, o solicítalo en los permisos de tu app.

**2. Instala el SDK y fija una versión**

Los SDK oficiales llaman a la API actual y envían la versión de la API con la que se construyeron. Si usas `@whop/api`, reemplázalo por `@whop/sdk`. Sus helpers `withUser` y `withCompany` no tienen equivalente: pasa el ID de usuario o de cuenta en cada solicitud.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

const access = await client.users.checkAccess({
  id: "user_xxxxxxxxxxxxx",
  resource_id: "exp_xxxxxxxxxxxxx",
});
```

```python Python theme={null}
import os

from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

membership = client.memberships.retrieve("mem_xxxxxxxxxxxxx")
```

```bash cURL theme={null}
curl https://api.whop.com/api/v1/memberships/mem_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1"
```

Si llamas a la API sin un SDK, envía `Api-Version-Date` en cada solicitud. [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md) explica cómo fijar una versión.

**3. Reemplaza cada llamada**

Usa la pestaña de la API que estás abandonando y luego elimina la URL base o el paquete antiguos de tu código.

> [tab] API v2
>
> ### Encuentra tus llamadas a v2
>
> Cada respuesta de v2 incluye tres encabezados:
>
> | Encabezado | Ejemplo | Significado |
> | - | - | - |
> | `Deprecation` | `@1791417600` | Whop ha marcado este endpoint como obsoleto. El valor es la fecha de obsolescencia en segundos Unix. |
> | `Sunset` | `Fri, 13 Nov 2026 00:00:00 GMT` | La API v2 deja de funcionar el 13 de noviembre de 2026. |
> | `Link` | `<https://api.whop.com/api/v1/memberships/mem_xxxxxxxxxxxxx>; rel="successor-version", <https://docs.whop.com/developer/api/migrate-from-previous-versions#v2>; rel="deprecation"` | La URL `successor-version` es la solicitud de la API actual que reemplaza a esta. La URL `deprecation` es esta guía. |
>
> Registra las respuestas que incluyan `Deprecation` para encontrar todas las llamadas a v2 que tu integración sigue haciendo.
>
> ### Mapa de rutas
>
> #### Membresías y licencias
>
> | Ruta v2 | API actual | Notas |
> | - | - | - |
> | `GET /memberships` | `GET /memberships` | Paginación por cursor. Consulta [Paginación](#pagination). Reemplaza `discord_id=<id>` por `external_account=discord_<id>`. |
> | `GET /memberships/{id}` | `GET /memberships/{id}` | También acepta una clave de licencia en lugar del ID `mem_`. |
> | `POST /memberships/{id}` | `PATCH /memberships/{id}` | Envía `metadata` para combinar claves. Envía `{}` para vaciarlo. |
> | `POST /memberships/{id}/cancel` | `POST /memberships/{id}/cancel` | Pasa `cancel_at_period_end: true` para mantener el acceso hasta la fecha de renovación. |
> | `POST /memberships/{id}/terminate` | `POST /memberships/{id}/cancel` | Omite `cancel_at_period_end` para revocar el acceso inmediatamente. |
> | `POST /memberships/{id}/add_free_days` | `POST /memberships/{id}/extend` | |
> | `POST /memberships/{id}/validate_license` | `GET /memberships/{id}` y `PATCH /memberships/{id}` | Comprueba la clave y vincula una máquina desde tu servidor. Consulta [Claves de licencia](#license-keys). |
> | `GET /licenses` | `GET /memberships` | Cada membresía tiene una `license_key` cuando su producto incluye la app Software. |
>
> #### Miembros y clientes
>
> | Ruta v2 | API actual | Notas |
> | - | - | - |
> | `GET /members` | `GET /members` | |
> | `GET /customers` | `GET /members` | Los clientes y los miembros son el mismo recurso. |
> | `GET /members/{search}` | `GET /members` | Filtra con `user_ids` o `query`. `GET /members/{id}` solo acepta un ID `mber_`. Para encontrar un miembro por su ID de Discord, llama a `GET /memberships?external_account=discord_<id>` y lee el `member_id` de cada membresía. |
> | `GET /customers/{search}` | `GET /members` | Igual que lo anterior. |
>
> #### Pagos y checkout
>
> | Ruta v2 | API actual | Notas |
> | - | - | - |
> | `GET /payments` | `GET /payments` | Los filtros están en singular, como `status` y `membership_id`. |
> | `GET /payments/{id}` | `GET /payments/{id}` | |
> | `POST /payments/{id}/refund` | `POST /payments/{id}/refund` | |
> | `GET /payment_fees?payment_id=` | `GET /payments/{id}/fees` | |
> | `GET /payment_methods` | `GET /payment_methods` | |
> | `POST /checkout_requests` | `POST /payments` | Pasa `member_id` (`mber_`) y `payment_method_id`. La respuesta es el pago. |
> | `GET /checkout_requests/{id}` | `GET /payments/{id}` | `POST /payments` devuelve el pago directamente, así que no necesitas sondear. |
> | `GET /checkout_sessions` | `GET /checkout_configurations` | Las sesiones de checkout ahora se llaman configuraciones de checkout. |
> | `GET /checkout_sessions/{id}` | `GET /checkout_configurations/{id}` | |
> | `POST /checkout_sessions` | `POST /checkout_configurations` | La respuesta incluye `purchase_url`. |
> | `DELETE /checkout_sessions/{id}` | `DELETE /checkout_configurations/{id}` | |
>
> #### Productos y planes
>
> Los planes ahora se llaman variantes. Los ID de variante conservan el prefijo `plan_`, por lo que los ID almacenados siguen funcionando.
>
> | Ruta v2 | API actual | Notas |
> | - | - | - |
> | `GET /products`, `GET /access_passes` | `GET /products` | Los pases de acceso ahora se llaman productos. |
> | `GET /products/{id}`, `GET /access_passes/{id}` | `GET /products/{id}` | |
> | `POST /products/{id}`, `POST /access_passes/{id}` | `PATCH /products/{id}` | |
> | `GET /plans` | `GET /variants` | |
> | `GET /plans/{id}` | `GET /variants/{id}` | |
> | `POST /plans` | `POST /variants` | |
> | `POST /plans/{id}` | `PATCH /variants/{id}` | |
> | `POST /plans/{id}/create_quick_link` | `POST /variants` | Crea una variante con `visibility: "quick_link"`, `stock` y `short_link`. La API actual no copia un plan existente, así que envía también sus campos de precio. |
> | `GET /promo_codes` | `GET /promo_codes` | |
> | `GET /promo_codes/{id}` | `GET /promo_codes/{id}` | |
> | `POST /promo_codes` | `POST /promo_codes` | |
> | `POST /promo_codes/{id}` | `POST /promo_codes/{id}/activate`, `POST /promo_codes/{id}/deactivate` | Solo cubre `status`. Crea un nuevo código promocional para cambiar sus variantes, stock o metadatos. Después, desactiva el anterior. |
> | `DELETE /promo_codes/{id}` | `DELETE /promo_codes/{id}` | |
>
> #### Cuenta, experiencias, reseñas y webhooks
>
> | Ruta v2 | API actual | Notas |
> | - | - | - |
> | `GET /company` | `GET /accounts/me` | |
> | `GET /experiences` | `GET /experiences` | |
> | `GET /experiences/{id}` | `GET /experiences/{id}` | |
> | `POST /experiences/{id}` | `PATCH /experiences/{id}` | |
> | `DELETE /experiences/{id}` | `DELETE /experiences/{id}` | |
> | `GET /reviews` | `GET /reviews` | |
> | `GET /reviews/{id}` | `GET /reviews/{id}` | |
> | `GET /webhooks` | `GET /webhooks` | |
> | `GET /webhooks/{id}` | `GET /webhooks/{id}` | |
> | `POST /webhooks` | `POST /webhooks` | Consulta [Webhooks](#webhooks). |
> | `POST /webhooks/{id}` | `PATCH /webhooks/{id}` | |
> | `DELETE /webhooks/{id}` | `DELETE /webhooks/{id}` | |
>
> ### Qué cambió respecto a v2
>
> #### Actualizaciones parciales
>
> v2 actualizaba un recurso con `POST /resource/{id}`. La API actual usa `PATCH /resource/{id}` y solo cambia los campos que envías.
>
> #### Claves de licencia
>
> `validate_license` de v2 comprobaba una clave y la vinculaba a una máquina en una sola llamada. En la API actual, tu servidor obtiene la membresía por clave de licencia, comprueba su `status` y escribe un ID de hardware en `metadata` la primera vez que alguien usa la clave. La [guía de SaaS](https://docs.whop.com/es/supported-business-models/saas.md#license-key-integration) tiene el ejemplo completo.
>
> Mantén estas llamadas en tu servidor. La clave de API de tu cuenta puede modificar cualquier membresía de tu negocio, así que nunca la incluyas dentro de software descargable.
>
> #### Webhooks en el formato v2
>
> Los webhooks creados a través de v2 siguen enviando payloads en formato v2. Para recibir el formato actual, crea un nuevo webhook desde el panel o con `POST /webhooks`, traslada tu manejador a él y luego elimina el webhook de v2. [Webhooks](https://docs.whop.com/es/developer/guides/webhooks.md) cubre las comprobaciones de firma y los tipos de evento.

> [tab] GraphQL pública
>
> ### Encuentra tus llamadas a GraphQL
>
> Si tu app importa `WhopServerSdk` o `makeWhopServerSdk` desde `@whop/api`, llama a la API GraphQL. Cada método de ese cliente, como `whopSdk.access.checkIfUserHasAccessToExperience`, envía una operación GraphQL con el mismo nombre.
>
> Cada respuesta de GraphQL también incluye estos encabezados:
>
> | Encabezado | Ejemplo | Significado |
> | - | - | - |
> | `Deprecation` | `@1789948800` | Whop ha marcado esta API como obsoleta. El valor es la fecha de obsolescencia en segundos Unix. |
> | `Sunset` | `Mon, 26 Oct 2026 00:00:00 GMT` | La API GraphQL deja de funcionar el 26 de octubre de 2026. |
> | `Link` | `<https://docs.whop.com/developer/api/migrate-from-previous-versions#public-graphql>; rel="deprecation"` | Esta guía. |
>
> Busca `@whop/api` en tu código, o registra las respuestas que incluyan `Deprecation`, para encontrar todas las llamadas que tu app sigue haciendo.
>
> > [!NOTE]
> >
> > `verifyUserToken` de `@whop/api` comprueba el encabezado `x-whop-user-token` localmente y nunca llama a la API GraphQL, por lo que sigue funcionando después de la retirada. [Autenticación](https://docs.whop.com/es/developer/guides/authentication.md) explica cómo verificar el token en otros lenguajes.
>
> ### Mapa de operaciones
>
> #### Comprobaciones de acceso
>
> La mayoría de las apps llaman a una de estas en cada carga de página. Las tres corresponden a un único endpoint que recibe el ID de usuario y el ID de la experiencia, el producto o la cuenta.
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `checkIfUserHasAccessToExperience` | `GET /users/{id}/access/{resource_id}` | Pasa un ID `exp_` como `resource_id`. |
> | `checkIfUserHasAccessToAccessPass` | `GET /users/{id}/access/{resource_id}` | Pasa un ID `prod_`. Los pases de acceso ahora se llaman productos. |
> | `checkIfUserHasAccessToCompany` | `GET /users/{id}/access/{resource_id}` | Pasa un ID `biz_`. |
>
> La respuesta tiene `has_access` y `access_level`, que es `customer`, `admin` o `no_access`, los mismos valores que `hasAccess` y `accessLevel` en GraphQL.
>
> #### Chat y mensajes
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `listMessagesFromChat` | `GET /messages` | Pasa el ID de la experiencia de chat como `channel_id`. Consulta [Deja de sondear el chat](#stop-polling-chat). |
> | `sendMessageToChat` | `POST /messages` | Pasa el ID de la experiencia de chat como `channel_id` y el texto como `content`. |
> | `sendDirectMessageToUser` | `POST /channels`, luego `POST /messages` | Crea la conversación con `kind` establecido en `private` y el destinatario en `participant_user_ids`, y luego envía a su ID como `channel_id`. |
> | `listDirectMessageConversations` | `GET /channels` | Pasa `kind=private`. |
>
> #### Usuarios
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `getUser` | `GET /users/{id}` | |
> | `getCurrentUser` | `GET /users/me` | Devuelve el usuario al que pertenece el token. Con una clave de API de app, lee el ID de usuario de `verifyUserToken` y llama a `GET /users/{id}`. |
> | `listUsersForExperience` | `GET /members` | Filtra con `product_ids`. |
>
> #### Experiencias y productos
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `getExperience` | `GET /experiences/{id}` | |
> | `listExperiences` | `GET /experiences` | Filtra con `product_id` o `app_id`. |
> | `getAccessPass` | `GET /products/{id}` | |
> | `listAccessPasses` | `GET /products` | |
> | `listAccessPassesForExperience` | `GET /products` | |
> | `createAccessPass` | `POST /products` | |
> | `updateAccessPass` | `PATCH /products/{id}` | |
> | `deleteAccessPass` | `DELETE /products/{id}` | |
> | `listPlans` | `GET /variants` | Los planes ahora se llaman variantes. Los ID de variante conservan el prefijo `plan_`. |
>
> #### Tu cuenta
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `getCompany` | `GET /accounts/me` | Las empresas ahora se llaman cuentas. |
> | `listMemberships` | `GET /memberships` | |
> | `listMembers`, `getMember` | `GET /members`, `GET /members/{id}` | |
> | `listAuthorizedUsers` | `GET /authorized_users` | |
> | `listWaitlistEntries` | `GET /waitlist_entries` | |
> | `listReceiptsForCompany` | `GET /payments` | |
>
> #### Pagos
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `chargeUser` | `POST /payments` | |
> | `createCheckoutSession` | `POST /checkout_configurations` | Las sesiones de checkout ahora se llaman configuraciones de checkout. La respuesta incluye `purchase_url`. |
> | `payUser` | `POST /transfers` | |
> | `listInvoices`, `getInvoice`, `createInvoice` | `GET /invoices`, `GET /invoices/{id}`, `POST /invoices` | |
> | `listPromoCodes`, `createPromoCode` | `GET /promo_codes`, `POST /promo_codes` | |
> | `listAffiliates`, `createAffiliate` | `GET /affiliates`, `POST /affiliates` | |
>
> #### Archivos y notificaciones
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `uploadMedia`, `processAttachment` | `POST /files`, luego `POST /files/{id}/complete` | |
> | `getAttachment` | `GET /files/{id}` | |
> | `sendPushNotification` | `POST /notifications` | Dirígete a un `experience_id` o a una lista de `user_ids`. |
>
> #### Cursos y foros
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `listCoursesForExperience` | `GET /courses` | Filtra con `experience_id`. |
> | `listCoursesForCompany` | `GET /courses` | Filtra con `account_id`. |
> | `getCourse` | `GET /courses/{id}` | |
> | `getLesson` | `GET /course_lessons/{id}` | |
> | `getUserLessonInteractions` | `GET /course_lesson_interactions` | Filtra con `user_id`, `lesson_id` o `course_id`. |
> | `markLessonAsCompleted` | `POST /course_lessons/{lesson_id}/mark_as_completed` | |
> | `listForumPostsFromForum` | `GET /forum_posts` | Filtra con `experience_id`. |
> | `createForumPost` | `POST /forum_posts` | |
>
> #### Operaciones de webhooks
>
> | Operación GraphQL | API actual | Notas |
> | - | - | - |
> | `listWebhooks`, `getWebhook` | `GET /webhooks`, `GET /webhooks/{id}` | |
> | `createWebhook` | `POST /webhooks` | |
> | `updateWebhook` | `PATCH /webhooks/{id}` | |
> | `deleteWebhook` | `DELETE /webhooks/{id}` | |
> | `testWebhook` | `POST /webhooks/{id}/test` | |
>
> Si una operación que usa tu app no aparece en la lista, busca el recurso en la [referencia de la API](https://docs.whop.com/es/api-reference.md), o contacta con soporte indicando el nombre de la operación.
>
> ### Cambios de comportamiento
>
> #### Deja de sondear el chat
>
> Las apps que reaccionan a mensajes de chat solían llamar a `listMessagesFromChat` con un temporizador. Suscríbete en su lugar al webhook `chat.message.created`: Whop envía cada mensaje nuevo a tu servidor en cuanto se publica, así que no necesitas sondear. Usa `GET /messages` solo para cargar el historial.
>
> #### Nombres de campos
>
> Los campos de la API actual usan `snake_case` (`has_access`, `access_level`) donde GraphQL usaba `camelCase` (`hasAccess`, `accessLevel`). Los ID de recursos conservan sus prefijos, por lo que los ID que almacenaste siguen funcionando.

## Paginación

v2 paginaba con `page` y `per` y devolvía `pagination.current_page` y `pagination.total_page`. Las listas de la API actual devuelven un array `data` y un objeto `page_info`. Pasa `first` para establecer el tamaño de página y `after` con el `page_info.end_cursor` anterior para obtener la página siguiente. Detente cuando `page_info.has_next_page` sea `false`. Los SDK paginan por ti.

```typescript TypeScript theme={null}
for await (const membership of client.memberships.list({ product_id: "prod_xxxxxxxxxxxxx" })) {
  console.log(membership.id);
}
```

```python Python theme={null}
for membership in client.memberships.list(product_id="prod_xxxxxxxxxxxxx"):
    print(membership.id)
```

## Próximos pasos

> [card] [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
>
> Fija una versión para que los cambios posteriores nunca rompan tu integración.

> [card] [Webhooks](https://docs.whop.com/es/developer/guides/webhooks.md)
>
> Verifica firmas, gestiona el formato de eventos actual y recibe mensajes de chat en lugar de sondear.

> [card] [Gestiona membresías](https://docs.whop.com/es/developer/guides/memberships.md)
>
> Cancela, pausa, extiende y actualiza membresías.

> [card] [Vistas de app](https://docs.whop.com/es/developer/guides/app-views.md)
>
> Comprueba el acceso de los miembros en las vistas de experiencia y de panel.


## Related topics

- [Migra desde las facturas heredadas](https://docs.whop.com/es/developer/guides/migrate-from-legacy-invoices.md)
- [Descripción general de la API de Whop](https://docs.whop.com/es/api-reference/overview.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
