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

# Product

> 상품(Product)은 Whop에서 판매되는 디지털 상품 또는 서비스입니다. 상품에는 가격 책정을 위한 플랜과 콘텐츠 제공을 위한 경험이 포함됩니다.

> [!NOTE]
>
> 이 리소스에는 새 통합의 기반이 되어야 하는 버전 관리형 API인 [Whop API](https://docs.whop.com/ko/api-reference/legacy/products/product.md)의 후속 리소스가 있습니다. 이 페이지는 계속 완전히 지원됩니다.

```json Example theme={null}
{
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"route": "pickaxe",
		"title": "Pickaxe"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"custom_cta": "get_access",
	"custom_cta_url": "https://example.com/signup",
	"custom_statement_descriptor": "PICKAXE",
	"description": "Track your revenue, members, and growth in real time.",
	"external_identifier": "ext_prod_12345",
	"gallery_images": [
		{
			"content_type": "image/jpeg",
			"id": "<string>",
			"url": "https://media.whop.com/abc123/optimized.jpg"
		}
	],
	"global_affiliate_percentage": 6.9,
	"global_affiliate_status": "enabled",
	"headline": "Real-time data analytics for creators",
	"id": "prod_xxxxxxxxxxxxx",
	"member_affiliate_percentage": 6.9,
	"member_affiliate_status": "enabled",
	"member_count": 42,
	"metadata": {},
	"owner_user": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	},
	"product_tax_code": {
		"id": "ptc_xxxxxxxxxxxxxx",
		"name": "Digital - SaaS",
		"product_type": "physical"
	},
	"published_reviews_count": 42,
	"route": "pickaxe-analytics",
	"title": "Pickaxe Analytics",
	"updated_at": "2023-12-01T05:00:00.401Z",
	"verified": true,
	"visibility": "visible"
}
```

**company** `object` *required*

이 상품이 속한 회사입니다.

**하위 속성**

**id** `string` *required*

회사의 고유 식별자입니다.

예시: `biz_xxxxxxxxxxxxxx`

**route** `string` *required*

계정 스토어 페이지의 URL 슬러그입니다. 예: whop.com/pickaxe의 `pickaxe`.

예시: `pickaxe`

**title** `string` *required*

고객에게 표시되는 회사의 표시 이름입니다.

예시: `Pickaxe`

**created\_at** `string\<date-time\>` *required*

상품이 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**custom\_cta** `CustomCtas` *required*

상품 구매 페이지에 표시되는 행동 유도 버튼 레이블입니다.

사용 가능한 옵션: `get_access`, `join`, `order_now`, `shop_now`, `call_now`, `donate_now`, `contact_us`, `sign_up`, `subscribe`, `purchase`, `get_offer`, `apply_now`, `complete_order`

**custom\_cta\_url** `string | null` *required*

행동 유도 버튼이 기본 체크아웃 흐름 대신 연결되는 선택적 URL입니다. 사용자 지정 URL이 설정되지 않은 경우 Null입니다.

예시: `https://example.com/signup`

**custom\_statement\_descriptor** `string | null` *required*

상품 구매에 대한 사용자 지정 은행 명세서 표시 문구입니다. 필수 `WHOP*` 접두사를 포함하여 최대 22자입니다.

예시: `PICKAXE`

**description** `string | null` *required*

상품이 제공하는 내용에 대한 간략한 요약으로, 상품 페이지와 검색 결과에 표시됩니다.

예시: `Track your revenue, members, and growth in real time.`

**external\_identifier** `string | null` *required*

상품의 외부 식별자입니다. 상품 생성 엔드포인트에서 이 값을 제공하면 새 상품을 생성하는 대신 이 식별자를 가진 기존 상품을 업데이트합니다.

예시: `ext_prod_12345`

**gallery\_images** `array\<object\>` *required*

이 상품의 갤러리 이미지로, 위치순으로 정렬됩니다.

**하위 속성**

**content\_type** `string | null` *required*

업로드된 파일의 MIME 유형입니다(예: image/jpeg, video/mp4, audio/mpeg).

예시: `image/jpeg`

**id** `string` *required*

**url** `string | null` *required*

클라이언트에서 이 첨부 파일을 렌더링하기 위해 사전 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 사용해야 합니다.

예시: `https://media.whop.com/abc123/optimized.jpg`

**global\_affiliate\_percentage** `number | null` *required*

이 상품의 마켓플레이스 제휴 수수료 비율이며, 프로그램이 비활성 상태인 경우 `null`입니다.

예시: `6.9`

**global\_affiliate\_status** `GlobalAffiliateStatuses` *required*

Whop 마켓플레이스 글로벌 제휴 프로그램에서 이 상품의 등록 상태입니다.

사용 가능한 옵션: `enabled`, `disabled`

**headline** `string | null` *required*

상품 페이지에 눈에 띄게 표시되는 짧은 마케팅 헤드라인입니다.

예시: `Real-time data analytics for creators`

**id** `string` *required*

상품의 고유 식별자입니다.

예시: `prod_xxxxxxxxxxxxx`

**member\_affiliate\_percentage** `number | null` *required*

이 상품의 멤버 추천 수수료 비율이며, 프로그램이 비활성 상태인 경우 `null`입니다.

예시: `6.9`

**member\_affiliate\_status** `GlobalAffiliateStatuses` *required*

멤버 제휴 프로그램에서 이 상품의 등록 상태입니다.

사용 가능한 옵션: `enabled`, `disabled`

**member\_count** `integer` *required*

이 상품의 활성 멤버십 수입니다. 계정에서 공개 멤버 수를 비활성화한 경우 `0`을 반환합니다.

예시: `42`

**metadata** `object | null` *required*

상품에 저장되어 결제 및 멤버십 웹훅 페이로드에 포함되는 사용자 지정 키-값 쌍입니다. 최대 50개 키, 키당 100자, 문자열 값당 500자입니다.

**owner\_user** `object` *required*

이 상품을 판매하는 회사를 소유한 사용자입니다.

**하위 속성**

**id** `string` *required*

사용자의 고유 식별자입니다.

예시: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

공개 프로필에 표시되는 사용자의 표시 이름입니다.

예시: `John Doe`

**username** `string` *required*

공개 프로필에 표시되는 사용자의 고유 사용자 이름입니다.

예시: `johndoe42`

**product\_tax\_code** `object | null` *required*

판매세 계산을 위해 이 상품의 구매에 적용되는 세금 분류 코드입니다. 세금 코드가 할당되지 않은 경우 Null입니다.

**하위 속성**

**id** `string` *required*

상품 세금 코드의 고유 식별자입니다.

예시: `ptc_xxxxxxxxxxxxxx`

**name** `string` *required*

이 세금 분류의 사람이 읽을 수 있는 이름입니다(예: 'Digital - SaaS').

예시: `Digital - SaaS`

**product\_type** `ProductTaxCodeProductTypes` *required*

이 세금 코드가 다루는 광범위한 상품 카테고리로, 실물 상품이나 디지털 서비스 등이 있습니다.

사용 가능한 옵션: `physical`, `digital`, `services`

**published\_reviews\_count** `integer` *required*

이 상품 회사에 게시된 고객 리뷰의 총수입니다.

예시: `42`

**route** `string` *required*

상품 공개 링크의 URL 슬러그입니다. 예: whop.com/company/pickaxe-analytics의 `pickaxe-analytics`.

예시: `pickaxe-analytics`

**title** `string` *required*

상품 페이지와 검색 결과에서 고객에게 표시되는 상품의 표시 이름입니다.

예시: `Pickaxe Analytics`

**updated\_at** `string\<date-time\>` *required*

상품이 마지막으로 업데이트된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**verified** `boolean` *required*

이 회사가 Whop의 신뢰 및 안전 팀의 인증을 받았는지 여부입니다.

**visibility** `Visibility` *required*

상품이 고객에게 표시되는지 여부를 제어합니다. 'hidden'으로 설정하면 상품은 직접 링크를 통해서만 접근할 수 있습니다.

사용 가능한 옵션: `visible`, `hidden`, `archived`, `quick_link`
