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

# Descripción general de la API de Whop

> Cómo funcionan las solicitudes a la API de Whop, con un mapa de cada recurso y dónde está documentado.

La API actual es la forma de mover dinero de manera programática. Acepta pagos con enlaces de checkout, mantén saldos, envía retiros, emite tarjetas, transfiere fondos entre cuentas y gestiona los productos y variantes que vendes. Hazlo todo desde tu servidor con una sola API key.

## Hacer una solicitud

La URL base es `https://api.whop.com/api/v1`. Autentica cada solicitud con una API key de tipo Bearer:

```bash theme={null}
curl https://api.whop.com/api/v1/accounts/me \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

```json theme={null}
{
	"id": "biz_XXXXXXXX",
	"title": "Acme Studio",
	"route": "acme-studio",
	"status": "approved"
}
```

Si eres nuevo, el [Quickstart](https://docs.whop.com/es/developer/quickstart.md) te lleva desde [crear una clave](https://whop.com/dashboard/developer) hasta un enlace de checkout activo en unos cinco minutos. Si estás migrando una integración desde la API v2 o la API pública de GraphQL, empieza por [Migrar desde versiones anteriores](https://docs.whop.com/es/developer/api/migrate-from-previous-versions.md).

## Cómo funcionan las solicitudes

### Autenticación

[Crea una API key aquí](https://whop.com/dashboard/developer) en **Account API Keys**. Las claves pertenecen a una cuenta y llevan los permisos que les concedas. Mantén las claves en tu servidor, nunca en código del navegador, apps móviles o repositorios públicos.

### Versionado

Whop versiona la API por fecha. Envía un encabezado `Api-Version-Date`, como `2026-07-01`, para fijar la forma de tus solicitudes y respuestas. Los cambios posteriores no romperán a un cliente con la versión fijada. Cuando omites el encabezado, las solicitudes usan las formas originales de `2025-01-01`. Los SDK generados siempre envían la última versión disponible cuando Whop los compiló. Consulta [Versionado](https://docs.whop.com/es/developer/api/versioning.md).

### Paginación

Los endpoints de lista devuelven un array `data` más un objeto `page_info`. Pasa `first` para elegir el tamaño de página. Pasa `after` con el `page_info.end_cursor` de la respuesta anterior para obtener la página siguiente. `page_info.has_next_page` te indica cuándo parar.

Las listas que lo admiten aceptan `include_total_count=true` y devuelven el número de resultados coincidentes en `page_info.total_count`. Los recuentos se detienen en 10,000 (`total_count_capped: true`) y son `null` si el recuento falla. Añade `first=0` para obtener solo el recuento.

### Errores

Las solicitudes fallidas devuelven un estado HTTP convencional (`400`, `401`, `403`, `404`) y un cuerpo con un único objeto `error`: `type` es un código legible por máquina y `message` explica qué salió mal.

```json theme={null}
{
	"error": {
		"type": "invalid_parameters",
		"message": "initial_price must be greater than 0"
	}
}
```

## Dónde está cada cosa

Esta referencia cubre la API actual. Estos recursos están documentados en la [referencia de la API Legacy](https://docs.whop.com/es/api-reference/payments/payment):

* Cobros: [Payments](https://docs.whop.com/es/api-reference/payments/payment), [Refunds](https://docs.whop.com/es/api-reference/refunds/refund), [Invoices](https://docs.whop.com/es/api-reference/legacy/invoices/legacy-invoice.md), [Payment methods](https://docs.whop.com/es/api-reference/legacy/payment-methods/payment-method.md)
* Contenido y comunidad: [Courses](https://docs.whop.com/es/api-reference/legacy/courses/course.md), [Forums](https://docs.whop.com/es/api-reference/legacy/forums/forum.md), [Messages](https://docs.whop.com/es/api-reference/legacy/messages/message.md)
* Crecimiento: [Affiliates](https://docs.whop.com/es/api-reference/legacy/affiliates/affiliate.md), [Reviews](https://docs.whop.com/es/api-reference/legacy/reviews/review.md)

Usa el selector de API en la parte superior de la barra lateral para cambiar entre referencias.

## Recursos

### Recursos principales

Las cuentas y las personas de las que depende todo lo demás.

| Recurso | Para qué sirve |
| - | - |
| [Accounts](https://docs.whop.com/es/api-reference/accounts/account) | Un negocio en Whop: perfil, billetera, capacidades, configuración. |
| [Users](https://docs.whop.com/es/api-reference/users/user) | Una persona en Whop: perfil e identidades conectadas. |
| [Members](https://docs.whop.com/es/api-reference/members/member) | La relación de un comprador con una cuenta, en todas sus compras. |
| [Team Members](https://docs.whop.com/es/api-reference/team-members/team-member) | Los miembros del equipo de una cuenta y los roles que delimitan su acceso. |
| [Search](https://docs.whop.com/es/api-reference/search/search) | Encuentra los miembros, pagos y otros registros de una cuenta en una sola llamada, por ID, correo electrónico, tarjeta, teléfono, número, enlace o texto. |
| [External Accounts](https://docs.whop.com/es/api-reference/external-accounts/external-account) | Cuentas en otras plataformas vinculadas a una cuenta o usuario. |
| [Social Accounts](https://docs.whop.com/es/api-reference/social-accounts/social-account) | Endpoints de compatibilidad obsoletos para cuentas externas. |

### Pagos

Acepta pagos de compradores y gestiona lo que viene después.

| Recurso | Para qué sirve |
| - | - |
| [Payments](https://docs.whop.com/es/api-reference/payments/payment) | Un cargo a un comprador y el paso que aún le queda por hacer. |
| [Invoices](https://docs.whop.com/es/api-reference/invoices/invoice) | Una solicitud de pago que mantiene el mismo recibo desde el borrador hasta el cobro. |
| [Confirmation Tokens](https://docs.whop.com/es/api-reference/confirmation-tokens/confirmation-token) | Una referencia de corta duración a los datos de pago recopilados de un comprador. |
| [Payment Quotes](https://docs.whop.com/es/api-reference/payment-quotes/payment-quote) | Una compra cotizada antes de pagarse: sus líneas, código promocional e impuestos. |
| [Setup Intents](https://docs.whop.com/es/api-reference/setup-intents/setup-intent) | Guardar el método de pago de un comprador sin cobrarle. |
| [Refunds](https://docs.whop.com/es/api-reference/refunds/refund) | Dinero devuelto a un comprador a partir de un pago. |
| [Resolution Center Cases](https://docs.whop.com/es/api-reference/resolution-center-cases/resolution-center-case) | Abre o responde a un caso contra un pago, como comprador o como comerciante. |
| [Dispute Alerts](https://docs.whop.com/es/api-reference/dispute-alerts/dispute-alert) | Advertencias del emisor que llegan antes que un contracargo. |
| [Disputes](https://docs.whop.com/es/api-reference/disputes/dispute) | Contracargos presentados contra una cuenta, con pruebas y resultados. |
| [Payment Rules](https://docs.whop.com/es/api-reference/payment-rules/payment-rule) | Reglas que escribe una cuenta para decidir sobre sus propios pagos. |
| [Financing Applications](https://docs.whop.com/es/api-reference/financing-applications/financing-application) | La solicitud de una cuenta para aceptar métodos de pago de compra ahora y paga después. |

### Dinero

Saldos y banca: todas las formas en que entran o salen los fondos.

| Recurso | Para qué sirve |
| - | - |
| [Deposits](https://docs.whop.com/es/api-reference/deposits/deposit) | Añade fondos a un saldo. |
| [Transfers](https://docs.whop.com/es/api-reference/transfers/transfer) | Mueve fondos entre cuentas y usuarios de Whop. |
| [Payouts](https://docs.whop.com/es/api-reference/payouts/payout) | Envía dinero desde un saldo a un banco o una billetera. |
| [Financial Activity](https://docs.whop.com/es/api-reference/ledgers/ledger-activity) | El feed de actividad detrás del saldo de una cuenta o usuario. |
| [Cards](https://docs.whop.com/es/api-reference/cards/card) | Emite tarjetas que gastan de un saldo. |
| [Cashback Rules](https://docs.whop.com/es/api-reference/cashback-rules/cashback-rule) | Configura el cashback de tarjeta patrocinado por la plataforma. |
| [Swaps](https://docs.whop.com/es/api-reference/swaps/swap) | Convierte un saldo entre monedas. |
| [Trades](https://docs.whop.com/es/api-reference/trades/trade) | Coloca órdenes, cierra posiciones y mueve fondos para trading perpetuo y spot desde una billetera gestionada por Whop. |
| [Verifications](https://docs.whop.com/es/api-reference/verifications/verification) | Identidad legal necesaria antes de los retiros y la emisión de tarjetas. |

### Comercio

Vende productos y recibe pagos.

| Recurso | Para qué sirve |
| - | - |
| [Products](https://docs.whop.com/es/api-reference/products/product) | Lo que vendes. Cada uno tiene variantes y una página de tienda. |
| [Variants](https://docs.whop.com/es/api-reference/variants/variant) | Configuraciones comprables de un producto. |
| [Promo Codes](https://docs.whop.com/es/api-reference/promo-codes/promo-code) | Descuentos que los creadores configuran para el checkout. |
| [Checkout Configurations](https://docs.whop.com/es/api-reference/checkout-configurations/checkout-configuration) | Convierte una variante en un enlace de checkout compartible y prerrellenado. |
| [Waitlist Entries](https://docs.whop.com/es/api-reference/waitlist-entries/waitlist-entry) | Únete a listas de espera y gestiona los registros de clientes pendientes de aprobación. |
| [Memberships](https://docs.whop.com/es/api-reference/memberships/membership) | La compra de una variante por parte de un cliente, desde el checkout hasta la cancelación. |
| [Shipments](https://docs.whop.com/es/api-reference/shipments/shipment) | Sigue la entrega de un pedido por su número de seguimiento del transportista. |
| [Reviews](https://docs.whop.com/es/api-reference/reviews/review) | Valoraciones con estrellas y comentarios escritos de clientes sobre un producto. |
| [Review Reports](https://docs.whop.com/es/api-reference/review-reports/review-report) | Denuncias que los administradores de una cuenta presentaron contra reseñas de clientes. |
| [Product Affiliates](https://docs.whop.com/es/api-reference/product-affiliates/product-affiliate) | Usuarios inscritos para promocionar un producto, incluidos los afiliados sin referidos. |

### Sitios web

Apps alojadas, sus builds y dominios, y los experimentos que se ejecutan en ellas.

| Recurso | Para qué sirve |
| - | - |
| [Domains](https://docs.whop.com/es/api-reference/domains/domain) | Dominios personalizados asignados a apps alojadas. |
| [Apps](https://docs.whop.com/es/api-reference/apps/app) | Apps que construyes en Whop: metadatos, builds alojados, logs de ejecución. |
| [App Builds](https://docs.whop.com/es/api-reference/app-builds/app-build) | Artefactos de build versionados desplegados en las plataformas de una app. |
| [App Installations](https://docs.whop.com/es/api-reference/app-installations/app-installation) | Las instalaciones de tu app en cuentas y los datos que guarda sobre cada una. |
| [Experiments](https://docs.whop.com/es/api-reference/experiments/experiment) | Feature flags y experimentos A/B para lanzamientos graduales. |

### Anuncios

Ejecuta y mide campañas publicitarias desde tu integración.

| Recurso | Para qué sirve |
| - | - |
| [Ad Campaigns](https://docs.whop.com/es/api-reference/ad-campaigns/ad-campaign) | Objetivo y presupuesto de un conjunto de anuncios. |
| [Ad Groups](https://docs.whop.com/es/api-reference/ad-groups/ad-group) | Audiencia, calendario y presupuesto dentro de una campaña. |
| [Ads](https://docs.whop.com/es/api-reference/ads/ad) | La creatividad: texto, recursos y URL de destino. |
| [Audiences](https://docs.whop.com/es/api-reference/audiences/audience) | Listas de segmentación reutilizables para grupos de anuncios. |
| [Ad Pixels](https://docs.whop.com/es/api-reference/ad-pixels/ad-pixel) | Tus propios píxeles que reciben conversiones de las campañas que reclamaste. |

### Analítica

Quién visita, qué convierte y cómo está rindiendo una cuenta.

| Recurso | Para qué sirve |
| - | - |
| [Stats](https://docs.whop.com/es/api-reference/stats/stats) | Informes agregados financieros, de audiencia y de tráfico. |
| [People](https://docs.whop.com/es/api-reference/people/person) | Visitantes y clientes de una cuenta, con perfiles de identidad, compras y tráfico. |
| [Events](https://docs.whop.com/es/api-reference/events/event) | Eventos de conversión e interacción registrados para la atribución. |
| [Exports](https://docs.whop.com/es/api-reference/exports/export) | Volcados CSV asíncronos de los datos del dashboard de una cuenta. |
| [Economic Intelligence](https://docs.whop.com/es/api-reference/economic-intelligence/economic-intelligence) | Qué debería hacer una cuenta a continuación para crecer, generado a partir de sus propios datos. |

### Comunicación

Channels, los mensajes que se intercambian en ellos, livestreams, las notificaciones que reciben los usuarios y buzones de correo electrónico.

| Recurso | Para qué sirve |
| - | - |
| [Channels](https://docs.whop.com/es/api-reference/channels/channel) | Channels de chat privados, de comunidad y de soporte. |
| [Channel Members](https://docs.whop.com/es/api-reference/channel-members/channel-member) | Participantes de un channel y estado personal de membresía. |
| [Messages](https://docs.whop.com/es/api-reference/messages/message) | Mensajes de chat, archivos adjuntos, reacciones y encuestas. |
| [Livestreams](https://docs.whop.com/es/api-reference/livestreams/livestream) | Transmisiones de video en directo en una experiencia y sus grabaciones. |
| [Notifications](https://docs.whop.com/es/api-reference/notifications/notification) | El feed de notificaciones del usuario: indicadores de no leídos, marcar como leído, envíos desde apps y el catálogo de temas. |
| [Email Addresses](https://docs.whop.com/es/api-reference/email-addresses/email-address) | Buzones en los dominios de una cuenta, para enviar y recibir correo electrónico. |
| [Automations](https://docs.whop.com/es/api-reference/automations/automation) | Flujos de trabajo que un evento de webhook o una solicitud de activación inicia para cada miembro, ejecutando pasos programados que les envían mensajes. |
| [Automation Steps](https://docs.whop.com/es/api-reference/automation-steps/automation-step) | Los pasos de espera, correo electrónico y mensaje de las versiones de una automatización. |
| [Automation Enrollments](https://docs.whop.com/es/api-reference/automation-enrollments/automation-enrollment) | Los miembros que están pasando por una automatización y el paso en el que espera cada uno. |

### Partners

Refiere usuarios y negocios a Whop y haz seguimiento de lo que ganas.

| Recurso | Para qué sirve |
| - | - |
| [Partners](https://docs.whop.com/es/api-reference/partners/partner) | Tu perfil de partner, enlaces de referido, tarifas de pago y negocios referidos. |
| [Partner Referral Requests](https://docs.whop.com/es/api-reference/partner-referral-requests/partner-referral-request) | Solicita la atribución de un negocio o partner y gestiona su aprobación. |

### Fuerza laboral

Publica tareas pagadas y paga a personas por el trabajo completado.

| Recurso | Para qué sirve |
| - | - |
| [Bounties](https://docs.whop.com/es/api-reference/bounties/bounty) | Tareas pagadas con envíos revisados y recompensas en depósito de garantía. |
| [Bounty Submissions](https://docs.whop.com/es/api-reference/bounty-submissions/bounty-submission) | Trabajo enviado a una bounty, desde el intento hasta el pago. |

### Medios

Genera recursos multimedia desde tu integración.

| Recurso | Para qué sirve |
| - | - |
| [Files](https://docs.whop.com/es/api-reference/files/file) | Sube archivos y adjúntalos donde Whop acepte documentos. |
| [Media](https://docs.whop.com/es/api-reference/media/media) | Recursos generados por IA, facturados desde un saldo, que se pueden adjuntar donde se acepten archivos. |

### Desarrollador

Credenciales, webhooks y logs para integrarse con la API de Whop.

| Recurso | Para qué sirve |
| - | - |
| [API Keys](https://docs.whop.com/es/api-reference/api-keys/api-key) | Credenciales programáticas para una cuenta o app. |
| [Webhooks](https://docs.whop.com/es/api-reference/webhooks/webhook) | Notificaciones de eventos enviadas a tu servidor a medida que ocurren. |
| [Permissions](https://docs.whop.com/es/api-reference/permissions/permission) | Lo que tu credencial puede hacer sobre un recurso. |
| [API Logs](https://docs.whop.com/es/api-reference/api-logs/api-log) | Solicitudes realizadas a la API de Whop con las API keys de tu cuenta. |
| [Feedback](https://docs.whop.com/es/api-reference/feedback/feedback) | Problemas y preguntas sin responder enviados a Whop para su revisión. |


## Related topics

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