엔드포인트
속성
상품 구매 페이지에 표시되는 행동 유도(CTA) 버튼 레이블입니다.사용 가능한 옵션:
get_access, join, order_now, shop_now, call_now, donate_now, contact_us, sign_up, subscribe, purchase, get_offer, apply_now, complete_order표시하고 결제에 사용할 구매 가능한 변형입니다. 구성된 기본 변형이 구매 가능하면 그 변형이고, 그렇지 않으면 상품 페이지 순서상 첫 번째 구매 가능한 변형입니다. 구매 가능한 변형이 없으면
null입니다.상품에 포함된 경험(코스, 채팅, 앱 등)으로, 가장 오래된 것이 먼저 나옵니다. 처음 100개만 포함하며, 나머지는
GET /experiences?product_id=로 페이지별로 조회하세요.속성
속성
whop.com 마켓플레이스의 등록 상태입니다.
pending_review는 제출되어 검토를 기다리는 중임을, live_marketplace는 승인되어 검색 가능함을 의미합니다.사용 가능한 옵션: not_available, pending_review, live_marketplace상품의 변형들이 아우르는 옵션 세트로, 속성 이름을 사용 중인 값에 매핑한 맵입니다. 예:
\{"color": ["Blue", "Red"], "size": ["S", "M", "L"]}. attributes를 가진 표시 상태의 비인보이스 변형에서 파생되며, 키는 알파벳순, 값은 변형이 생성된 순서입니다. 읽기 전용입니다. 상품에 변형이 없으면 null입니다.visibility가 visible이고 인보이스용으로 생성되지 않은 상품의 변형으로, 생성 순서대로 나열됩니다. 일반 가격 옵션은 attributes: null로 포함됩니다. 숨김, 보관, 퀵 링크, 인보이스 변형은 GET /variants를 통해 계속 조회할 수 있습니다. 상품의 변형이 1000개를 초과하는 경우(GET /variants?product_ids=로 페이지별 조회)와 웹훅 페이로드에서는 null입니다.속성
속성
한 주문에서 두 개 이상 구매할 수 있는지 여부입니다. 갱신 변형은 이를
활성화할 수 없습니다.
false이면 결제, 장바구니, 인보이스에서 1을 초과하는
수량을 거부합니다.상품 내에서 이 변형을 구별하는 속성 값으로, 속성 이름을 값에 매핑한 맵입니다. 예:
\{"color": "Blue", "size": "Large"}. 이름은 snake_case 식별자이며 알파벳순으로 반환됩니다. 상품에서 속성을 가진 모든 변형은 동일한 속성 이름과 서로 다른 값 세트를 가지며, 상품은 전체 옵션 세트를 variant_attributes로 나열합니다. 변형에 속성이 없으면 null입니다.취소 할인이 유지되는 기간입니다.
0은 영구, 1은 다음 결제에만 적용되며,
그 외에는 고객이 수락한 시점부터의 개월 수입니다. 제공되지 않거나 행위자에게
plan:basic:read 스코프가 없으면 null입니다.변형 수준의 결제 화면 스타일(
background_color, button_color,
font_family, border_style)입니다. null이면 계정 기본값을 상속합니다.이 변형의 모든 가격이 표시되는 통화의 소문자 세 글자 ISO 4217 코드입니다.
변형 자체의 통화이거나, 변형을 환산할 수 있는 경우 조회 시 요청한
presentment_currency입니다.프로모션 코드와 세금 적용 전 결제 시 한 단위에 대해 청구되는 총액입니다. 반복 변형의 경우
initial_price에 첫 renewal_price를 더한 금액이고, 무료 체험이 적용되는 동안에는 initial_price만입니다. 조회하는 사용자가 이미 이 변형의 체험판을 사용한 경우 체험판이 적용되지 않습니다. currency 기준으로 표시됩니다.속성
속성
변형에 저장된 사용자 정의 키-값 쌍입니다. 결제 및 멤버십 이벤트의 웹훅
페이로드에 포함됩니다. 최대 50개의 키, 키당 100자, 값당 500자입니다.
예약된 키
custom_cta와 custom_cta_url을 설정하면 이 변형에 대해
상품의 결제 행동 유도 문구를 재정의합니다.결제 수단 구성(
enabled, disabled,
include_platform_defaults)입니다. 변형이 기본 설정을 사용하는 경우 null입니다.이 변형 결제 후 고객이 이동하는 위치입니다. 설정되지 않았거나, 행위자가 변형
계정에 대한
plan:basic:read 스코프를 보유하지 않으면
null입니다.재고 관리 단위(SKU)로, 판매자가 설정한 자유 텍스트입니다(예:
TSHIRT-LARGE-BLUE).
고유성이 강제되지 않습니다. 설정되지 않은 경우 null입니다.지원되는 온세션 카드 결제에 대한 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고객에게 표시되는 변형 표시 이름입니다. 최대 30자입니다. 제목 없이 생성된
변형은 기본적으로 속성 값을
/로 연결한 값을 사용합니다. 제목이 설정되지 않은
경우 null입니다.Product

