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

# Versiones de la API

> Fija tus solicitudes a una versión fechada de la API para que los cambios en la API nunca rompan tu integración.

La API actual se versiona con fechas. Los cambios incompatibles solo se publican dentro de una nueva versión fechada a la que decides adherirte. Fija una versión y las estructuras de solicitud y respuesta con las que construiste nunca cambiarán. Los SDK oficiales envían automáticamente la versión con la que se generaron.

```bash theme={null}
curl https://api.whop.com/api/v1/variants \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-07-23"
```

| Envías | Obtienes |
| - | - |
| `Api-Version-Date: 2026-07-23` | La API tal como funcionaba en esa fecha |
| Sin encabezado, la clave de API tiene una versión fijada | La versión de la API almacenada en la clave de API |
| Sin encabezado ni versión almacenada | El comportamiento original de `2025-01-01` |
| Una fecha desconocida | Un error `400` con las versiones admitidas |

> [!NOTE]
>
> **Si no pasas un `Api-Version-Date` ni tienes una versión fijada almacenada en la clave de API, se usa el modelo de API estable.** Las solicitudes sin ninguno de los dos se atienden con el comportamiento anterior al versionado, por lo que las integraciones existentes siguen funcionando sin cambios. Fija una versión fechada para adoptar la API más reciente.

## Versiones fijadas en las claves de API

Las claves de API llevan su propia versión de API fijada. Las solicitudes autenticadas con una clave de API usan esa versión cuando omiten `Api-Version-Date`. Las claves existentes sin una versión almacenada usan `2025-01-01`. Las claves recién creadas usan la última versión publicada.

Un encabezado `Api-Version-Date` explícito siempre tiene prioridad sobre la versión fijada de la clave de API, por lo que puedes probar una actualización antes de cambiar la versión guardada.

Todas las versiones reciben automáticamente los nuevos endpoints y campos opcionales. Los cambios incompatibles crean una nueva versión fechada, que se enumera en el registro de cambios a continuación.

Al actualizar, revisa todas las entradas posteriores a tu versión fijada actual hasta tu versión de destino, no solo las entradas del mes de destino. En particular, actualizar de `2026-07-20` a septiembre atraviesa la migración de miembros y membresías de `2026-07-23`.

## Registro de cambios

Las versiones del SDK de TypeScript que se indican a continuación usan de forma predeterminada la versión de la API de esa entrada. Sobrescribir `apiVersionDate` cambia la versión de la respuesta, pero no los tipos del SDK.

**2026-11-17**

Un nivel conserva solo su nivel y sus puntos

