> ## 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 Partner Referral Requests

> Una Partner Referral Request es el enlace de referido de un partner, o una solicitud para que se le acredite como referente de un negocio existente.

Una solicitud de atribución solo surte efecto cuando un propietario del negocio la acepta.

Usa la API de Partner Referral Requests para crear enlaces de referido y enviar solicitudes de atribución. También puedes listar los enlaces y solicitudes que has enviado o recibido, y aceptar, rechazar o cancelar una solicitud pendiente.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar solicitudes de referido de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/list-partner-referral-requests.md) | GET `/partner_referral_requests` |
| [Recuperar una solicitud de referido de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md) | GET `/partner_referral_requests/{id}` |
| [Crear una solicitud de referido de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/create-a-partner-referral-request.md) | POST `/partner_referral_requests` |
| [Aceptar una solicitud de referido de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/accept-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/accept` |
| [Cancelar una solicitud de referido de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/cancel-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/cancel` |
| [Rechazar una solicitud de referido de partner](https://docs.whop.com/es/api-reference/partner-referral-requests/decline-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/decline` |

## Atributos

**id** `string` *required*

ID de la solicitud de referido de partner, con el prefijo `prfr_`.

**account** `object | null` *required*

Negocio que recibe la solicitud, cuando hay uno asignado.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

**authorized\_user\_id** `string | null` *required*

La membresía de equipo del partner para la que se creó este referido, con el prefijo `ausr_`. `null` cuando el referido es personal.

**code** `string | null` *required*

Código de referido único, cuando está asignado.

**created\_at** `string` *required*

Cuándo se creó la solicitud, como marca de tiempo ISO 8601.

**max\_redemptions** `integer | null` *required*

Número máximo de canjes permitidos, cuando está limitado.

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

El registro de miembro del partner para el que se creó este referido, con el prefijo `mber_`, cuando su rol en ese negocio está en su registro de miembro. `null` en caso contrario.

**partner** `object` *required*

Perfil público del partner solicitante.

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

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

Negocio en cuyo nombre el partner envió esta solicitud, cuando el referido pertenece a su equipo. `null` para un referido personal.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

**request\_type** `string` *required*

Cómo se inició la solicitud de referido.

Opciones disponibles: `manual`, `ownership_transfer`, `link`

**rewards** `object[]` *required*

Recompensas ofrecidas por esta solicitud.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la recompensa de partner, con el prefijo `prwd_`.
>
> **bot\_qualification\_type** `string | null` *required*
>
> Actividad que califica para esta recompensa, cuando se especifica.
>
> Opciones disponibles: `sales`, `ad_spend`
>
> **qualification\_amount** `object` *required*
>
> Importe en USD de actividad calificada necesario para obtener la recompensa.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como una cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún float lo redondee en tránsito.
> >
> > **currency** `string` *required*
> >
> > Código de moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales lleva el importe. Esta es la precisión con la que se ejecuta el cargo en sí.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa este valor para formatear el número en tu propia configuración regional.
>
> **recipient** `string | null` *required*
>
> Rol del destinatario de la recompensa, o null para un usuario fijo que no es el partner solicitante.
>
> Opciones disponibles: `business`, `partner`
>
> **recipient\_id** `string | null` *required*
>
> ID del usuario o negocio destinatario concreto, o null hasta que un negocio canjee la oferta.
>
> **reward\_amount** `object` *required*
>
> Importe en USD otorgado tras la calificación.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como una cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún float lo redondee en tránsito.
> >
> > **currency** `string` *required*
> >
> > Código de moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales lleva el importe. Esta es la precisión con la que se ejecuta el cargo en sí.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa este valor para formatear el número en tu propia configuración regional.

**status** `string | null` *required*

El estado de aprobación, o null para solicitudes sin proceso de aprobación.

Opciones disponibles: `pending`, `accepted`, `denied`, `cancelled`

**updated\_at** `string` *required*

Cuándo cambió la solicitud por última vez, como marca de tiempo ISO 8601.

**user** `object | null` *required*

El usuario al que se envió una solicitud de atribución. Obsoleto: las solicitudes a un usuario han finalizado. 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.

```json PartnerReferralRequest theme={null}
{
	"id": "prfr_xxxxxxxxxxxxxx",
	"request_type": "manual",
	"status": "accepted",
	"code": null,
	"max_redemptions": null,
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing"
	},
	"referring_account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Whitfield Growth Partners"
	},
	"partner": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"username": "danawhitfield",
		"profile_picture": {
			"url": "https://ui-avatars.com/api/?name=Dana+Whitfield"
		}
	},
	"user": null,
	"rewards": [
		{
			"id": "prwd_xxxxxxxxxxxxxx",
			"recipient": "partner",
			"recipient_id": "user_xxxxxxxxxxxxxx",
			"bot_qualification_type": "sales",
			"qualification_amount": {
				"amount": "1000.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			},
			"reward_amount": {
				"amount": "100.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"created_at": "2026-09-10T09:00:00.000Z",
	"updated_at": "2026-09-11T17:20:00.000Z",
	"authorized_user_id": null,
	"member_id": null
}
```


## Related topics

- [Create a Partner Referral Request](https://docs.whop.com/es/api-reference/partner-referral-requests/create-a-partner-referral-request.md)
- [Retrieve a Partner Referral Request](https://docs.whop.com/es/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md)
- [List Partner Referral Requests](https://docs.whop.com/es/api-reference/partner-referral-requests/list-partner-referral-requests.md)
