plan_ 접두사를 사용합니다.
Variants API를 사용하여 상품의 변형을 생성하고, 기존 변형을 나열하고, 변형 구성을 조회하거나 업데이트하고, 결제를 위한 세금을 계산하고, 더 이상 제공하지 않을 변형을 삭제하세요.
엔드포인트
속성
한 주문에서 두 개 이상의 단위를 구매할 수 있는지 여부. 갱신 변형에서는 활성화할 수 없습니다.
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이면 계정 기본값을 상속합니다.이 변형의 모든 가격이 표시되는 통화의 소문자 3자리 ISO 4217 코드: 변형 자체의 통화, 또는 변형을 변환할 수 있는 경우 조회 시 요청한
presentment_currency.변형을 삭제할 수 있는지 여부(멤버십이나 대기자 명단 항목이 없는 경우). 행위자가 변형 계정에 대한
plan:basic:read 범위를 가진 경우가 아니면 null입니다.모든 계층(변형 자체 및 계정)을 거쳐 해석된, 이 변형의 결제를 관리하는 구성으로, 세션의
payment_method_configuration이 가지는 형태입니다. 제공 가능한 집합을 얻으려면 결제 수단 유형 카탈로그에 적용하세요. null은 플랫폼 기본값을 의미하며, payment_method_configuration은 변형 자체의 편집 가능한 재정의로 유지됩니다.프로모 코드와 세금 적용 전, 한 단위에 대해 결제 시 청구되는 총액: 반복 변형의 경우
initial_price에 첫 번째 renewal_price를 더한 값, 또는 무료 체험이 적용되는 동안에는 initial_price만. 조회하는 사용자가 이미 이 변형의 체험을 사용한 경우 체험은 적용되지 않습니다. currency 기준입니다.속성
속성
변형에 저장된 커스텀 키-값 쌍. 결제 및 멤버십 이벤트의 웹훅 페이로드에 포함됩니다. 최대 50개 키, 키당 100자, 값당 500자. 예약된 키
custom_cta와 custom_cta_url이 설정되면 이 변형에 대해 상품의 결제 콜투액션을 재정의합니다.고객이 이 변형을 결제한 후 이동하는 곳. 설정되지 않았거나, 행위자가 변형 계정에 대한
plan:basic:read 범위를 가진 경우가 아니면 null입니다.세금이 가격에 포함되는지, 결제 시 추가되는지, 또는 구성되지 않았는지를 포함하여 이 변형의 세금 처리 방식.사용 가능한 옵션:
inclusive, exclusive, unspecified지원되는 온세션 카드 결제에 대한 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입니다.이 변형에 대해 발행되었지만 결제되거나 무효화되지 않은 인보이스 수. 이 값이
0보다 큰 동안에는 변형의 가격, 청구 기간, 체험, 결제 횟수, 통화 또는 청구 유형을 변경할 수 없습니다. 행위자가 변형 계정에 대한 plan:basic:read 범위를 가진 경우가 아니면 null입니다.Variant

