Skip to main content
payment 모드에서는 특정 변형을 판매하고, setup 모드에서는 청구 없이 결제 정보를 수집하여 저장합니다. 각 구성은 해당 체크아웃에서 허용되는 결제 수단과 3D Secure 적용 방식을 재정의할 수도 있습니다. Checkout Configurations API를 사용하여 기존 또는 인라인 변형에 대한 체크아웃 링크를 생성하고, 계정의 구성을 조회하고, 체크아웃 URL에 연결된 구성을 조회하고, 더 이상 사용하지 않을 링크를 삭제할 수 있습니다.
레거시 Checkout configurations 리소스를 대체합니다. 기존 레거시 통합은 계속 작동합니다. 안정성 보장에 대해서는 API 버전을 참고하세요.

엔드포인트

속성

string
필수
체크아웃 구성 ID이며, 접두사는 ch_입니다.
string
필수
계정 ID이며, 접두사는 biz_입니다.
string | null
체크아웃 시 적용되는 제휴 코드이며, 설정되지 않은 경우 null입니다.
string
필수
체크아웃 구성이 생성된 시점으로, ISO 8601 타임스탬프입니다.
string | null
setup 모드에서 결제 수단 사용 가능 여부에 사용되는 통화입니다. 생략하면 기본값은 usd입니다.
object | null
이 구성으로 마운트된 체크아웃을 제어하는 구성으로, 모든 계층(자체 재정의, 변형의 재정의, 계정의 재정의)을 거쳐 결정됩니다. 세션의 payment_method_configuration과 같은 형태입니다. 결제 수단 유형 카탈로그에 적용하여 제공 가능한 집합을 구하세요. null은 플랫폼 기본값을 의미하며, payment_method_configuration은 이 구성 자체의 편집 가능한 재정의로 유지됩니다.

속성

string[]
명시적으로 비활성화된 결제 수단입니다.
string[]
명시적으로 활성화된 결제 수단입니다.
boolean
플랫폼 기본 결제 수단 포함 여부입니다.
object | null
결제와 멤버십에 복사되는 사용자 지정 키-값 메타데이터입니다. checkout_configuration:basic:read 범위가 없으면 null입니다.
string
필수
체크아웃 시 구매자에게 즉시 청구할지, 나중을 위해 결제 정보를 저장할지를 제어합니다.사용 가능한 옵션: payment, setup
object | null
이 체크아웃의 결제 수단 재정의입니다. 변형 또는 플랫폼 기본값을 사용하는 경우 null입니다.

속성

string[]
체크아웃에서 명시적으로 비활성화된 결제 수단입니다.
string[]
체크아웃에서 명시적으로 활성화된 결제 수단입니다.
boolean
플랫폼 기본 결제 수단 포함 여부입니다.
string | null
고객에게 보낼 수 있는 체크아웃 URL입니다.
string | null
체크아웃 후 고객이 이동하는 URL이며, 리디렉션이 구성되지 않은 경우 null입니다.
string | null
지원되는 온세션 카드 결제에 대한 3D Secure 동작입니다. mandate_challenge는 결제 처리 전에 3DS 챌린지를 요구하고, mandate_if_required는 결제 처리업체가 요구할 때에만 챌린지를 의무화하며, frictionless_if_required는 일반적인 프릭션리스 3DS 흐름을 사용합니다. $1,000 이상의 결제는 mandate_challenge를 선택하지 않는 한 mandate_if_required를 사용합니다. 위험 및 인증 복구 요구 사항이 이 설정보다 우선할 수 있습니다. setup 모드에 적용되며, null이면 프릭션리스 3DS를 사용합니다. payment 모드는 변형의 정책을 사용합니다.사용 가능한 옵션: mandate_challenge, mandate_if_required, frictionless_if_required
string
필수
체크아웃 구성이 마지막으로 업데이트된 시점으로, ISO 8601 타임스탬프입니다.
object | null
결제 체크아웃에 사용되는 변형입니다. setup 모드에서는 null입니다.

속성

string
필수
변형 ID이며, 접두사는 plan_입니다.
boolean
필수
이 변형이 적응형 가격 책정을 통해 현지 통화 결제를 허용하는지 여부입니다.
integer | null
필수
반복 청구 간격(일)으로, 월간은 30, 연간은 365 등입니다. 일회성 변형은 null입니다.
string
필수
변형의 청구 모델입니다.사용 가능한 옵션: renewal, one_time
string
필수
변형 가격의 세 글자 ISO 통화 코드입니다.
integer | null
필수
만료 기반 변형의 접근 기간(일)입니다.
number
필수
변형 통화 기준의 최초 구매 가격입니다.
string
필수
변형의 판매 방식입니다.사용 가능한 옵션: buy_now, waitlist
number
필수
각 청구 기간마다 청구되는 반복 가격입니다.
string | 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
integer | null
필수
첫 갱신 청구 전 무료 체험 일수입니다.
string
필수
변형이 고객에게 표시되는지 또는 공개 보기에서 숨겨지는지 여부입니다.사용 가능한 옵션: visible, hidden, archived, quick_link
CheckoutConfiguration