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

# Partner Referral Requests API

> 파트너 추천 요청(Partner Referral Request)은 파트너의 추천 링크이거나, 기존 비즈니스의 추천인으로 인정받기 위한 요청입니다.

어트리뷰션 요청은 비즈니스 소유자가 수락해야만 효력이 발생합니다.

Partner Referral Requests API를 사용하여 추천 링크를 생성하고 어트리뷰션 요청을 보낼 수 있습니다. 또한 보내거나 받은 링크와 요청의 목록을 조회하고, 대기 중인 요청을 수락, 거절 또는 취소할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [파트너 추천 요청 목록 조회](https://docs.whop.com/ko/api-reference/partner-referral-requests/list-partner-referral-requests.md) | GET `/partner_referral_requests` |
| [파트너 추천 요청 조회](https://docs.whop.com/ko/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md) | GET `/partner_referral_requests/{id}` |
| [파트너 추천 요청 생성](https://docs.whop.com/ko/api-reference/partner-referral-requests/create-a-partner-referral-request.md) | POST `/partner_referral_requests` |
| [파트너 추천 요청 수락](https://docs.whop.com/ko/api-reference/partner-referral-requests/accept-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/accept` |
| [파트너 추천 요청 취소](https://docs.whop.com/ko/api-reference/partner-referral-requests/cancel-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/cancel` |
| [파트너 추천 요청 거절](https://docs.whop.com/ko/api-reference/partner-referral-requests/decline-a-partner-referral-request.md) | POST `/partner_referral_requests/{id}/decline` |

## 속성

**id** `string` *required*

파트너 추천 요청 ID로, 접두사는 `prfr_`입니다.

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

요청을 받는 비즈니스입니다(지정된 경우).

> [accordion] 속성
>
> **id** `string` *required*
>
> 계정 ID로, 접두사는 `biz_`입니다.
>
> **title** `string` *required*
>
> 계정 표시 이름입니다.

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

이 추천이 생성된 파트너의 팀 멤버십으로, 접두사는 `ausr_`입니다. 개인 추천인
경우 `null`입니다.

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

고유 추천 코드입니다(지정된 경우).

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

요청이 생성된 시점으로, ISO 8601 타임스탬프입니다.

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

허용되는 최대 사용 횟수입니다(제한된 경우).

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

해당 비즈니스에서의 파트너 역할이 멤버 레코드에 보관된 경우, 이 추천이 생성된
파트너의 멤버 레코드로, 접두사는 `mber_`입니다. 그 외의 경우 `null`입니다.

**partner** `object` *required*

요청한 파트너의 공개 프로필입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 사용자 ID로, 접두사는 `user_`입니다.
>
> **name** `string | null` *required*
>
> 표시 이름입니다.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름입니다.

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

추천이 파트너의 팀에 속한 경우, 파트너가 이 요청을 대신 보낸 비즈니스입니다. 개인 추천인 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 계정 ID로, 접두사는 `biz_`입니다.
>
> **title** `string` *required*
>
> 계정 표시 이름입니다.

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

추천 요청이 시작된 방식입니다.

사용 가능한 옵션: `manual`, `ownership_transfer`, `link`

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

이 요청이 제공하는 보상입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 파트너 보상 ID로, 접두사는 `prwd_`입니다.
>
> **bot\_qualification\_type** `string | null` *required*
>
> 이 보상의 자격 요건이 되는 활동입니다(지정된 경우).
>
> 사용 가능한 옵션: `sales`, `ad_spend`
>
> **qualification\_amount** `object` *required*
>
> 보상을 받기 위해 필요한 자격 활동의 USD 금액입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은
> > 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
>
> **recipient** `string | null` *required*
>
> 보상 수령인의 역할이며, 요청한 파트너가 아닌 고정된 사용자인 경우 null입니다.
>
> 사용 가능한 옵션: `business`, `partner`
>
> **recipient\_id** `string | null` *required*
>
> 실제 수령인의 사용자 또는 비즈니스 ID이며, 비즈니스가 오퍼를 사용하기 전까지는
> null입니다.
>
> **reward\_amount** `object` *required*
>
> 자격 충족 후 지급되는 USD 금액입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은
> > 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.

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

승인 상태이며, 승인 절차가 없는 요청의 경우 null입니다.

사용 가능한 옵션: `pending`, `accepted`, `denied`, `cancelled`

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

요청이 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다.

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

어트리뷰션 요청이 전송된 사용자입니다. 지원 중단됨: 사용자 대상 요청은 종료되었습니다. 항상 `null`입니다. DEPRECATED: 더 이상 값이 채워지지 않습니다. 항상 null입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 사용자 ID로, 접두사는 `user_`입니다.
>
> **name** `string | null` *required*
>
> 표시 이름입니다.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름입니다.

```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/ko/api-reference/partner-referral-requests/create-a-partner-referral-request.md)
- [Retrieve a Partner Referral Request](https://docs.whop.com/ko/api-reference/partner-referral-requests/retrieve-a-partner-referral-request.md)
- [List Partner Referral Requests](https://docs.whop.com/ko/api-reference/partner-referral-requests/list-partner-referral-requests.md)
