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

# API de Partners

> Empieza en whop.com/network. Un Partner es un usuario que refiere personas y negocios a Whop.

Empieza en [whop.com/network](https://whop.com/network). Un Partner es un usuario que refiere personas y negocios a Whop. El perfil de partner incluye la inscripción, los recuentos de referidos directos de negocios activos y las condiciones de pago predeterminadas.

Recupera tu perfil con `/partners/me`. Usa `/partner_referral_requests` para crear y gestionar enlaces de referido y sus recompensas. También puedes inscribirte en el programa de partners, revisar los usuarios y negocios referidos, seguir tus ganancias y ver la clasificación de partners.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Recuperar un partner](https://docs.whop.com/es/api-reference/partners/retrieve-a-partner.md) | GET `/partners/{id}` |
| [Listar negocios referidos](https://docs.whop.com/es/api-reference/partners/list-referred-businesses.md) | GET `/partners/businesses` |
| [Recuperar un negocio referido](https://docs.whop.com/es/api-reference/partners/retrieve-a-referred-business.md) | GET `/partners/businesses/{id}` |
| [Listar ganancias de negocios referidos](https://docs.whop.com/es/api-reference/partners/list-referred-business-earnings.md) | GET `/partners/businesses/{id}/earnings` |
| [Recuperar las condiciones de comisión que puede ofrecer un partner](https://docs.whop.com/es/api-reference/partners/retrieve-the-fee-terms-a-partner-can-offer.md) | GET `/partners/fee_options` |
| [Recuperar la clasificación](https://docs.whop.com/es/api-reference/partners/retrieve-the-leaderboard.md) | GET `/partners/leaderboard` |
| [Inscribirse como partner de Whop](https://docs.whop.com/es/api-reference/partners/enroll-as-a-whop-partner.md) | POST `/partners` |
| [Aceptar una oferta CPA](https://docs.whop.com/es/api-reference/partners/accept-a-cpa-offer.md) | POST `/partners/businesses/{id}/accept_commission_advance` |
| [Reenviar una invitación al propietario](https://docs.whop.com/es/api-reference/partners/resend-an-owner-invite.md) | POST `/partners/businesses/{id}/resend_invite` |
| [Guardar proyecciones CPA](https://docs.whop.com/es/api-reference/partners/save-cpa-projections.md) | PATCH `/partners/businesses/{id}` |

## Atributos

**account\_id** `string | null` *required*

El negocio al que pertenecen estas `payout_rates`, con el prefijo `biz_`, cuando la solicitud envió `account_id`. `null` cuando las tarifas son las del propio solicitante.

**certification\_complete** `boolean` *required*

Si el usuario terminó el curso de certificación de partners: cada cuestionario y comprobación de conocimientos visible tiene un resultado aprobado o, cuando el curso no tiene ninguno, cada lección visible está marcada como completada.

**joined\_at** `string | null` *required*

Cuándo se unió el usuario al programa de partners, como marca de tiempo ISO 8601. Null cuando no se ha unido.

**payout\_rates** `object[]` *required*

Porcentajes de pago predeterminados agrupados por nivel de referido, con una duración de ganancias por nivel. Los del negocio cuando la solicitud envió `account_id`; en caso contrario, los del propio solicitante. Los negocios existentes pueden tener condiciones individuales.

> [accordion] Propiedades
>
> **duration** `object` *required*
>
> Periodo predeterminado durante el cual un nuevo negocio referido puede generar comisiones, medido desde el inicio de su atribución. No es un retraso de pago. Las condiciones de cada negocio pueden variar.
>
> > [accordion] Propiedades
> >
> > **unit** `string` *required*
> >
> > Unidad de la ventana de ganancias. Month significa un mes calendario; day significa un día.
> >
> > Opciones disponibles: `day`, `month`
> >
> > **value** `integer` *required*
> >
> > Número de unidades de la ventana de ganancias.
>
> **rates** `object[]` *required*
>
> Porcentajes de pago predeterminados para cada fuente de ingresos en este nivel de referido.
>
> > [accordion] Propiedades
> >
> > **income\_source** `string` *required*
> >
> > Fuente de ingresos que genera este pago porcentual.
> >
> > Opciones disponibles: `sales`, `transfer`, `card_interchange`, `ad_spend`, `withdrawal`
> >
> > **percentage** `number` *required*
> >
> > Porcentaje predeterminado del partner para este nivel y fuente de ingresos. Por ejemplo, 30 significa 30%.
>
> **tier** `string` *required*
>
> Nivel de referido: first para un negocio referido directamente, o second para un negocio aportado por un partner referido.
>
> Opciones disponibles: `first`, `second`

**referred\_businesses\_count** `integer` *required*

Número de referidos de negocios activos de primer nivel atribuidos al partner, excluidos los negocios eliminados.

**referring\_partner** `object | null` *required*

El usuario que refirió a este usuario. Obsoleto: ya no se rellena. Siempre `null`. OBSOLETO: ya no se rellena. Siempre null.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del usuario, con el prefijo `user_`.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no estableció ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no estableció ninguna imagen.
>
> **username** `string` *required*
>
> Nombre de usuario público.

**user** `object` *required*

El perfil público del partner autenticado.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del usuario, con el prefijo `user_`.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no estableció ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no estableció ninguna imagen.
>
> **username** `string` *required*
>
> Nombre de usuario público.

**verification\_waitlist\_joined** `boolean` *required*

Si el usuario tiene una entrada personal pendiente o aprobada en la lista de espera de Verified Partner.

**whop\_partner\_verified\_at** `string | null` *required*

Cuándo el usuario se convirtió en Whop Partner verificado, como marca de tiempo ISO 8601. `null` si no está verificado.

```json Partner theme={null}
{
	"user": {
		"id": "user_9mHw2b4TkL8pQ",
		"username": "jane",
		"name": "Jane Chen",
		"profile_picture": {
			"url": "https://example.com/jane-avatar.png"
		}
	},
	"joined_at": "2026-09-01T12:00:00.000Z",
	"whop_partner_verified_at": null,
	"verification_waitlist_joined": false,
	"certification_complete": false,
	"referred_businesses_count": 12,
	"referring_partner": null,
	"account_id": null,
	"payout_rates": [
		{
			"tier": "first",
			"duration": {
				"unit": "month",
				"value": 600
			},
			"rates": [
				{
					"income_source": "sales",
					"percentage": 30
				},
				{
					"income_source": "transfer",
					"percentage": 30
				},
				{
					"income_source": "card_interchange",
					"percentage": 30
				},
				{
					"income_source": "ad_spend",
					"percentage": 1
				}
			]
		},
		{
			"tier": "second",
			"duration": {
				"unit": "month",
				"value": 600
			},
			"rates": [
				{
					"income_source": "sales",
					"percentage": 10
				},
				{
					"income_source": "transfer",
					"percentage": 10
				},
				{
					"income_source": "card_interchange",
					"percentage": 10
				},
				{
					"income_source": "ad_spend",
					"percentage": 0.5
				}
			]
		}
	]
}
```


## Related topics

- [API de Partner Referral Requests](https://docs.whop.com/es/api-reference/partner-referral-requests/partner-referral-request.md)
- [API de Whop Partners](https://docs.whop.com/es/developer/partners/overview.md)
- [Referencia de la API de Stats](https://docs.whop.com/es/api-reference/stats/stats.md)