`level` en [Obtener usuario](https://docs.whop.com/es/api-reference/users/retrieve-user.md) y [Obtener cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account.md) ahora tiene `current`, `points`, `points_by_source` y `resets_at`, además de `account_level` en una cuenta.

Estos campos se eliminan de `level`: `levels`, `points_to_next`, `monthly_qualifying_spend`, `monthly_card_spend`, `monthly_ads_spend` y `monthly_trading_volume`. `boosted` se elimina del `level` de una cuenta. Una cuenta está impulsada cuando su `account_level` es inferior a `current`.

**2026-11-16-2**

El `applied_level` de un nivel ahora es `current`

`level.applied_level` pasa a llamarse `level.current` en [Obtener usuario](https://docs.whop.com/es/api-reference/users/retrieve-user.md) y [Obtener cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account.md). El valor no cambia: el nivel que se aplica, de `0` a `10`.

**2026-11-16-1**

La lista de usuarios referidos deja de responder después del 17 de noviembre

`GET /partners/referred_users` deja de responder después del 17 de noviembre de 2026. A partir del 18 de noviembre, todas las versiones devuelven un `410`. Hasta entonces, cada respuesta incluye los encabezados `Deprecation` y `Sunset`. La lista no tiene reemplazo.

**2026-11-16**

Las solicitudes de atribución a un usuario han terminado

Los partners ya no pueden enviar una solicitud de atribución a un usuario. Esto se aplica a todas las versiones de la API, no solo a esta.

[Crear una solicitud de referencia de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/create-a-partner-referral-request.md) rechaza `target_user_id`, `target_username` y `target_email` con un `400` cuyo `code` es `user_referral_requests_retired`. Envía `account_id` o `account_url` para solicitar la atribución de un negocio. Las solicitudes que se enviaron a un usuario ya no se listan ni se obtienen, el filtro `target_user_id` en [listar solicitudes de referencia de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/list-partner-referral-requests.md) no devuelve solicitudes, y `user` en una solicitud siempre es `null`.

**2026-11-14-1**

El nivel de un usuario es público

[Obtener usuario](https://docs.whop.com/es/api-reference/users/retrieve-user.md) devuelve `level` para cualquier usuario cuyas cuentas estén en Whop Levels, no solo para ti. `level.applied_level` es el nivel del usuario, de `0` a `10`.

Los demás campos de `level`, como `points`, `points_by_source`, los importes `monthly_*` y `levels`, son `null` a menos que te obtengas a ti mismo con el ID reservado `me` y tengas el permiso de lectura de saldo. Comprueba si son `null` antes de leerlos.

**2026-11-14**

Lista y obtén tus propias compras

Con una credencial de usuario, `user_id=me` en [listar pagos](https://docs.whop.com/es/api-reference/payments/list-payments.md) devuelve tus propios pagos. Eso incluye tus compras en todas las cuentas y tus pagos en las cuentas para las que vendes. Añade el `account_id` de una cuenta a la que compraste para listar solo esas compras. [Obtener pago](https://docs.whop.com/es/api-reference/payments/retrieve-payment.md) devuelve un pago que compraste.

Una compra muestra lo que puedes ver como comprador. Los campos del lado de la cuenta, como `amount_after_fees`, `usd_total`, `holds` y `metadata`, son nulos o están vacíos en ella. `amount_charged` indica lo que se te cobró, incluidas las comisiones del comprador.

**2026-11-13-1**

Los miembros del equipo incluyen su cuenta como un objeto

Los miembros del equipo ya no tienen un `account_id` de nivel superior. Lee el ID de la cuenta en `account.id`. El objeto `account` también tiene el `title`, la `route` y el `logo_url` de la cuenta.

**2026-11-13**

La API de leads se retira

Los endpoints `/leads` están obsoletos y ya no aparecen en la referencia de la API. En esta versión y posteriores devuelven un `410`. Las versiones anteriores siguen funcionando hasta el 20 de noviembre de 2026, con los encabezados `Deprecation`, `Sunset` y `Link` de sucesor. Después de esa fecha, todas las versiones devuelven un `410`.

Cada lead también es miembro de su negocio, con el ID del lead en el `metadata` del miembro como `lead_id`. Usa [Listar miembros](https://docs.whop.com/es/api-reference/members/list-members.md) en lugar de listar leads. Añade un miembro por correo electrónico con [Crear miembro](https://docs.whop.com/es/api-reference/members/create-member.md). Lee o actualiza uno con [Obtener miembro](https://docs.whop.com/es/api-reference/members/retrieve-member.md) y [Actualizar miembro](https://docs.whop.com/es/api-reference/members/update-member.md).

**2026-11-12**

La lista de usuarios referidos está obsoleta

`GET /partners/referred_users` está obsoleto y ya no aparece en la referencia de la API. Sigue respondiendo para las integraciones existentes, con un encabezado `Deprecation` en cada respuesta, y no tiene reemplazo.

**2026-11-11**

Las facturas recurrentes incluyen la tarifa inicial

Crear una factura o reemplazar sus artículos cobra el `initial_price` más el `renewal_price` de una variante recurrente en la primera factura. Las facturas de renovación cobran solo el `renewal_price`. Editar otros campos conserva los precios guardados de la factura.

Pagar la primera factura inicia inmediatamente un período de facturación pagado, sin la prueba de la variante. Un número finito de pagos incluye esa factura: una tarifa inicial de $75 con tres cuotas de $40 factura $115, luego $40 y luego \$40.

**2026-11-10-1**

La oferta renovable de Economic Intelligence es `3_days`

SDK de TypeScript: [`@whop/sdk@2.8.0`](https://unpkg.com/@whop/sdk@2.8.0/dist/esm/BaseClient.mjs).

La oferta renovable en `economic_intelligence_offers` de [Obtener preferencias de la cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-preferences.md) ahora tiene la clave `3_days`. Se renueva cada 3 días. Para activarla, envía `economic_intelligence_duration_key: "3_days"` a [Actualizar preferencias de la cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-preferences.md). La clave `weekly` se rechaza.

**2026-11-10**

Las estadísticas de anuncios ya no aceptan `clicks`

El campo `clicks` se elimina de [Crear estadísticas de anuncios](https://docs.whop.com/es/api-reference/ads/create-ad-stats.md). Los `clicks` de una hora son las visitas a la página del anuncio registradas por el píxel de Whop, y un valor de `clicks` enviado en cualquier versión se ignora.

**2026-11-07**

API de chat: canales, miembros y mensajes

Integra el chat en tu app. Los [canales](https://docs.whop.com/es/api-reference/channels/list-channels.md) cubren mensajes directos, chats grupales, chats de comunidad y chats de soporte. Los [miembros del canal](https://docs.whop.com/es/api-reference/channel-members/list-channel-members.md) añaden y eliminan personas. Los [mensajes](https://docs.whop.com/es/api-reference/messages/list-messages.md) se pueden enviar, editar, fijar, recibir reacciones y votos.

`/messages` cambia de estructura a partir de esta versión. Un mensaje tiene `channel_id` y `author` en lugar de `user`, y `edited` y `pinned` en lugar de `is_edited` y `is_pinned`. Fija con `POST /messages/{id}/pin` y `/unpin` en lugar de una actualización. [Eliminar mensaje](https://docs.whop.com/es/api-reference/messages/delete-message.md) devuelve `204`. Reacciona y vota con `POST /messages/{id}/react`, `/unreact` y `/vote`.

**2026-11-06**

El tipo de línea de libro mayor `bank_transfer` se retira

Los depósitos bancarios de Iron son líneas de [actividad del libro mayor](https://docs.whop.com/es/api-reference/ledgers/ledger-activity) con `line_type` `onchain_deposit`, y su `source.sender_address` es `iron`. El filtro `line_types` de la actividad financiera y de los informes financieros ya no acepta `bank_transfer`.

**2026-11-05-1**

Las listas de pagos salientes incluyen la Whop Card

[Listar métodos de pago saliente guardados](https://docs.whop.com/es/api-reference/payouts/list-saved-payout-methods.md) incluye la Whop Card de la cuenta. [Listar pagos salientes](https://docs.whop.com/es/api-reference/payouts/list-payouts.md) incluye los pagos salientes que movieron fondos a ella. Un método de pago saliente guardado, y el `payout_method` de un [pago saliente](https://docs.whop.com/es/api-reference/payouts/payout), tiene un `type`. `external` envía fondos fuera de Whop. `whop_card` mueve fondos a la propia Whop Card de la cuenta. Excluye los métodos `whop_card` de una lista en la que un usuario elige dónde retirar.

**2026-11-05**

Una presentación de disputa en curso reporta `generating_response`

Una [disputa](https://docs.whop.com/es/api-reference/disputes/dispute) cuya evidencia está con el procesador de pagos y aún no ha sido aceptada reporta `generating_response` en lugar de `under_review`. Cuando el procesador la acepta, la disputa pasa a `under_review`. Cuando el procesador la rechaza, la disputa vuelve a `needs_response`, y al obtenerla se devuelve `submission_failure_reason`. Ambos cambios se envían como `dispute.updated`.

**2026-11-04-1**

Whop Levels: el nivel aplicado es `applied_level`

En el `level` de un [usuario](https://docs.whop.com/es/api-reference/users/user) y de una [cuenta](https://docs.whop.com/es/api-reference/accounts/account), `current` ahora es `applied_level`, y se elimina `processing_rate_percentage`. Lee el porcentaje estándar de procesamiento con tarjeta de un nivel en su entrada de `levels`, y la tarifa propia de una cuenta en [Obtener comisiones de la cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-fees.md). El `level` de una cuenta también añade `account_level`, el nivel que alcanzan sus propios puntos.

**2026-11-04**

Se eliminan las certificaciones de publicidad

Whop ya no ofrece certificaciones de publicidad. [Obtener preferencias de la cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-preferences.md) y [Actualizar preferencias de la cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-preferences.md) ya no devuelven `ads_certifications`, y una actualización ya no lo acepta.

**2026-11-03-1**

Las cuentas conectadas ahora son subcuentas

Las cuentas hijas de la plataforma se llaman subcuentas. En [Listar pagos](https://docs.whop.com/es/api-reference/payments/list-payments.md) y [Listar disputas](https://docs.whop.com/es/api-reference/disputes/list-disputes.md), y en sus endpoints de resumen, `include_connected_accounts` ahora es `include_subaccounts`. En [Actualizar preferencias de la cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-preferences.md), `covers_connected_account_negative_balances` ahora es `covers_subaccount_negative_balances` tanto en la respuesta como en el cuerpo de la actualización. Las filas de informes financieros que usaban la agrupación `connected_accounts` ahora usan `subaccounts`.

**2026-11-03**

Las solicitudes de pago saliente requieren una cotización

[Crear un pago saliente](https://docs.whop.com/es/api-reference/payouts/create-payout.md) ahora requiere `quote_token`. Primero llama a `POST /payouts/quotes` y luego envía su token con los mismos detalles del pago saliente antes de que caduque la cotización. Las cotizaciones ausentes o no válidas devuelven `400` con `invalid_payout_quote`. Al reintentar un pago saliente incierto, reenvía el token original y la `Idempotency-Key` para que el pago saliente existente pueda recuperarse incluso después de que caduque su cotización.

**2026-11-02-1**

El cliente de una factura no puede cambiar después de crear el borrador

En [Actualizar factura](https://docs.whop.com/es/api-reference/invoices/update-invoice.md), un `member_id` que difiere del cliente actual del borrador devuelve un `400`, incluido `null`. Para facturar a otra persona, primero [anula el borrador](https://docs.whop.com/es/api-reference/invoices/void-invoice.md). Después, [crea una nueva factura](https://docs.whop.com/es/api-reference/invoices/create-invoice.md). Un borrador guardado sin cliente todavía puede recibir uno.

**2026-11-02**

Se eliminan las conexiones de Snapchat

[Conectar una cuenta externa](https://docs.whop.com/es/api-reference/external-accounts/connect-an-external-account.md) ya no acepta `snapchat`, la última plataforma que usaba el permiso `advertise`, por lo que su campo `scopes` también desaparece. Enviar `snapchat` o cualquier `scopes` devuelve un `400`.

**2026-10-30**

Las campañas publicitarias eliminan bid\_type

Las campañas publicitarias ya no aceptan ni devuelven `bid_type`. Cada red publicitaria elige su propia puja de campaña, y `desired_cost_per_result` es tu objetivo en todas las redes: nunca cambia cómo pujan los anuncios. Enviar `bid_type` devuelve un `400`.

**2026-10-29-8**

Se eliminan las conexiones de publicidad

Los anuncios se publican bajo las propias páginas y perfiles de Whop, por lo que ya no conectas cuentas para publicidad. [Conectar una cuenta externa](https://docs.whop.com/es/api-reference/external-accounts/connect-an-external-account.md) ya no acepta `meta_business`, y `tiktok` ya no acepta el permiso `advertise`. Enviar cualquiera de ellos devuelve un `400`.

**2026-10-29-5**

Se eliminan las reglas de valor de conversión

Se eliminan las reglas de valor de conversión, y las redes publicitarias reciben el valor original de cada conversión. Listar las reglas de valor de conversión está obsoleto: devuelve una lista vacía, ya no está documentado y sus respuestas incluyen un encabezado `Deprecation`. Todos los demás endpoints de reglas de valor de conversión devuelven un `410`.

**2026-10-29-4**

Las audiencias eliminan las reglas de interacción, y los destinos de reglas eliminan platform

Las audiencias ya no se pueden crear a partir de la interacción en redes sociales. Las audiencias de interacción existentes siguen apareciendo con `source_type` `engagement`, pero ya no devuelven `engagement`. Enviar `engagement`, o `engagement` como `source_type`, a [Crear audiencia](https://docs.whop.com/es/api-reference/audiences/create-audience.md) devuelve un `400`. Los destinos de las reglas de valor de conversión ya no aceptan ni devuelven `platform`. Cada destino cubre todas las redes en las que Whop lo ejecuta, y enviar `platform` en un destino devuelve un `400`.

**2026-10-29-3**

Los partners de cuentas externas están obsoletos

Los anuncios de colaboración ya no están disponibles. Listar los partners de una cuenta externa devuelve una lista vacía. Añadir o eliminar un partner devuelve un `400`. Estos endpoints ya no están documentados, y sus respuestas incluyen un encabezado `Deprecation`.

**2026-10-29-2**

Las duplicaciones eliminan preserve\_engagement, y las listas de publicaciones y formularios de leads están obsoletas

Duplicar una campaña publicitaria, un grupo de anuncios o un anuncio ya no acepta `preserve_engagement`. Enviarlo a [Duplicar una campaña publicitaria](https://docs.whop.com/es/api-reference/ad-campaigns/duplicate-an-ad-campaign.md), [Duplicar un grupo de anuncios](https://docs.whop.com/es/api-reference/ad-groups/duplicate-an-ad-group.md) o [Duplicar un anuncio](https://docs.whop.com/es/api-reference/ads/duplicate-an-ad.md) devuelve un `400`. Listar las publicaciones o los formularios de leads de una cuenta externa está obsoleto: ambos devuelven una lista vacía, ya no están documentados y sus respuestas incluyen un encabezado `Deprecation`.

**2026-10-29-1**

Los anuncios eliminan post\_id, y la búsqueda de segmentación está obsoleta

Los anuncios ya no devuelven `post_id`. Buscar opciones de segmentación de grupos de anuncios y estimar el alcance de grupos de anuncios está obsoleto: ambos siguen funcionando, pero ya no están documentados y sus respuestas incluyen un encabezado `Deprecation`. Un destino de regla de valor de conversión puede omitir `platform` para cubrir todas las redes en las que Whop lo ejecuta.

**2026-10-29**

Los anuncios eliminan los campos específicos de red y el objetivo de reconocimiento

Las campañas publicitarias, los grupos de anuncios y los anuncios ya no devuelven `platform`, y [Crear una campaña publicitaria](https://docs.whop.com/es/api-reference/ad-campaigns/create-an-ad-campaign.md) ya no lo acepta. Las nuevas campañas no pueden usar el objetivo `awareness`. Las campañas de reconocimiento existentes siguen devolviéndolo. Los anuncios ya no aceptan ni devuelven `existing_post_id`, `post_source`, `external_accounts` ni `translations`, y ya no devuelven `post_thumbnail_url`. Enviar un campo eliminado, o `awareness` como objetivo, a [Crear una campaña publicitaria](https://docs.whop.com/es/api-reference/ad-campaigns/create-an-ad-campaign.md), [Crear anuncio](https://docs.whop.com/es/api-reference/ads/create-an-ad.md) o [Actualizar anuncio](https://docs.whop.com/es/api-reference/ads/update-an-ad.md) devuelve un `400`.

**2026-10-28-1**

Los anuncios eliminan los campos avanzados de entrega y de creatividades

Las campañas publicitarias ya no devuelven `optimization_goal`. Los grupos de anuncios ya no aceptan ni devuelven `optimization_goal`, `conversion_location`, `message_apps`, `minimum_daily_spend`, `dynamic_creative`, `placements`, `frequency_cap` ni `detailed_targeting`, y Whop establece la entrega a partir del `objective` de la campaña. Los anuncios ya no aceptan ni devuelven `messaging_config`, `multi_advertiser_ads`, `lead_form`, `lead_form_id` ni `music`. Enviar cualquiera de estos a [Crear grupo de anuncios](https://docs.whop.com/es/api-reference/ad-groups/create-an-ad-group.md), [Actualizar grupo de anuncios](https://docs.whop.com/es/api-reference/ad-groups/update-an-ad-group.md), [Crear anuncio](https://docs.whop.com/es/api-reference/ads/create-an-ad.md) o [Actualizar anuncio](https://docs.whop.com/es/api-reference/ads/update-an-ad.md) devuelve un `400` que nombra el campo.

**2026-10-28**

Las listas de variantes de la cuenta excluyen las variantes de facturas heredadas

[Listar variantes](https://docs.whop.com/es/api-reference/variants/list-variants.md) con `account_id` excluye las variantes generadas para una factura heredada, incluida una cuya factura se eliminó después. Para leer una, [obtén la variante](https://docs.whop.com/es/api-reference/variants/retrieve-variant.md) por ID. La lista obsoleta `GET /plans` se comporta de la misma manera.

**2026-10-27-3**

Los swaps rechazan un importe superior al saldo de la billetera

En [Crear swap](https://docs.whop.com/es/api-reference/swaps/create-swap.md), un `amount` decimal superior al saldo de `from_token` de la billetera devuelve un `400`. El error indica el saldo disponible. Las versiones anteriores inician el swap, que luego falla en la cadena. La comprobación se omite cuando no se puede leer el saldo. USDT no se comprueba, ya que un swap de USDT también puede usar el saldo de la tarjeta.

**2026-10-27-2**

Todos los demás recursos llaman variantes a las variantes

**Membresías, miembros y entradas de lista de espera.** En las membresías y las entradas de lista de espera, `plan_id` ahora es `variant_id`, y en la variante incrustada en una entrada de lista de espera, `plan_type` ahora es `billing_type`. [Invitar a una membresía](https://docs.whop.com/es/api-reference/memberships/invite-to-a-membership.md) y [Crear entrada de lista de espera](https://docs.whop.com/es/api-reference/waitlist-entries/create-waitlist-entry.md) aceptan `variant_id`, y [Aprobar todas las entradas de lista de espera](https://docs.whop.com/es/api-reference/waitlist-entries/approve-all-waitlist-entries.md) acepta y devuelve `variant_id`. [Listar membresías](https://docs.whop.com/es/api-reference/memberships/list-memberships.md) filtra con `variant_id` y `variant_ids`, [Listar miembros](https://docs.whop.com/es/api-reference/members/list-members.md) con `variant_ids`, y [Listar entradas de lista de espera](https://docs.whop.com/es/api-reference/waitlist-entries/list-waitlist-entries.md) con `variant_id`, en lugar de `plan_id` y `plan_ids`.

**Pagos, facturas y disputas.** En los pagos, las disputas y los casos del Resolution Center, `plan_id` ahora es `variant_id`, y en sus `line_items`, `plan_id` y `plan_title` ahora son `variant_id` y `variant_title`. En los `line_items` de cotizaciones de pago y facturas, `plan_id` ahora es `variant_id`. [Listar pagos](https://docs.whop.com/es/api-reference/payments/list-payments.md) filtra con `variant_ids` en lugar de `plan_ids`. [Crear pago](https://docs.whop.com/es/api-reference/payments/create-payment.md) y [Crear cotización de pago](https://docs.whop.com/es/api-reference/payment-quotes/create-payment-quote.md) aceptan `variant_id` y `variant` en lugar de `plan_id` y `plan`, en el cuerpo y en cada entrada de `line_items`. Crear y actualizar una factura aceptan `variant_id` y `variant` en lugar de `plan_id` y `plan` en cada entrada de `items`. Una `variant` en línea acepta `billing_type` en lugar de `plan_type`. En los eventos, `related.plan` ahora es `related.variant`.

**Checkout.** En las configuraciones de checkout, `plan` ahora es `variant`, y su `plan_type` ahora es `billing_type`. [Crear configuración de checkout](https://docs.whop.com/es/api-reference/checkout-configurations/create-a-checkout-configuration.md) acepta `variant_id` en lugar de `plan_id` y una `variant` en línea (con `billing_type`) en lugar de `plan`, y [Listar configuraciones de checkout](https://docs.whop.com/es/api-reference/checkout-configurations/list-checkout-configurations.md) filtra con `variant_id`. Las solicitudes y respuestas de sesiones de checkout usan `items[].variant` en lugar de `items[].plan`.

**Códigos promocionales y partners.** [Listar códigos promocionales](https://docs.whop.com/es/api-reference/promo-codes/list-promo-codes.md) filtra con `variant_ids` en lugar de `plan_ids`, y [Crear código promocional](https://docs.whop.com/es/api-reference/promo-codes/create-promo-code.md) acepta `variant_ids`.

**2026-10-27-1**

Los productos y las variantes llaman variantes a las variantes

En los productos, `default_plan` ahora es `default_variant`. En las variantes, y en las variantes incrustadas en un producto, `plan_type` ahora es `billing_type`. [Crear variante](https://docs.whop.com/es/api-reference/variants/create-variant.md) acepta `billing_type`, y [Listar variantes](https://docs.whop.com/es/api-reference/variants/list-variants.md) y [Listar productos](https://docs.whop.com/es/api-reference/products/list-products.md) filtran con `billing_types` en lugar de `plan_types`.

Usa `/variants` y el espacio de nombres `variants` del SDK en lugar de `/plans`. Los endpoints `/plans` siguen respondiendo en todas las versiones, con los encabezados `Deprecation` y `Link` de sucesor. Para previsualizar impuestos, crea una [cotización de pago](https://docs.whop.com/es/api-reference/payment-quotes/create-payment-quote.md) en lugar de llamar a `POST /variants/{id}/calculate_tax` o `POST /plans/{id}/calculate_tax`, que están obsoletos de la misma manera.

Los ID de variante conservan el prefijo `plan_`, y los permisos `plan:*` y los nombres de eventos de webhook `plan.*` no cambian.

**2026-10-27**

Las invitaciones devuelven el miembro del equipo pendiente

Cuando [Crear miembro del equipo](https://docs.whop.com/es/api-reference/team-members/create-team-member.md) envía una invitación en lugar de añadir al miembro, la respuesta `202` ahora es el miembro del equipo pendiente. Su `status` es `pending` y su ID empieza por `ausri_`. La respuesta ya no incluye `object` ni `invitation_sent`.

**2026-10-24**

Facturas respaldadas por recibos

La API nativa de facturas usa ID `pay_` y `items` respaldados por variantes, incluida la creación de variantes en línea. Crear guarda un borrador. Puedes actualizar borradores y anular un borrador que ya no necesites. El cliente facturado es un miembro. Un correo electrónico que no pertenece a un usuario de Whop crea uno. `recipient_emails` son las direcciones de entrega propias de la factura, independientes del miembro facturado. La comisión del comprador es un porcentaje ajustable.

**2026-10-15-1**

Las cuentas ya no incluyen stablecoin\_rails

Las cuentas ya no incluyen `stablecoin_rails`.

**2026-10-15**

Los tipos de documento de verificación están en minúsculas

En [Crear verificación](https://docs.whop.com/es/api-reference/verifications/create-verification.md), y en los propietarios de `owners`, `document_type` acepta valores en minúsculas: `passport`, `id_card`, `drivers` o `residence_permit`. La guía de [documentos de identidad](https://docs.whop.com/es/developer/verification/identity-documents.md) indica cuáles acepta cada país.

**2026-10-14-1**

El cargo con tarjeta del depósito se movió dentro de methods

En [Crear depósito](https://docs.whop.com/es/api-reference/deposits/create-deposit.md), el cargo a un método de pago guardado se movió del `card` de nivel superior a `methods.card`, junto a `bank` y `crypto`. Sus campos no cambian, y sigue siendo `null` a menos que se haya pasado `payment_method_id`. Quienes llaman con una versión anterior fijada conservan el `card` de nivel superior.

**2026-10-14**

Los dominios de métodos de pago están obsoletos en favor de los dominios

Los endpoints de dominios de métodos de pago están obsoletos y ya no aparecen en la referencia de la API. Añade, comprueba y elimina dominios de Apple Pay con la capacidad `apple_pay` de la API de [dominios](https://docs.whop.com/es/api-reference/domains/domain):

* `GET /payment_method_domains`: `GET /domains` con `apple_pay=any`, o `apple_pay=ready` para dominios verificados. Filtra por nombre de host con `domain` en lugar de `hostname`.
* `GET /payment_method_domains/{id}`: `GET /domains/{id}`.
* `POST /payment_method_domains`: `POST /domains` con `domain`, `account_id` y `apple_pay: {}`. Si la cuenta ya tiene el dominio, `PATCH /domains/{id}` con `apple_pay: {}`.
* `POST /payment_method_domains/{id}/verify`: `POST /domains/{id}/check`.
* `DELETE /payment_method_domains/{id}`: `PATCH /domains/{id}` con `apple_pay: null`. `DELETE /domains/{id}` elimina todo el dominio, incluido cualquier sitio web que tenga.
* `status: verified` equivale a `apple_pay.state: ready`. `status: pending` equivale a `apple_pay.state: pending` mientras Whop registra el dominio, o a `action_required` hasta que alojes el archivo de asociación y compruebes el dominio.

El registro se ejecuta en segundo plano, por lo que crear o comprobar un dominio devuelve `pending`. Obtén el dominio hasta que `apple_pay.state` sea `ready` o `action_required`.

Los endpoints `/payment_method_domains` siguen respondiendo en todas las versiones, con los encabezados `Deprecation` y `Link` de sucesor. Un dominio conserva su ID, por lo que `/domains/{id}` acepta el ID que devolvió un dominio de método de pago. La API de dominios necesita los permisos `domain:read` y `domain:manage` en lugar de `company:manage_checkout`.

**2026-10-13-1**

Reseñas nativas

SDK de TypeScript: [`@whop/sdk@2.5.0`](https://unpkg.com/@whop/sdk@2.5.0/dist/esm/BaseClient.mjs).

Las reseñas ahora usan un recurso nativo.

* Listar y obtener reseñas devuelve solo las reseñas publicadas. Obtener una reseña pendiente o eliminada devuelve `404`.
* Una reseña obtenida devuelve `account` en lugar de `company`.
* Listar reseñas filtra por `account_id` o `product_id`, ordena con `order` y `direction`, y devuelve 20 reseñas por página de forma predeterminada. Sin un filtro, un usuario lista las reseñas que escribió y una clave de API de cuenta o de app lista las reseñas de su cuenta.
* `company_id` ya no se acepta. Usa `account_id`.
* `DELETE /reviews/{id}` elimina una reseña que escribió el usuario que ha iniciado sesión y requiere el permiso `review:delete`.

**2026-10-13**

Las cuentas ya no tienen grupo de industria, y la clasificación de la cuenta es de solo lectura

Las cuentas ya no incluyen `industry_group`, y `PATCH /accounts/{id}` ya no lo acepta. `business_type` e `industry_type` clasifican una cuenta.

La clasificación de la cuenta es de solo lectura. Whop establece `business_type` e `industry_type`, y `PATCH /accounts/{id}` ya no los acepta.

**2026-10-09-2**

Las apps ya no listan las URL alojadas anteriores

SDK de TypeScript: [`@whop/sdk@2.4.0`](https://unpkg.com/@whop/sdk@2.4.0/dist/esm/BaseClient.mjs).

Las apps ya no incluyen `previous_hosted_urls`. Las direcciones de una app son los dominios que la sirven: lístalos con `GET /domains`, o lee `domains` en la app.

**2026-10-09-1**

Perfiles, importes y tipos de creación de transferencias

Las transferencias devuelven perfiles `origin` y `destination` con `name` y `logo_url`. Los objetos monetarios `amount` y `fee` contienen el crédito del destinatario y todas las comisiones de transferencia. Las respuestas también incluyen las marcas de tiempo de fallo disponibles y una URL de seguimiento. Los importes históricos y tiempos de transición desconocidos son `null`.

Sin filtros de cuenta, `GET /transfers` lista las transferencias de las cuentas permitidas del llamador y de su billetera personal. Las credenciales limitadas a una cuenta siguen restringidas a su cuenta.

`POST /transfers` requiere `type`, ya sea `balance` o `claim_link`. Las solicitudes sin él devuelven `400`. El tipo `ledger` pasa a llamarse `balance`, y se elimina `wallet_send`. Las versiones anteriores aceptan `ledger` y `wallet_send`, y crean una transferencia `balance` cuando se omite `type`.

**2026-10-09**

Genera el PDF del recibo de un pago

Los pagos ya no incluyen `pdf_url`. Para obtener el recibo de un pago en PDF, llama a `POST /payments/{id}/generate_pdf`. Devuelve una `url` para descargar el archivo y el `expires_at` en el que ese enlace deja de funcionar.

**2026-10-08**

Los fondos pendientes pueden estar a la espera de una revisión de cumplimiento

SDK de TypeScript: [`@whop/sdk@2.3.0`](https://unpkg.com/@whop/sdk@2.3.0/dist/esm/BaseClient.mjs).

El `payment_controls.undated_pending_reason` de una cuenta puede ser `compliance_review`. Significa que una verificación que el comerciante ya envió está en revisión, por lo que los fondos pendientes siguen pendientes hasta que se resuelva. Quienes llaman con una versión anterior fijada ven `null` para este estado.

**2026-10-07-2**

Economic Intelligence puede renovarse cada semana

`economic_intelligence_offers` incluye una oferta `weekly` que se renueva cada semana hasta que se desactiva. Cada oferta tiene `auto_renew`, y `weekly` es la oferta recomendada. Para activarla, envía `economic_intelligence_duration_key: "weekly"` a `PATCH /accounts/{account_id}/preferences`.

`economic_intelligence_offers` lista solo lo que la cuenta puede elegir en este momento. Ya no es `null` mientras Economic Intelligence está activo: durante un período comprometido lista solo `weekly`, como mejora, y mientras `weekly` se está renovando está vacío. Las versiones anteriores mantienen `null` mientras Economic Intelligence está activo, omiten `weekly` y recomiendan `1_day`.

**2026-10-07-1**

Los pagos con tarjeta guardada consideran presente al comprador de forma predeterminada

Un cargo a un método de pago guardado (`member_id` y `payment_method_id`) con una `return_url` ahora considera que el comprador está presente. Esto se aplica cuando omites `off_session`. Si el emisor pide al comprador que se autentique, el pago queda en `requires_action` con una `next_action`. Cuando cobras la tarjeta sin el comprador, como una renovación según tu propio calendario, pasa `off_session: true`.

**2026-10-07**

Los destinatarios de pago de facturas ya no necesitan cuentas de Whop

Crear un método de pago saliente con `recipient` crea una cuenta de pago saliente de destinatario no predeterminada vinculada al libro mayor del remitente. No crea ningún usuario de Whop, cuenta de Whop ni libro mayor del destinatario. La respuesta del destinatario contiene `first_name`, `last_name` y `country`. Ya no contiene `user_id`. Las versiones anteriores de la API omiten los datos del destinatario cuando no hay un usuario de Whop. Las versiones anteriores conservan el ID de usuario para los destinatarios existentes.

**2026-10-06-2**

Las compilaciones de apps ya no aceptan un prompt de IA

Crear una compilación de app ya no acepta `ai_prompt_id`.

**2026-10-06-1**

La serie temporal de una métrica tiene su propia ruta

Obtén la serie temporal de una métrica en `GET /stats/time_series/{metric}`. `GET /stats/{metric}` todavía la sirve e indica el sucesor en un encabezado `Deprecation`.

**2026-10-06**

Las cuentas sociales son cuentas externas

Las cuentas sociales ahora son cuentas externas. Usa `/external_accounts` y el espacio de nombres `externalAccounts` del SDK. Los antiguos endpoints `/social_accounts` siguen respondiendo en todas las versiones, con los encabezados `Deprecation` y `Link` de sucesor. Los ID de cuentas externas conservan su prefijo `sacc_`, y los permisos `social_account:*` no cambian.

Los anuncios llaman a sus cuentas `external_accounts` en lugar de `social_accounts` tanto en las solicitudes como en las respuestas. Las reglas de interacción de audiencias llaman a su cuenta `external_account_id` en lugar de `social_account_id`. En `/external_accounts`, la página propietaria de una cuenta de Instagram es `parent_external_account` en lugar de `parent_social_account`. Los webhooks de anuncios sin una versión de API fijada reciben `external_accounts`.

**2026-10-05-1**

Los usuarios ya no incluyen cuentas sociales

Los usuarios ya no devuelven `social_accounts`.

**2026-10-05**

Los setup intents se guardan en segundo plano

Crear un setup intent ahora lo devuelve como `processing` y guarda el método de pago en segundo plano. Crear un pago ya funciona así. Para conocer el resultado, consulta periódicamente el setup intent o pasa su `client_secret` a `handleNextAction`. Termina guardado, rechazado o a la espera de un paso del comprador. Las versiones anteriores siguen guardándolo durante la solicitud.

**2026-09-29**

Las disputas prevenidas reportan prevented

SDK de TypeScript: [`@whop/sdk@2.1.0`](https://unpkg.com/@whop/sdk@2.1.0/dist/esm/BaseClient.mjs), [`@whop/sdk@2.2.0`](https://unpkg.com/@whop/sdk@2.2.0/dist/esm/BaseClient.mjs).

Una disputa por la que se reembolsó al cliente antes de cualquier resolución ahora tiene `status: prevented` en lugar de `closed`. El reembolso provino de la red de tarjetas (Visa RDR) o de un reembolso anterior.

**2026-09-28**

Las ejecuciones de Economic Intelligence tienen sus propios estados

Una recomendación que Whop AI está llevando a cabo tiene `status: running`. Cuando la ejecución termina pasa a `executed`, o a `incomplete` si terminó sin llevar a cabo la recomendación. Las versiones anteriores muestran una recomendación en ejecución como `ready` y una incompleta como `superseded`.

Las recomendaciones también devuelven `run_started_at`, `run_ended_at`, `run_by_user_id`, `result_url` y `acknowledged_at`. Para ejecutar una recomendación tú mismo, envía `status: running` a `PATCH /economic_intelligence/{id}` y luego `status: executed` (con una `result_url` opcional) o `status: incomplete`. Envía `status: acknowledged` para marcar una ejecución completada como vista. La recomendación permanece en `executed` y registra `acknowledged_at`.

**2026-09-25**

Las duraciones de Economic Intelligence se eligen por clave

Para activar Economic Intelligence, envía `economic_intelligence_duration_key` a `PATCH /accounts/{account_id}/preferences` en lugar de `economic_intelligence_duration_days`. Usa la `key` de una entrada de `economic_intelligence_offers`.

Cada entrada de `economic_intelligence_offers` tiene `key`, `duration` y `duration_unit` en lugar de `duration_days`. Una duración se puede contar en `hours` o `days`.

**2026-09-24-1**

El texto de los anuncios lleva etiqueta de idioma, y los anuncios de Meta pueden publicarse en otros idiomas

Los `primary_texts`, `headlines` y `descriptions` de un anuncio son arrays de objetos `{ language, text }` en las solicitudes y respuestas. En un anuncio sin traducciones, omite `language`. La API rechaza cadenas simples, así que envía `[{ "text": "…" }]` en su lugar.

Un anuncio de Meta también puede publicarse en otros idiomas. Establece `translations: { source_language, automatic_languages }` con el idioma del texto propio del anuncio y los idiomas a los que Meta traduce automáticamente. Cada entrada de texto y de `creatives` de ese anuncio indica entonces su `language`. El texto y la creatividad propios del anuncio usan `source_language`, y cada idioma que escribas tú mismo recibe una entrada de `primary_texts` y otra de `headlines`, además de entradas opcionales de `descriptions` y `creatives`. `translations: null` desactiva los demás idiomas.

Las versiones anteriores de la API no pueden actualizar un anuncio que tenga traducciones. Reciben un 400 que indica esta versión.

**2026-09-24**

Economic Intelligence se activa durante un período elegido

Para activar Economic Intelligence, envía `economic_intelligence_duration_days` a `PATCH /accounts/{account_id}/preferences`. Elige una duración de `economic_intelligence_offers`, que lista la tarifa de cada duración. Economic Intelligence no se puede cambiar ni desactivar hasta `economic_intelligence_ends_at`, y se desactiva automáticamente en ese momento.

`economic_intelligence` es de solo lectura. Enviarlo devuelve un error `400`.

**2026-09-23**

El acceso al trading aparece en las comprobaciones de permisos

SDK de TypeScript: [`@whop/sdk@2.0.0`](https://unpkg.com/@whop/sdk@2.0.0/dist/esm/BaseClient.mjs).

`GET /permissions` incluye `crypto_wallet:trade` y `crypto_wallet:trade:read` al listar o comprobar acciones de permisos para una cuenta.

**2026-09-22-4**

Descripciones de operaciones de Economic Intelligence

Las recomendaciones de Economic Intelligence devuelven `expected_tool_calls` como un array ordenado de objetos con `tool_name` y `description`. Las descripciones identifican la acción planificada y el recurso afectado. Las recomendaciones más antiguas tienen una descripción `null`.

**2026-09-22-3**

Los enlaces de referencia de partners usan un único tipo de solicitud

Las solicitudes de referencia de partners usan `request_type: "link"` para enlaces con o sin recompensas. Usa `link` al crear o filtrar enlaces. Solo el personal autorizado puede configurar recompensas.

**2026-09-22-2**

Las recompensas de la cuenta muestran el progreso de las recompensas de partners

Obtener cuenta devuelve los hitos de recompensas de partners en `rewards`. Cada hito incluye el progreso de calificación y el estado del pago para esa cuenta. El campo contiene un array vacío cuando no hay recompensas coincidentes o cuando el llamador no tiene acceso de lectura al saldo o a las estadísticas.

El formato heredado de recompensas de incorporación se retira. Las versiones anteriores de la API omiten `rewards` de las respuestas de cuenta.

**2026-09-22-1**

Los setup intents pasan a ser un recurso nativo

La API nativa de pagos ahora sirve `POST /setup_intents`, `GET /setup_intents` y `GET /setup_intents/{id}`. El objeto Setup Intent adopta la estructura de todos los demás recursos nativos.

* Los registros relacionados son ID de clave foránea en lugar de objetos incrustados: `account_id` (antes `company`), `member_id` (antes `member`), `payment_method_id` (antes `payment_method`) y `checkout_configuration_id` (antes `checkout_configuration`). El comprador es un resumen de `user` (`id`, `username`, `name`, `profile_picture`).
* `error_message` pasa a `last_setup_error`, el mismo bloque `{ code, message }` que devuelve Obtener estado de configuración. Permanece en `null` hasta que algo falla, y desaparece una vez que la configuración se completa correctamente.
* `return_url`, `payment_method_type` y `updated_at` son nuevos. `created_at` y `updated_at` son marcas de tiempo ISO 8601.
* `payment_instrument`, el método con formato de visualización que ya incluye el objeto Payment, también está en el Setup Intent, de modo que una tarjeta guardada se muestra sin una segunda solicitud. Su `card` añade `exp_month` y `exp_year` en ambos recursos. `card.brand` puede ser `null`: una tarjeta guardada cuya red no registró la bóveda conserva sus últimos cuatro dígitos y su vencimiento en lugar de perder todo el objeto `card`.
* Crear un setup intent responde `201 Created` (antes `200`), respeta `Idempotency-Key` y requiere exactamente uno de `confirmation_token` o `payment_method_id`. Un token de confirmación de otra cuenta devuelve `404`.
* `client_secret` se devuelve al crear y al obtener, y solo para configuraciones creadas a través de esta API. Requiere un llamador que pueda actuar sobre la configuración: la credencial `payment:charge` de la cuenta o el propio token del comprador. Las filas de lista siempre incluyen `null`.
* Los webhooks `setup_intent.requires_action`, `setup_intent.succeeded` y `setup_intent.canceled` fijados en esta versión o posterior entregan este mismo objeto Setup Intent como su `data`. Los webhooks fijados antes, y los webhooks sin versión fijada, conservan el payload anterior.
* `GET /setup_intents` lista con el envoltorio estándar `{ data, page_info }` y paginación por cursor. `account_id` es opcional: una clave de API de cuenta lista su propia cuenta, y un token de usuario lista todas las cuentas que puede leer. `status` es un nuevo filtro, y un valor no válido devuelve `400`. `created_before` y `created_after` funcionan como antes.

**2026-09-22**

Los reintentos de pago de anuncios usan el endpoint de cuenta

`POST /ad_campaigns/{id}/retry_payment` devuelve `410 Gone`. Usa `POST /accounts/{id}/retry_ads_payment` con el ID `biz_` de la cuenta para poner en cola un reintento de pago para todas sus campañas. Un reintento aceptado no confirma que el pago se haya realizado correctamente. Revisa el `delivery_status` y los `issues` de la campaña para conocer el resultado.

**2026-09-15**

Tres políticas distintas de 3D Secure

SDK de TypeScript: [`@whop/sdk@1.1.5`](https://unpkg.com/@whop/sdk@1.1.5/dist/esm/BaseClient.mjs).

Las cuentas, las variantes, las configuraciones de checkout y las sesiones de checkout exponen tres opciones de 3D Secure:

* `mandate_challenge` solicita un desafío antes de procesar un pago con tarjeta compatible en sesión.
* `mandate_if_required` exige un desafío solo cuando lo requiere el procesador de pagos.
* `frictionless_if_required` usa el flujo 3DS sin fricción habitual.

Los pagos de \$1,000 o más usan al menos `mandate_if_required`. Los requisitos de riesgo y de recuperación de autenticación pueden anular la preferencia. Los desafíos obligatorios explícitos se rechazan hasta que se habilitan en la plataforma.

Las versiones anteriores de la API conservan sus valores existentes: las nuevas selecciones de `mandate_challenge` siguen siendo condicionales, las preferencias obligatorias existentes se conservan y `frictionless` sigue siendo `frictionless`. Las cuentas en versiones anteriores representan la opción sin fricción como `null`.

**2026-09-13**

Las transferencias de trading tienen categorías propias en los informes financieros

Las filas de los informes financieros distinguen `trading_account_deposit`, `trading_account_withdrawal` y sus entradas `_offset` de otras transferencias en cadena. Los importes y saldos no cambian.

Las versiones anteriores conservan las categorías existentes: `topup` para los depósitos de cuenta y `onchain_withdrawal` para los retiros de cuenta. Los informes globales usan las categorías correspondientes `onchain_deposit`, `onchain_withdrawal` y `_offset`. Las filas coincidentes se combinan sin perder los importes transferidos.

**2026-09-11-1**

Estado de Triple Whale renombrado para comerciantes de marca blanca

`ads_triple_whale_integration.status` de las preferencias de la cuenta reporta `requires_shop_domain` en lugar de `requires_shopify_store`. Ahora se puede establecer un `shop_domain` explícitamente en la integración, por lo que una tienda de Shopify conectada ya no es la única forma de proporcionarlo.

**2026-09-11**

Las categorías de negocio provienen de una única tabla

SDK de TypeScript: [`@whop/sdk@1.1.4`](https://unpkg.com/@whop/sdk@1.1.4/dist/esm/BaseClient.mjs).

Los campos `business_type`, `industry_group` e `industry_type` de la cuenta son cadenas tomadas de la tabla de categorías de negocio de Whop en lugar de enums fijos. Las nuevas categorías aparecen sin una nueva versión de la API. El [glosario de tipos de negocio e industrias](https://docs.whop.com/es/api-reference/accounts/business-types.md) lista los valores actuales.

* `coaching_and_courses` ahora es `education`, `physical_product` ahora es `ecommerce` y `marketplace` ahora es `platform`.
* Los grupos y tipos de industria se reorganizaron bajo los ocho tipos de negocio. `PATCH /accounts/{id}` solo acepta los slugs del glosario. Los valores desconocidos devuelven `400`.

Quienes llaman con una versión anterior fijada siguen recibiendo los nombres de tipo de negocio anteriores, y los valores de industria que no existían antes de esta versión se devuelven como `null`.

**2026-09-09-1**

Experimentos propiedad de la cuenta

Crear un experimento requiere un `account_id` propietario, con prefijo `biz_`. Los experimentos también aceptan referencias opcionales a recursos y claves de flags locales a la cuenta. Listar devuelve los experimentos de una cuenta, y leerlos o gestionarlos requiere permisos de cuenta. Los experimentos de cuenta no admiten etiquetas de equipo ni aprovisionan un proveedor de informes.

La evaluación identifica al sujeto mediante `subject[account_id]`, `subject[anonymous_id]` y `subject[user_id]`. Quienes llaman con versiones anteriores conservan sus parámetros de identidad de evaluación existentes. Pasa las `properties` de segmentación como un valor de consulta JSON. Las claves de consulta de propiedades anidadas existentes siguen siendo compatibles. La exposición acepta credenciales opcionales y registra su identidad en el evento.

**2026-09-09**

Retenciones de retiro de Whop identificadas en los fondos pendientes

SDK de TypeScript: [`@whop/sdk@1.1.3`](https://unpkg.com/@whop/sdk@1.1.3/dist/esm/BaseClient.mjs).

El `payment_controls.undated_pending_reason` de la cuenta puede ser `withdrawals_disabled` cuando Whop ha bloqueado los retiros, por lo que esos fondos pendientes no pueden pasar a estar disponibles.

`kyc_incomplete`, `pending_information_request` y `null` para los fondos que aún se están liquidando no cambian.

**2026-09-06**

Fuentes de audiencias por interacción

`POST /audiences` admite la interacción con videos, formularios de leads, perfiles de Instagram y páginas de Facebook mediante una definición tipada de `engagement`.

* Los valores explícitos de `source_type` validan que los campos de origen requeridos estén presentes y que los campos de origen en conflicto estén ausentes.
* Las respuestas de audiencias incluyen `engagement`, y `source_type` puede ser `engagement`. Las audiencias de interacción también se pueden usar como fuentes de audiencias similares.
* `GET /social_accounts/{id}/posts` incluye `video_id` y `caption` para ayudar a seleccionar videos sin tener que buscar manualmente sus identificadores de plataforma.

**2026-09-04**

Finalizar un experimento requiere conclusiones

`POST /experiments/{id}/end` requiere `findings` en el cuerpo de la solicitud: una breve explicación de lo que se aprendió y de por qué el experimento terminó como terminó.

Quienes llaman con una versión anterior fijada aún pueden omitirlo. En lugar de un `400`, se registra un valor de conclusiones provisional en su nombre.

**2026-09-02-2**

Los destinos de depósito son un ID de cuenta

SDK de TypeScript: [`@whop/sdk@1.1.1`](https://unpkg.com/@whop/sdk@1.1.1/dist/esm/BaseClient.mjs), [`@whop/sdk@1.1.2`](https://unpkg.com/@whop/sdk@1.1.2/dist/esm/BaseClient.mjs).

`POST /deposits` acepta una cadena de ID de cuenta `destination` (`biz_…` o `user_…`) y nada más.

* Ya no se aceptan direcciones de billetera sin procesar. Financia una cuenta y lee sus direcciones en `methods.crypto`.
* Se elimina la forma de objeto de `destination` (`{ account_id }` / `{ address, network }`). Envía solo el ID de cuenta.
* Se elimina la sobrescritura `network` de nivel superior. Nunca cambió la respuesta: cada depósito ya devuelve una dirección para cada red compatible, así que elige la que quieras en `methods.crypto`.
* `metadata` se elimina tanto de la solicitud como de la respuesta. Se devolvía tal cual y nunca se almacenaba, por lo que no se podía usar para conciliar un depósito posterior.
* `account_id` en la respuesta ya no es nulo, porque cada destino ahora indica una cuenta.

Quienes llaman con una versión anterior fijada siguen enviando la forma de objeto y las entradas eliminadas, y sus respuestas siguen incluyendo `metadata`, como un objeto vacío en lugar del valor que enviaron. Una dirección de billetera se rechaza en todas las versiones: nunca identificó una cuenta, por lo que no hay una estructura anterior que mantener. `metadata` enviado con un `payment_method_id` se conserva en todas las versiones, porque se adjunta al cargo con tarjeta.

**2026-09-02-1**

Los pagos pasan a ser un recurso nativo

SDK de TypeScript: [`@whop/sdk@1.1.0`](https://unpkg.com/@whop/sdk@1.1.0/dist/esm/BaseClient.mjs).

`POST /payments`, `GET /payments` y `GET /payments/{id}` ahora los sirve la API nativa de pagos, y el objeto Payment adopta la estructura de todos los demás recursos nativos.

* Los registros relacionados son ID de clave foránea en lugar de objetos incrustados: `account_id` (antes `company`), `plan_id`, `product_id`, `membership_id`, `member_id`, `promo_code_id`, `shipment_id`, `payment_method_id`. El comprador es un resumen de `user` (`id`, `username`, `name`, `profile_picture`).
* Los importes son objetos monetarios (`{ amount, currency, decimals, display_decimals }`) en lugar de números simples: `total`, `subtotal`, `tax_amount`, `refunded_amount`, `tax_refunded_amount`, `amount_after_fees`, `usd_total`. `settlement_amount`, `settlement_currency` y `settlement_exchange_rate` se integran en `total` y `currency`. `refunded_amount` y `tax_refunded_amount` se expresan tal como se liquidaron, al tipo vigente cuando se emitió cada reembolso, y `tax_refunded_amount` ahora aparece tanto en las respuestas de lista como en las de obtención.
* Las disputas, los reembolsos y los casos del Resolution Center ya no están incrustados: lístalos desde sus propios endpoints con `?payment_id=`. Las transacciones de financiación incrustadas y la comisión de aplicación no se trasladan a la estructura nativa.
* `last_payment_attempt` / `next_payment_attempt` pasan a ser `last_payment_attempt_at` / `next_payment_attempt_at`. Los datos de la tarjeta están en `payment_instrument`.
* Crear un pago acepta `account_id` (antes `company_id`), responde `201 Created`, respeta `Idempotency-Key` y acepta `capture: false` para realizar una retención de autorización.
* Las lecturas de pagos nativas están limitadas a la cuenta: la credencial debe poder leer los pagos de la cuenta (el token de un miembro del equipo o la clave de API de la cuenta). El token de usuario propio de un comprador, que las versiones proxy fijadas aceptan para leer su propio pago, todavía no se sirve de forma nativa; los compradores siguen funcionando en su versión fijada.
* Las filas de `GET /payments/{id}/fees` son `{ type, origin, label, description, amount, settlement_amount, collected_at }` con objetos monetarios (antes `name`/`amount`/`currency`/`type`).
* `GET /refunds` y `GET /refunds/{id}` devuelven el Refund nativo: `payment_id` y `account_id` en lugar de un pago incrustado, `amount` como objeto monetario en la moneda de liquidación del pago y `original_amount` en la moneda del procesador. El filtro `company_id` pasa a ser `account_id`, y enviar `company_id` devuelve un 400.
* `POST /payments/{id}/refund`, `POST /payments/{id}/retry` y `POST /payments/{id}/void` también son nativos y devuelven el mismo objeto Payment. El reembolso sigue aceptando un `partial_amount` opcional.
* `GET /payments` lista con el envoltorio estándar `{ data, page_info }` y paginación por cursor. Los filtros son parámetros de igualdad en singular (`status`, `billing_reason`, `currency`, `plan_id`, `product_id`, `membership_id`, `member_id`, `user_id`, `account_id`) en lugar de los arrays en plural del proxy. Al igual que en el proxy, `billing_reason=subscription_cycle` también coincide con las renovaciones registradas como `subscription_update`. Se incluyen los pagos de importe cero, por lo que desaparece el `include_free` del proxy. Un `status` no válido devuelve un `400`, al igual que cualquier filtro exclusivo del proxy (`substatuses`, `updated_before`/`updated_after`, `checkout_configuration_ids`, arrays en plural), en lugar de una página sin filtrar. La búsqueda de compradores `query` funciona como antes. La ventana `created_before`/`created_after` cubre solo la hora de creación del pago. El proxy filtraba por la fecha de pago cuando existía. En las filas de lista, `settlement_time_at` es nulo; obtén el pago para consultarlo.

**2026-09-02**

Se retira el endpoint heredado de informes de anuncios

El endpoint heredado `GET /ad_reports` está obsoleto en favor de las métricas nativas de [Stats](https://docs.whop.com/es/api-reference/stats/stats) y los endpoints de entidades de anuncios. Ya no se sirve en esta versión.

* `GET /ad_reports` devuelve `410 Gone` con un `error.type` de `gone`. Usa `GET /stats/time_series/ad_delivery` para `spend`, `impressions` y `clicks` a lo largo del tiempo, limitado con una ruta `source` como `whop:adcamp_xxx:*`. Usa `GET /stats/time_series/events` para las conversiones atribuidas.
* El rendimiento por entidad para una ventana está en los endpoints de entidades. `GET /ad_campaigns`, `GET /ad_groups` y `GET /ads` aceptan `stats_from` y `stats_to` y devuelven `spend`, `results` y `return_on_ad_spend` en cada fila.
* Cada respuesta del endpoint heredado, en cualquier versión, ahora incluye los encabezados `Deprecation` y `Link: <…/stats/ad_delivery>; rel="successor-version"`. Las solicitudes fijadas a versiones anteriores, y las solicitudes sin versión, siguen funcionando sin cambios hasta que un encabezado `Sunset` anuncie la fecha en que deja de responder para todas las versiones.

**2026-08-31**

Rangos de marcas de tiempo en los informes financieros

`GET /financial_reports` y `GET /financial_reports/breakdown` ahora usan marcas de tiempo ISO 8601 `from` y `to` para las ventanas de los informes.

* `from_date` y `to_date` pasan a llamarse `from` y `to`.
* Ya no se aceptan fechas sin hora. Incluye una hora y un desplazamiento en ambas marcas de tiempo.

**2026-08-25-2**

Filtrado explícito por verificación de apps

`GET /apps` ahora usa `verified` como filtro de igualdad opcional en lugar de tratar su ausencia como `verified=false` para las listas públicas de sitios web.

* Omite `verified` para devolver plantillas de sitios web públicamente visibles de ambos estados de verificación.
* Establece `verified=true` para plantillas verificadas por Whop o `verified=false` para plantillas de la comunidad.
* `recommended=true` filtra las apps recomendadas independientemente del estado de verificación.

**2026-08-25-1**

Se retiran los endpoints heredados de retiros

Los endpoints heredados `/withdrawals` están obsoletos en favor de la API nativa de [pagos salientes](https://docs.whop.com/es/api-reference/payouts/payout) y ya no se sirven en esta versión.

* `GET /withdrawals` y `POST /withdrawals` devuelven `410 Gone` con un `error.type` de `gone`. Usa `GET /payouts` y `POST /payouts` en su lugar. Los ID de pagos salientes son los mismos ID `wdrl_`, por lo que los identificadores existentes se siguen resolviendo.
* `GET /withdrawals/{id}` sigue respondiendo en esta versión. Usa `GET /payouts/{id}` para el trabajo nuevo.
* Cada respuesta de los endpoints heredados, en cualquier versión, ahora incluye los encabezados `Deprecation` y `Link: <…/payouts>; rel="successor-version"`. Un encabezado `Sunset` anunciará la fecha en que dejarán de responder para todas las versiones. Hasta entonces, las solicitudes fijadas a versiones anteriores, y las solicitudes sin versión, siguen funcionando sin cambios.

**2026-08-25**

ID de publicaciones de anuncios

El `post_id` de un anuncio ahora indica la publicación que sirve la red publicitaria, sin importar cómo se haya creado el anuncio.

* `post_id` devuelve la publicación de la red para el anuncio: la que Meta creó para una creatividad subida, o la publicación que se promociona. Antes era `null` para todos los anuncios creados a partir de creatividades subidas.
* La publicación a la que apuntas un anuncio se movió a `existing_post_id`, tanto en la respuesta como en el cuerpo de creación/actualización. `post_source` y `post_thumbnail_url` describen ese campo.

**2026-08-21-1**

API nativa de archivos

SDK de TypeScript: [`@whop/sdk@1.0.14`](https://unpkg.com/@whop/sdk@1.0.14/dist/esm/BaseClient.mjs).

`POST /files` y `GET /files/{id}` se sirven de forma nativa con un objeto de archivo rediseñado, y las subidas multiparte finalizan mediante el nuevo `POST /files/{id}/complete`.

* Las respuestas de archivos incluyen el envoltorio estándar: `object`, `visibility` y un `created_at` ISO 8601. Los campos `size` y `url` son `null` hasta que la subida está en `ready`.
* `GET /files/{id}` solo resuelve los archivos que creaste; otros llamadores reciben un 404.

**2026-08-21**

Estado de pagos salientes v2

SDK de TypeScript: [`@whop/sdk@1.0.13`](https://unpkg.com/@whop/sdk@1.0.13/dist/esm/BaseClient.mjs).

El vocabulario del ciclo de vida del objeto de pago saliente se reconstruye y sus campos monetarios pasan a ser cadenas decimales.

* `status` usa ocho palabras: `requested`, `in_review`, `processing`, `completed`, `reversed`, `canceled`, `failed`, `denied`. Un pago saliente liquidado que el proveedor revierte muestra `reversed`, con el código de devolución y `funds_returned_at` en `failure`.
* Un nuevo campo `status_detail` incluye la fase de máquina más detallada bajo la palabra de estado. Sus valores pueden crecer sin un cambio de versión; `status` es el contrato versionado.
* `amount`, `fee_amount`, `net_amount`, `markup_fee` y `destination_amount` son cadenas decimales. `exchange_rate` sigue siendo un número.
* Los pagos salientes se crean con su ID `wdrl_`: el ID que devuelve `POST /payouts` es el ID que lista `GET /payouts`, y la solicitud de conversión de un pago saliente se conserva como `payout_request_id`. Las solicitudes de conversión creadas antes de esta versión siguen respondiendo con su ID `cofr_`.
* La clave de idempotencia se envía solo en el encabezado `Idempotency-Key`, y el campo `idempotency_key` del cuerpo se rechaza.

Las solicitudes fijadas a versiones anteriores conservan el vocabulario anterior, los importes en coma flotante y las claves de idempotencia en el cuerpo. Los payloads de webhooks siguen el `api_version_date` de la suscripción de la misma manera: las suscripciones fijadas en `2026-08-21` o posterior reciben la nueva estructura de pago saliente, y las suscripciones anteriores o sin versión fijada conservan la anterior.

**2026-08-14**

account\_id en el envoltorio de webhooks

El campo `company_id` del envoltorio de webhooks pasa a llamarse `account_id`.

* Las entregas de webhooks fijadas en `2026-08-14` o posterior incluyen `account_id` en el envoltorio.
* Los webhooks fijados a versiones anteriores, y los webhooks sin una versión `api_version_date` fijada, conservan `company_id`.

**2026-08-13**

Desgloses del saldo en tránsito

SDK de TypeScript: [`@whop/sdk@1.0.11`](https://unpkg.com/@whop/sdk@1.0.11/dist/esm/BaseClient.mjs).

Los desgloses de saldo de la cuenta y personales ahora exponen `in_transit` junto a `pending`.

* Suma `pending` e `in_transit` para mostrar el importe total pendiente de liquidación.
* Quienes llaman con versiones anteriores fijadas siguen recibiendo el importe combinado en `pending`.

**2026-08-12**

Se elimina la entrada de versión de API de los webhooks

Se elimina la entrada `api_version` en `POST /webhooks` y `PATCH /webhooks/{id}`.

* Los nuevos webhooks siempre usan los eventos y payloads `v1`. Las solicitudes que pasan `api_version` se rechazan con un `400`.
* Fija la estructura del payload de un webhook con `api_version_date` en su lugar.
* Los webhooks `v2` y `v5` existentes siguen entregando. Ya no puedes crear webhooks ni cambiarlos a estas versiones.

**2026-08-10**

Endpoints nativos de alertas de disputas

Las alertas de disputas ahora son un recurso REST nativo y siguen sirviéndose también a través del proxy heredado.

* `GET /dispute_alerts` lista las alertas de una cuenta con paginación por cursor, y filtra por `account_id`, `payment_id`, `type` y una ventana de creación.
* `type` reemplaza a `alert_type` e indica los dos tipos que envía un emisor: `early_fraud_warning` (informes de fraude Visa TC40 / Mastercard SAFE) y `dispute_alert` (avisos previos a la disputa).
* `fee_charged` reemplaza a `charge_for_alert` e indica si Whop realmente cobró a la cuenta. Las advertencias tempranas de fraude nunca se cobran.
* `actionable` indica si reembolsar el pago todavía puede evitar un contracargo.
* Los objetos `payment` y `dispute` se reemplazan por las etiquetas `payment_id` y `account_id`. Las marcas de tiempo son ISO 8601, con `reported_at` para cuando el emisor presentó el informe.

**2026-08-05-1**

Conversión de moneda fiduciaria en los swaps

Los swaps de pares fiduciarios (`POST /swaps` con dos monedas fiduciarias) ahora admiten la conversión de moneda libre, y `amount` coincide con la semántica de los swaps de criptomonedas.

* `amount` es el importe de `from_token` que se convierte al tipo de mercado medio. No se requiere un saldo negativo.
* El cálculo de un reembolso parcial de un saldo negativo de `to_token` se movió al nuevo campo `to_amount` (expresado en `to_token`, con un límite igual a la deuda). `amount` y `to_amount` son mutuamente excluyentes.
* Omitir ambos sigue reembolsando el saldo negativo completo de `to_token`.
* Quienes llaman con versiones anteriores fijadas conservan el comportamiento anterior: su `amount` fiduciario se trata como el importe de reembolso de `to_token`.

**2026-08-05**

Requisitos de verificación planos

El `requested_information` de una verificación ahora es una lista plana: un requisito por entrada, una escritura por respuesta.

* Cada entrada indica lo que se necesita en `requirement`: un documento como `bank_statement`, o una clave de campo como `ssn`, con una `label` para mostrar al usuario.
* Responde a las entradas `file` con `file` (un ID de subida directa). Responde a las entradas `text`, `date`, `phone` y `select` con `value`, y a las entradas `address` con `address`. No se devuelve nada de la respuesta.
* Una entrada marcada como `multiple` acepta varios archivos en una sola respuesta, en el orden de los espacios, con el anverso primero para un documento de dos caras.
* Una entrada que lista `options` también acepta un `value`. Para las entradas `select`, las opciones son las respuestas permitidas. Para los documentos de identidad, las opciones son los tipos de identificación aceptados.
* Las claves que no se aplican se omiten, y los envíos rechazados incluyen `errors` estructurados con un `code` estable y un `reason`.
* La estructura de formulario anidada `requested_files`/`category` desaparece en esta versión. Quienes llaman con versiones anteriores fijadas la conservan, y sus respuestas se traducen automáticamente.

**2026-08-03**

Endpoints nativos de códigos promocionales

Los códigos promocionales ahora son un recurso REST de nivel superior completo y siguen sirviéndose también a través del proxy heredado.

* `GET /promo_codes` lista los códigos promocionales de una cuenta y usa `account_id` en lugar de `company_id`.
* `POST /promo_codes` crea códigos promocionales. `GET` y `DELETE /promo_codes/{id}` los obtienen y archivan.
* `POST /promo_codes/{id}/activate` y `POST /promo_codes/{id}/deactivate` reemplazan la escritura de estado heredada con `PATCH`.
* Las respuestas de lista usan paginación por cursor y admiten filtros por estado, producto, variante, marca de tiempo y ordenación.
* Quienes llaman con versiones anteriores fijadas conservan sin cambios el contrato del proxy heredado.

**2026-07-31**

Cuentas principales más completas

Las respuestas de cuenta ahora exponen una relación más completa con la cuenta principal para las cuentas conectadas.

* `parent_account` reemplaza a `parent_account_id`.
* La cuenta principal incluye su `id`, `title`, `route` y `logo_url`.

**2026-07-29-1**

Métodos de pago saliente compatibles

Los métodos de pago saliente compatibles ahora tienen su propio endpoint paginado.

* `GET /payouts/supported_methods` lista los métodos de pago saliente que una cuenta o un usuario puede añadir.
* Los métodos compatibles usan `object: "supported_payout_method"`, y sus ID `podst_` se pasan como `supported_payout_method_id`.
* Los métodos de pago saliente guardados exponen `supported_payout_method`. Los pagos salientes exponen `payout_method.supported_payout_method`.
* Usa `country` para listar los métodos compatibles de un país distinto al país de la cuenta de pago saliente.
* `GET /payouts/methods` ya no acepta `include_available` ni devuelve `available_destinations`.
* Quienes llaman con versiones anteriores fijadas conservan `destination_id`, `payout_destination` y `payout_token`.

**2026-07-29**

Transacciones de tarjeta nativas, estimaciones de llegada de los métodos de pago saliente

Las transacciones de tarjeta ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.

* `GET /card_transactions` lista las transacciones de tarjeta de una cuenta, y `GET /card_transactions/{id}` obtiene una por su ID `citx_`. La lista también acepta un filtro `transaction_ids` para obtener transacciones específicas en una sola solicitud.
* Las transacciones de tarjeta están limitadas a la cuenta: el propietario se selecciona con `account_id`, que de forma predeterminada es la cuenta a la que pertenece la credencial.
* Filtra por `transaction_ids`, `card_id`, `cardholder_id`, `status`, `created_after` y `created_before`. Los filtros de marca de tiempo son ISO 8601.
* `cardholder_id` es nuevo en la respuesta: el usuario al que está asignada la tarjeta.

Los métodos de pago saliente ahora incluyen condiciones de comisión y entrega independientes del importe, y la cotización ya no duplica las estimaciones de llegada.

* Cada método de pago saliente devuelve `fee_structure` (porcentaje, importe fijo y moneda) y `estimated_arrival` (marcas de tiempo por velocidad) sin requerir un `amount`.
* Los objetos `standard` e `instant` de la cotización ya no incluyen `estimated_arrival`. Léelo en el campo `estimated_arrival` de nivel superior del método.

**2026-07-27**

Endpoints nativos del Resolution Center

Los casos del Resolution Center ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.

* `status`, `escalated`, `outcome`, `refund`, `reason` y `available_actions` exponen el estado del caso y las acciones permitidas.
* Los eventos están disponibles en `GET /resolution_center_cases/{id}/events`, con paginación. Los resúmenes están disponibles en `GET /resolution_center_cases/summary`.
* Las escrituras usan `message` y `attachments`. `due_date` pasa a llamarse `response_due_at`. Listar ya no requiere `account_id`.

**2026-07-26**

Endpoints nativos de envíos

Los envíos ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.

* `GET /shipments` lista los envíos. `GET /shipments/{id}` obtiene uno por ID de envío o ID de pago.
* `POST /shipments` crea un envío, y `PATCH /shipments/{id}` actualiza su número de seguimiento.
* Las respuestas usan `account_id` y `tracking_number`, junto con `carrier`, `tracking_url`, `order_id` y `payment_id`.
* Quienes llaman con una versión fijada anterior a esta fecha conservan sin cambios el contrato del proxy heredado.

**2026-07-25**

Endpoints nativos de disputas

Las disputas ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.

* `PATCH /disputes/{id}` edita la evidencia, y `POST /disputes/{id}/submit` la envía. La evidencia está anidada bajo `evidence`.
* `GET /disputes/summary` proporciona totales agrupados por `status` y `currency`. Listar y obtener devuelven los mismos campos.
* Las respuestas usan `account_id`, `product_id` y `plan_id`, además de `buyer` junto a `payment`. Listar ya no requiere `account_id`.
* `status` y `reason` son enums normalizados, y `needs_response_by`, `rdr` y `editable` se reemplazan por sus nuevos campos.
* Quienes llaman con una versión fijada anterior a esta fecha conservan sin cambios el contrato del proxy heredado.

**2026-07-23**

Miembros y membresías

Los miembros y las membresías ahora usan recursos nativos con un modelo de membresía orientado a la cuenta y acciones de ciclo de vida rediseñadas.

* Las respuestas de membresía devuelven los campos de compatibilidad `plan_id` y `product_id` en lugar de los objetos de compatibilidad anidados `plan` y `product`.
* Listar membresías devuelve todo lo que el llamador puede leer (las suyas más las de sus cuentas gestionadas), y `account_id`/`user_id` acotan esa lista en lugar de cambiar de modo o devolver un error.
* Establece `cancel_at_period_end` para programar la cancelación. La acción `cancel` finaliza el acceso inmediatamente.
* La acción `extend` reemplaza a `add_free_days`.

**2026-07-22**

Coherencia de respuestas REST y marcas de tiempo

La API actual ahora usa respuestas de eliminación, entradas de marca de tiempo y nomenclatura de Account coherentes.

* Los endpoints de eliminación de productos, variantes, configuraciones de checkout, anuncios, grupos de anuncios, campañas publicitarias, cuentas sociales y envíos de recompensas devuelven `{ id, deleted: true }` en lugar de un booleano simple.
* Los filtros de marca de tiempo de productos, variantes, configuraciones de checkout, transferencias e informes financieros aceptan solo ISO 8601 en lugar de aceptar también segundos epoch.
* Las respuestas de productos devuelven `account` en lugar de `company`.

**2026-07-20**

Porcentajes de pago de negocios partner

Los negocios partner ahora exponen tasas de pago independientes para cada fuente de ingresos.

* `payout_percentage` se reemplaza por `payout_percentages`.
* El objeto anidado incluye las tasas `sales`, `ad_spend`, `transfer` y `card_interchange`.

**2026-07-18**

Productos y configuraciones de checkout

Los productos y las configuraciones de checkout ahora usan el modelo Account de forma coherente.

* Los parámetros de solicitud de productos usan `account_id` en lugar de `company_id`.
* Las solicitudes de configuración de checkout usan `account_id` en el nivel superior y dentro de los objetos de variante en línea incluidos en el campo de compatibilidad `plan`.
* Las respuestas de configuración de checkout devuelven `account_id` en lugar de `company_id`.

**2026-07-08-1**

Marcas de tiempo de las configuraciones de checkout

Las marcas de tiempo de las configuraciones de checkout ahora usan el mismo formato que el resto de la API.

* `created_at` y `updated_at` son cadenas ISO 8601 en lugar de enteros epoch de Unix.

**2026-07-08**

Saldos de usuario

Los saldos de usuario ahora proporcionan un resumen de saldo completo y estructurado.

* Los campos planos `total_usd` y `balances` se reemplazan por un objeto `balance` anidado.
* El resumen separa el efectivo, las criptomonedas, los depósitos de tesorería en curso y los saldos de las cuentas que posee el usuario.

**2026-07-01**

Recursos de ganancias por referencias de negocios

Las ganancias por referencias de negocios ahora identifican el recurso polimórfico que generó la ganancia.

* `receipt` se reemplaza por `resource`.
* `access_pass` se reemplaza por `product`.
* Las ganancias respaldadas por recibos devuelven `resource.object: "receipt"` con los detalles de pago del recibo.
* El campo `resource` puede admitir recursos de ganancias adicionales en futuras versiones sin reutilizar campos específicos de recibos.

**2026-06-20**

Recurso de referencias de negocios

El volumen y las ganancias por referencias de negocios ahora se reportan como grupos conciliables.

* `processing_volume`, `total_earnings`, `pending_payout` y `completed_payout` se reemplazan por los objetos anidados `volume_usd` y `earnings_usd`.
* Las ganancias cambian el nombre de `base_amount`/`amount` a `transaction_amount_usd`/`commission_amount_usd` y expresan `payout_percentage` como una fracción.

**2026-06-09**

Recurso de variantes (entonces llamadas Plans)

Las variantes, que entonces se llamaban Plans, ahora usan el modelo Account de forma coherente.

* Los parámetros y cuerpos de solicitud usan `account_id` en lugar de `company_id`.
* Las respuestas de variantes devuelven `account` en lugar de `company`.

**2026-06-08**

Recurso de usuarios

Las solicitudes de acceso de usuarios ahora usan el modelo Account de forma coherente.

* Los parámetros y cuerpos de solicitud usan `account_id` en lugar de `company_id`.
* Las estructuras de respuesta no cambian.

**2025-01-01**

Versión original

El comportamiento original de la API actual antes de que existiera el versionado por fechas.

Las solicitudes sin `Api-Version-Date` usan esta versión para que las integraciones existentes sigan funcionando.


## Related topics

- [API de Products](https://docs.whop.com/es/api-reference/products/product.md)
- [Migra desde versiones anteriores](https://docs.whop.com/es/developer/api/migrate-from-previous-versions.md)
- [API de Verifications](https://docs.whop.com/es/api-reference/verifications/verification.md)
