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

# Products API

> Product는 Whop에서 판매되는 디지털 상품 또는 서비스입니다. 상품에는 가격 책정을 위한 변형(variant)이 포함되며, 콘텐츠 제공을 위한 경험(experience)이 포함될 수 있습니다.

Products API를 사용하면 공개 마켓플레이스를 검색하고, 계정의 상품 목록을 조회하고, 상품을 조회하고, 상품을 생성, 업데이트 또는 삭제할 수 있습니다.

> [!NOTE]
>
> Legacy [Products](https://docs.whop.com/ko/api-reference/products/product) 리소스를 대체합니다.
> 기존 Legacy 통합은 계속 작동합니다. 안정성 계약은 [API
> 버전](https://docs.whop.com/ko/developer/api/versioning.md)을 참조하세요.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [상품 목록 조회](https://docs.whop.com/ko/api-reference/products/list-products.md) | GET `/products` |
| [상품 조회](https://docs.whop.com/ko/api-reference/products/retrieve-product.md) | GET `/products/{id}` |
| [상품 생성](https://docs.whop.com/ko/api-reference/products/create-product.md) | POST `/products` |
| [상품 게시](https://docs.whop.com/ko/api-reference/products/publish-product.md) | POST `/products/{id}/publish` |
| [상품 게시 취소](https://docs.whop.com/ko/api-reference/products/unpublish-product.md) | POST `/products/{id}/unpublish` |
| [상품 업데이트](https://docs.whop.com/ko/api-reference/products/update-product.md) | PATCH `/products/{id}` |
| [상품 삭제](https://docs.whop.com/ko/api-reference/products/delete-product.md) | DELETE `/products/{id}` |

## 속성

**id** `string` *required*

`prod_` 접두사가 붙은 상품 ID입니다.

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

이 상품을 판매하는 계정입니다.

**average\_review\_rating** `number` *required*

이 상품의 게시된 리뷰 전체의 평균 별점으로, `1.0`에서 `5.0` 사이입니다.
게시된 리뷰 평점이 없으면 `0.0`을 반환합니다.

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

상품이 생성된 시각으로, ISO 8601 타임스탬프입니다.

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

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

사용 가능한 옵션: `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입니다.

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

고객의 은행 명세서에 표시되는 사용자 정의 텍스트 레이블입니다.

**default\_variant** `object | null` *required*

표시하고 결제에 사용할 구매 가능한 변형입니다. 구성된 기본 변형이 구매 가능하면 그 변형이고, 그렇지 않으면 상품 페이지 순서상 첫 번째 구매 가능한 변형입니다. 구매 가능한 변형이 없으면 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `plan_` 접두사가 붙은 변형 ID입니다.
>
> **billing\_period** `number | null` *required*
>
> 반복 청구 사이의 일수로, 예를 들어 월간은 30, 연간은 365입니다.
> 일회성 변형의 경우 `null`입니다.
>
> **billing\_type** `string` *required*
>
> 이 변형의 청구 모델로, `one_time` 또는 `renewal`입니다.
>
> 사용 가능한 옵션: `renewal`, `one_time`
>
> **expiration\_days** `number | null` *required*
>
> 만료 기반 변형의 접근 기간(일)입니다. 만료가 없는 변형의 경우
> `null`입니다.
>
> **initial\_price** `object` *required*
>
> 결제 시 선불로 청구되는 금액입니다. 체험판처럼 첫 청구가 무료인 경우 `amount`는 `"0.00"`입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **renewal\_price** `object` *required*
>
> `billing_period`일마다 반복 청구되는 금액입니다. 일회성 변형의 경우 `amount`는 `"0.00"`입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **title** `string | null` *required*
>
> 고객에게 표시되는 변형 표시 이름입니다. 제목이 설정되지 않은 경우 `null`입니다.
>
> **trial\_period\_days** `number | null` *required*
>
> 첫 갱신 청구 전 무료 체험 일수입니다. 체험판이 구성되지 않았거나
> 로그인한 사용자가 이미 이 변형의 체험판을 사용한 경우 `null`입니다.
>
> **unlimited\_stock** `boolean` *required*
>
> 변형의 재고가 무제한인지 여부입니다.
>
> **visibility** `string` *required*
>
> 이 변형이 표시되는 위치입니다. `visible` 변형은 상품 페이지에 표시됩니다.
>
> 사용 가능한 옵션: `visible`, `hidden`, `archived`, `quick_link`

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

상품 페이지에 표시되는 설명 문구입니다. 설정되지 않은 경우 `null`입니다.

**experiences** `object[]` *required*

상품에 포함된 경험(코스, 채팅, 앱 등)으로, 가장 오래된 것이 먼저 나옵니다. 처음 100개만 포함하며, 나머지는 `GET /experiences?product_id=`로 페이지별로 조회하세요.

> [accordion] 속성
>
> **id** `string` *required*
>
> `exp_` 접두사가 붙은 경험 ID입니다.
>
> **app** `object` *required*
>
> 경험이 실행되는 앱입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > `app_` 접두사가 붙은 앱 ID입니다.
> >
> > **icon** `object` *required*
> >
> > 앱 아이콘입니다. 업로드된 아이콘이 없으면 기본 앱 아이콘으로 대체됩니다.
> >
> > > [accordion] 속성
> > >
> > > **url** `string` *required*
> > >
> > > 아이콘 이미지 URL입니다. 항상 존재하며, 업로드된 아이콘이 없으면 기본 앱 아이콘입니다.
> >
> > **name** `string` *required*
> >
> > 앱 표시 이름입니다.
>
> **logo\_url** `string | null` *required*
>
> 이 경험에 업로드된 로고 이미지 URL입니다. 없으면 `null`이며, 이 경우 앱의
> `icon`을 대신 표시하세요.
>
> **name** `string` *required*
>
> 경험 표시 이름입니다.

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

사용자 참조용으로 상품에 저장된 외부 식별자입니다.

**gallery\_images** `object[]` *required*

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

> [accordion] 속성
>
> **id** `string` *required*
>
> 갤러리 이미지 ID입니다.
>
> **content\_type** `string | null` *required*
>
> 업로드된 파일의 MIME 유형으로, 예를 들어 image/jpeg입니다.
>
> **url** `string | null` *required*
>
> 클라이언트에서 이 이미지를 렌더링하기 위해 미리 최적화된 URL입니다.

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

글로벌 제휴 프로그램을 통해 제휴자가 받는 커미션 비율입니다.

**global\_affiliate\_status** `string | null` *required*

글로벌 제휴 프로그램의 등록 상태입니다.

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

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

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

**labels** `string[]` *required*

상품을 컬렉션으로 그룹화하는 데 사용되는 소문자 레이블입니다. 하나의 컬렉션을
가져오려면 목록 엔드포인트를 `labels`로 필터링하세요.

**logo\_url** `string | null` *required*

상품 페이지와 검색 결과에 표시되는 로고 이미지 URL입니다. 상품에 로고가 없으면
`null`입니다.

**marketplace\_status** `string` *required*

whop.com 마켓플레이스의 등록 상태입니다. `pending_review`는 제출되어 검토를 기다리는 중임을, `live_marketplace`는 승인되어 검색 가능함을 의미합니다.

사용 가능한 옵션: `not_available`, `pending_review`, `live_marketplace`

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

회원 제휴 프로그램을 통해 회원이 받는 커미션 비율입니다.

**member\_affiliate\_status** `string | null` *required*

회원 제휴 프로그램의 등록 상태입니다.

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

**member\_count** `number` *required*

이 상품의 활성 멤버십 수입니다. 공개 회원 수가 비활성화된 경우 0입니다.

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

상품에 저장된 사용자 정의 키-값 쌍입니다.

**owner\_user** `object | null` *required*

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

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

이 상품의 세금 분류 코드이며, 세금 코드가 설정되지 않은 경우 `null`입니다.

**published\_reviews\_count** `number` *required*

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

**route** `string` *required*

상품 공개 링크의 URL 슬러그입니다.

**title** `string` *required*

고객에게 표시되는 상품 표시 이름입니다.

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

상품이 마지막으로 업데이트된 시각으로, ISO 8601 타임스탬프입니다.

**variant\_attributes** `object | null` *required*

상품의 변형들이 아우르는 옵션 세트로, 속성 이름을 사용 중인 값에 매핑한 맵입니다. 예: `\{"color": ["Blue", "Red"], "size": ["S", "M", "L"]}`. `attributes`를 가진 표시 상태의 비인보이스 변형에서 파생되며, 키는 알파벳순, 값은 변형이 생성된 순서입니다. 읽기 전용입니다. 상품에 변형이 없으면 `null`입니다.

**variants** `object[] | null` *required*

`visibility`가 `visible`이고 인보이스용으로 생성되지 않은 상품의 변형으로, 생성 순서대로 나열됩니다. 일반 가격 옵션은 `attributes: null`로 포함됩니다. 숨김, 보관, 퀵 링크, 인보이스 변형은 `GET /variants`를 통해 계속 조회할 수 있습니다. 상품의 변형이 1000개를 초과하는 경우(`GET /variants?product_ids=`로 페이지별 조회)와 웹훅 페이로드에서는 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `plan_` 접두사가 붙은 변형 ID입니다.
>
> **account** `object | null` *required*
>
> 이 변형을 판매하는 계정입니다. 독립 인보이스 변형의 경우 `null`입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > `biz_` 접두사가 붙은 계정 ID입니다.
> >
> > **title** `string` *required*
> >
> > 계정 표시 이름입니다.
>
> **adaptive\_pricing\_enabled** `boolean` *required*
>
> 이 변형에 적응형 가격 책정이 활성화되어 있는지 여부입니다. 원시 설정값으로,
> 결제 처리업체 호환성이나 기능 플래그는 확인하지 않습니다.
>
> **allow\_multiple\_quantity** `boolean` *required*
>
> 한 주문에서 두 개 이상 구매할 수 있는지 여부입니다. 갱신 변형은 이를
> 활성화할 수 없습니다. `false`이면 결제, 장바구니, 인보이스에서 1을 초과하는
> 수량을 거부합니다.
>
> **attributes** `object | null` *required*
>
> 상품 내에서 이 변형을 구별하는 속성 값으로, 속성 이름을 값에 매핑한 맵입니다. 예: `\{"color": "Blue", "size": "Large"}`. 이름은 snake\_case 식별자이며 알파벳순으로 반환됩니다. 상품에서 속성을 가진 모든 변형은 동일한 속성 이름과 서로 다른 값 세트를 가지며, 상품은 전체 옵션 세트를 `variant_attributes`로 나열합니다. 변형에 속성이 없으면 `null`입니다.
>
> **billing\_period** `number | null` *required*
>
> 반복 청구 사이의 일수로, 예를 들어 월간은 30, 연간은 365입니다.
> 일회성 변형의 경우 `null`입니다.
>
> **billing\_type** `string` *required*
>
> 이 변형의 청구 모델입니다.
>
> 사용 가능한 옵션: `renewal`, `one_time`
>
> **cancel\_discount\_intervals** `number | null` *required*
>
> 취소 할인이 유지되는 기간입니다. `0`은 영구, `1`은 다음 결제에만 적용되며,
> 그 외에는 고객이 수락한 시점부터의 개월 수입니다. 제공되지 않거나 행위자에게
> `plan:basic:read` 스코프가 없으면 `null`입니다.
>
> **cancel\_discount\_percentage** `number | null` *required*
>
> 정수 백분율로 표시된 취소 할인입니다. 제공되지 않거나 행위자에게
> `plan:basic:read` 스코프가 없으면 `null`입니다.
>
> **checkout\_styling** `object | null` *required*
>
> 변형 수준의 결제 화면 스타일(`background_color`, `button_color`,
> `font_family`, `border_style`)입니다. `null`이면 계정 기본값을 상속합니다.
>
> **created\_at** `string` *required*
>
> 변형이 생성된 시각으로, ISO 8601 타임스탬프입니다.
>
> **currency** `string` *required*
>
> 이 변형의 모든 가격이 표시되는 통화의 소문자 세 글자 ISO 4217 코드입니다.
> 변형 자체의 통화이거나, 변형을 환산할 수 있는 경우 조회 시 요청한
> `presentment_currency`입니다.
>
> **custom\_fields** `object[]` *required*
>
> 결제 양식에서 수집하는 사용자 정의 입력 필드입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > `field_` 접두사가 붙은 사용자 정의 필드 ID입니다.
> >
> > **field\_type** `string` *required*
> >
> > 사용자 정의 필드의 입력 유형입니다.
> >
> > 사용 가능한 옵션: `text`
> >
> > **name** `string` *required*
> >
> > 결제 시 고객에게 표시되는 필드 레이블입니다.
> >
> > **order** `number` *required*
> >
> > 결제 양식에서의 필드 위치입니다.
> >
> > **placeholder** `string | null` *required*
> >
> > 빈 필드에 표시되는 플레이스홀더 텍스트입니다. 설정되지 않은 경우 `null`입니다.
> >
> > **required** `boolean` *required*
> >
> > 결제하려면 고객이 이 필드를 반드시 입력해야 하는지 여부입니다.
>
> **description** `string | null` *required*
>
> 고객에게 표시되는 변형 설명입니다. 최대 1000자입니다. 설명이 설정되지 않은 경우
> `null`입니다.
>
> **expiration\_days** `number | null` *required*
>
> 만료 기반 변형의 접근 기간(일)으로, 예를 들어 1년 이용권은 365입니다.
> 만료가 없는 변형의 경우 `null`입니다.
>
> **formatted\_price** `string` *required*
>
> `currency` 기준으로 표시용으로 포맷된 가격(통화 + 주기)입니다. 예:
> "\$10 / month".
>
> **image** `object | null` *required*
>
> 상품 페이지에 표시되는 가격 등급 이미지(`url`, `blurhash`)입니다. 이미지가
> 설정되지 않은 경우 `null`입니다.
>
> **initial\_price** `number` *required*
>
> `currency` 기준 초기 구매 가격입니다.
>
> **initial\_price\_due** `object` *required*
>
> 프로모션 코드와 세금 적용 전 결제 시 한 단위에 대해 청구되는 총액입니다. 반복 변형의 경우 `initial_price`에 첫 `renewal_price`를 더한 금액이고, 무료 체험이 적용되는 동안에는 `initial_price`만입니다. 조회하는 사용자가 이미 이 변형의 체험판을 사용한 경우 체험판이 적용되지 않습니다. `currency` 기준으로 표시됩니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **internal\_notes** `string | null` *required*
>
> 고객에게 표시되지 않는 비공개 메모입니다. 행위자가 변형 계정에 대한
> `plan:basic:read` 스코프를 보유하지 않으면 `null`입니다.
>
> **invoice** `object | null` *required*
>
> 이 변형이 생성된 인보이스입니다. 인보이스용으로 생성되지 않은 경우 `null`입니다.
>
> **member\_count** `number | null` *required*
>
> 이 변형을 통한 활성 멤버십 수입니다. 행위자가 변형 계정에 대한
> `plan:basic:read` 스코프를 보유하지 않으면 `null`입니다.
>
> **metadata** `object | null` *required*
>
> 변형에 저장된 사용자 정의 키-값 쌍입니다. 결제 및 멤버십 이벤트의 웹훅
> 페이로드에 포함됩니다. 최대 50개의 키, 키당 100자, 값당 500자입니다.
> 예약된 키 `custom_cta`와 `custom_cta_url`을 설정하면 이 변형에 대해
> 상품의 결제 행동 유도 문구를 재정의합니다.
>
> **offer\_cancel\_discount** `boolean | null` *required*
>
> 취소 할인이 제공되는지 여부입니다. 행위자가 변형 계정에 대한
> `plan:basic:read` 스코프를 보유하지 않으면 `null`입니다.
>
> **payment\_method\_configuration** `object | null` *required*
>
> 결제 수단 구성(`enabled`, `disabled`,
> `include_platform_defaults`)입니다. 변형이 기본 설정을 사용하는 경우 `null`입니다.
>
> **product** `object | null` *required*
>
> 이 변형이 속한 상품입니다. 독립 변형의 경우 `null`입니다.
>
> **purchase\_url** `string` *required*
>
> 고객이 이 변형을 직접 구매할 수 있는 URL입니다.
>
> **redirect\_url** `string | null` *required*
>
> 이 변형 결제 후 고객이 이동하는 위치입니다. 설정되지 않았거나, 행위자가 변형
> 계정에 대한 `plan:basic:read` 스코프를 보유하지 않으면
> `null`입니다.
>
> **release\_method** `string` *required*
>
> 이 변형의 판매 방식입니다.
>
> 사용 가능한 옵션: `buy_now`, `waitlist`
>
> **renewal\_price** `number` *required*
>
> `currency` 기준으로 청구 주기마다 청구되는 반복 가격입니다.
>
> **sku** `string | null` *required*
>
> 재고 관리 단위(SKU)로, 판매자가 설정한 자유 텍스트입니다(예: `TSHIRT-LARGE-BLUE`).
> 고유성이 강제되지 않습니다. 설정되지 않은 경우 `null`입니다.
>
> **split\_pay\_required\_payments** `number | null` *required*
>
> 구독이 일시 중지되기 전에 필요한 할부 결제 횟수입니다. 1보다 커야
> 합니다. 분할 결제가 구성되지 않은 경우 `null`입니다.
>
> **stock** `number | null` *required*
>
> 구매 가능한 수량입니다. 행위자가 변형 계정에 대한
> `plan:basic:read` 스코프를 보유하지 않으면 `null`입니다.
>
> **strike\_through\_initial\_price** `number | null` *required*
>
> 취소선과 함께 표시되는 원래 초기 가격으로, `currency` 기준입니다. 취소선 가격이
> 설정되지 않은 경우 `null`입니다.
>
> **strike\_through\_renewal\_price** `number | null` *required*
>
> 취소선과 함께 표시되는 원래 갱신 가격으로, `currency` 기준입니다. 취소선 가격이
> 설정되지 않은 경우 `null`입니다.
>
> **three\_ds\_level** `string | null` *required*
>
> 지원되는 온세션 카드 결제에 대한 3D Secure 동작입니다. `mandate_challenge`는 결제 처리 전에 3DS 챌린지를 요구하고, `mandate_if_required`는 결제 처리업체가 요구하는 경우에만 챌린지를 의무화하며, `frictionless_if_required`는 일반적인 마찰 없는 3DS 흐름을 사용합니다. \$1,000 이상의 결제는 `mandate_challenge`를 선택하지 않는 한 `mandate_if_required`를 사용합니다. 위험 및 인증 복구 요구 사항이 이 설정보다 우선할 수 있습니다. `null`이면 계정 기본값을 상속합니다.
>
> 사용 가능한 옵션: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`
>
> **title** `string | null` *required*
>
> 고객에게 표시되는 변형 표시 이름입니다. 최대 30자입니다. 제목 없이 생성된
> 변형은 기본적으로 속성 값을 `/`로 연결한 값을 사용합니다. 제목이 설정되지 않은
> 경우 `null`입니다.
>
> **trial\_period\_days** `number | null` *required*
>
> 첫 갱신 청구 전 무료 체험 일수입니다. 체험판이 구성되지 않았거나
> 사용자가 이미 이 변형의 체험판을 사용한 경우 `null`입니다.
>
> **unlimited\_stock** `boolean` *required*
>
> 변형의 재고가 무제한인지 여부입니다. `true`이면 `stock` 필드는
> 무시되며, 대기자 명단 변형은 항상 `true`를 보고합니다.
>
> **updated\_at** `string` *required*
>
> 변형이 마지막으로 업데이트된 시각으로, ISO 8601 타임스탬프입니다.
>
> **visibility** `string` *required*
>
> 이 변형이 표시되는 위치를 제어합니다. `hidden`이면 직접 링크로만 변형에 접근할 수 있습니다.
>
> 사용 가능한 옵션: `visible`, `hidden`, `archived`, `quick_link`

**verified** `boolean` *required*

Whop이 상품을 인증했는지 여부입니다.

**visibility** `string | null` *required*

상품이 공개, 숨김, 보관 상태 중 어느 것인지 나타냅니다.

```json Product theme={null}
{
	"id": "prod_xxxxxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"route": "pickaxe",
		"title": "Pickaxe"
	},
	"average_review_rating": 4.75,
	"created_at": "2023-12-01T05:00:00.401Z",
	"custom_cta": "get_access",
	"custom_cta_url": "https://example.com/signup",
	"custom_statement_descriptor": "PICKAXE",
	"default_variant": {
		"id": "plan_xxxxxxxxxxxxx",
		"billing_period": 30,
		"billing_type": "renewal",
		"expiration_days": null,
		"initial_price": {
			"amount": "29.00",
			"currency": "usd",
			"decimals": 2,
			"display_decimals": 2
		},
		"renewal_price": {
			"amount": "29.00",
			"currency": "usd",
			"decimals": 2,
			"display_decimals": 2
		},
		"title": "Pro / 5 seats",
		"trial_period_days": 7,
		"unlimited_stock": true,
		"visibility": "visible"
	},
	"description": "Track your revenue, members, and growth in real time.",
	"experiences": [
		{
			"id": "exp_xxxxxxxxxxxxxx",
			"app": {
				"id": "app_xxxxxxxxxxxxxx",
				"icon": {
					"url": "https://media.whop.com/abc123/icon.png"
				},
				"name": "Pickaxe Analytics"
			},
			"logo_url": null,
			"name": "Analytics dashboard"
		}
	],
	"external_identifier": "ext_prod_12345",
	"gallery_images": [
		{
			"id": "file_xxxxxxxxxxxxx",
			"content_type": "image/jpeg",
			"url": "https://media.whop.com/abc123/optimized.jpg"
		}
	],
	"global_affiliate_percentage": 6.9,
	"global_affiliate_status": "enabled",
	"headline": "Real-time data analytics for creators",
	"labels": ["analytics", "creator-tools"],
	"logo_url": "https://media.whop.com/abc123/logo.png",
	"marketplace_status": "live_marketplace",
	"member_affiliate_percentage": 6.9,
	"member_affiliate_status": "enabled",
	"member_count": 42,
	"metadata": {
		"external_product_id": "prod_123"
	},
	"owner_user": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	},
	"product_tax_code": {
		"id": "ptc_xxxxxxxxxxxxxx",
		"name": "Digital - SaaS",
		"product_type": "digital"
	},
	"published_reviews_count": 12,
	"route": "pickaxe-analytics",
	"title": "Pickaxe Analytics",
	"updated_at": "2023-12-01T05:00:00.401Z",
	"variant_attributes": {
		"seats": ["5", "10"],
		"tier": ["Pro", "Team"]
	},
	"variants": [
		{
			"id": "plan_xxxxxxxxxxxxx",
			"account": {
				"id": "biz_xxxxxxxxxxxxxx",
				"title": "Pickaxe"
			},
			"adaptive_pricing_enabled": true,
			"allow_multiple_quantity": false,
			"attributes": {
				"seats": "5",
				"tier": "Pro"
			},
			"billing_period": 30,
			"billing_type": "renewal",
			"cancel_discount_intervals": null,
			"cancel_discount_percentage": null,
			"checkout_styling": null,
			"created_at": "2023-12-01T05:00:00.401Z",
			"currency": "usd",
			"custom_fields": [
				{
					"id": "cusf_xxxxxxxxxxxx",
					"field_type": "text",
					"name": "Discord username",
					"order": 0,
					"placeholder": "e.g. pickaxe_user",
					"required": true
				}
			],
			"description": "Monthly access to Pickaxe Analytics.",
			"expiration_days": null,
			"formatted_price": "$29.00 / month",
			"image": null,
			"initial_price": 29,
			"initial_price_due": {
				"currency": "usd",
				"amount": "29.00",
				"decimals": 2,
				"display_decimals": 2
			},
			"internal_notes": "Standard monthly variant",
			"redirect_url": null,
			"invoice": null,
			"member_count": 42,
			"metadata": {
				"external_plan_id": "monthly",
				"custom_cta": "subscribe",
				"custom_cta_url": "https://example.com/wash-club"
			},
			"offer_cancel_discount": false,
			"payment_method_configuration": {
				"enabled": ["card"],
				"disabled": [],
				"include_platform_defaults": true
			},
			"product": {
				"id": "prod_xxxxxxxxxxxxx",
				"title": "Pickaxe Analytics"
			},
			"purchase_url": "https://whop.com/pickaxe-analytics/checkout/plan_xxxxxxxxxxxxx",
			"release_method": "buy_now",
			"renewal_price": 29,
			"sku": "PICKAXE-PRO-5-MONTHLY",
			"split_pay_required_payments": null,
			"stock": null,
			"strike_through_initial_price": null,
			"strike_through_renewal_price": null,
			"three_ds_level": "frictionless_if_required",
			"title": "Pro / 5 seats",
			"trial_period_days": 7,
			"unlimited_stock": true,
			"updated_at": "2023-12-01T05:00:00.401Z",
			"visibility": "visible"
		},
		{
			"id": "plan_yyyyyyyyyyyyy",
			"account": {
				"id": "biz_xxxxxxxxxxxxxx",
				"title": "Pickaxe"
			},
			"adaptive_pricing_enabled": true,
			"allow_multiple_quantity": false,
			"attributes": {
				"seats": "10",
				"tier": "Pro"
			},
			"billing_period": 30,
			"billing_type": "renewal",
			"cancel_discount_intervals": null,
			"cancel_discount_percentage": null,
			"checkout_styling": null,
			"created_at": "2023-12-01T05:00:00.401Z",
			"currency": "usd",
			"custom_fields": [
				{
					"id": "cusf_xxxxxxxxxxxx",
					"field_type": "text",
					"name": "Discord username",
					"order": 0,
					"placeholder": "e.g. pickaxe_user",
					"required": true
				}
			],
			"description": "Pro tier for up to 10 seats, billed monthly.",
			"expiration_days": null,
			"formatted_price": "$49.00 / month",
			"image": null,
			"initial_price": 49,
			"initial_price_due": {
				"currency": "usd",
				"amount": "49.00",
				"decimals": 2,
				"display_decimals": 2
			},
			"internal_notes": "Standard monthly variant",
			"redirect_url": null,
			"invoice": null,
			"member_count": 17,
			"metadata": {
				"external_plan_id": "pro-10"
			},
			"offer_cancel_discount": false,
			"payment_method_configuration": {
				"enabled": ["card"],
				"disabled": [],
				"include_platform_defaults": true
			},
			"product": {
				"id": "prod_xxxxxxxxxxxxx",
				"title": "Pickaxe Analytics"
			},
			"purchase_url": "https://whop.com/pickaxe-analytics/checkout/plan_yyyyyyyyyyyyy",
			"release_method": "buy_now",
			"renewal_price": 49,
			"sku": "PICKAXE-PRO-10-MONTHLY",
			"split_pay_required_payments": null,
			"stock": null,
			"strike_through_initial_price": null,
			"strike_through_renewal_price": null,
			"three_ds_level": "frictionless_if_required",
			"title": "Pro / 10 seats",
			"trial_period_days": 7,
			"unlimited_stock": true,
			"updated_at": "2023-12-01T05:00:00.401Z",
			"visibility": "visible"
		},
		{
			"id": "plan_zzzzzzzzzzzzz",
			"account": {
				"id": "biz_xxxxxxxxxxxxxx",
				"title": "Pickaxe"
			},
			"adaptive_pricing_enabled": true,
			"allow_multiple_quantity": false,
			"attributes": {
				"seats": "5",
				"tier": "Team"
			},
			"billing_period": 30,
			"billing_type": "renewal",
			"cancel_discount_intervals": null,
			"cancel_discount_percentage": null,
			"checkout_styling": null,
			"created_at": "2023-12-01T05:00:00.401Z",
			"currency": "usd",
			"custom_fields": [
				{
					"id": "cusf_xxxxxxxxxxxx",
					"field_type": "text",
					"name": "Discord username",
					"order": 0,
					"placeholder": "e.g. pickaxe_user",
					"required": true
				}
			],
			"description": "Team tier for up to 5 seats, billed monthly.",
			"expiration_days": null,
			"formatted_price": "$79.00 / month",
			"image": null,
			"initial_price": 79,
			"initial_price_due": {
				"currency": "usd",
				"amount": "79.00",
				"decimals": 2,
				"display_decimals": 2
			},
			"internal_notes": "Standard monthly variant",
			"redirect_url": null,
			"invoice": null,
			"member_count": 9,
			"metadata": {
				"external_plan_id": "team-5"
			},
			"offer_cancel_discount": false,
			"payment_method_configuration": {
				"enabled": ["card"],
				"disabled": [],
				"include_platform_defaults": true
			},
			"product": {
				"id": "prod_xxxxxxxxxxxxx",
				"title": "Pickaxe Analytics"
			},
			"purchase_url": "https://whop.com/pickaxe-analytics/checkout/plan_zzzzzzzzzzzzz",
			"release_method": "buy_now",
			"renewal_price": 79,
			"sku": "PICKAXE-TEAM-5-MONTHLY",
			"split_pay_required_payments": null,
			"stock": null,
			"strike_through_initial_price": null,
			"strike_through_renewal_price": null,
			"three_ds_level": "frictionless_if_required",
			"title": "Team / 5 seats",
			"trial_period_days": 7,
			"unlimited_stock": true,
			"updated_at": "2023-12-01T05:00:00.401Z",
			"visibility": "visible"
		},
		{
			"id": "plan_wwwwwwwwwwwww",
			"account": {
				"id": "biz_xxxxxxxxxxxxxx",
				"title": "Pickaxe"
			},
			"adaptive_pricing_enabled": true,
			"allow_multiple_quantity": false,
			"attributes": {
				"seats": "10",
				"tier": "Team"
			},
			"billing_period": 30,
			"billing_type": "renewal",
			"cancel_discount_intervals": null,
			"cancel_discount_percentage": null,
			"checkout_styling": null,
			"created_at": "2023-12-01T05:00:00.401Z",
			"currency": "usd",
			"custom_fields": [
				{
					"id": "cusf_xxxxxxxxxxxx",
					"field_type": "text",
					"name": "Discord username",
					"order": 0,
					"placeholder": "e.g. pickaxe_user",
					"required": true
				}
			],
			"description": "Team tier for up to 10 seats, billed monthly.",
			"expiration_days": null,
			"formatted_price": "$129.00 / month",
			"image": null,
			"initial_price": 129,
			"initial_price_due": {
				"currency": "usd",
				"amount": "129.00",
				"decimals": 2,
				"display_decimals": 2
			},
			"internal_notes": "Standard monthly variant",
			"redirect_url": null,
			"invoice": null,
			"member_count": 4,
			"metadata": {
				"external_plan_id": "team-10"
			},
			"offer_cancel_discount": false,
			"payment_method_configuration": {
				"enabled": ["card"],
				"disabled": [],
				"include_platform_defaults": true
			},
			"product": {
				"id": "prod_xxxxxxxxxxxxx",
				"title": "Pickaxe Analytics"
			},
			"purchase_url": "https://whop.com/pickaxe-analytics/checkout/plan_wwwwwwwwwwwww",
			"release_method": "buy_now",
			"renewal_price": 129,
			"sku": "PICKAXE-TEAM-10-MONTHLY",
			"split_pay_required_payments": null,
			"stock": null,
			"strike_through_initial_price": null,
			"strike_through_renewal_price": null,
			"three_ds_level": "frictionless_if_required",
			"title": "Team / 10 seats",
			"trial_period_days": 7,
			"unlimited_stock": true,
			"updated_at": "2023-12-01T05:00:00.401Z",
			"visibility": "visible"
		}
	],
	"verified": true,
	"visibility": "visible"
}
```
