Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.10.0부터 지원. 엘리먼트를 마운트하지 않고 이 Checkout 리소스를 생성합니다. 바닐라 JS에서는 whop.checkout.checkoutSession.create({ … }), React에서는 useWhop().checkout.checkoutSession.create({ … })를 사용합니다.

옵션

다음 옵션을 whop.checkout.checkoutSession.create({ … })에 전달합니다.
string
필수
항목을 판매하는 계정 ID로, biz_ 접두사가 붙습니다.
CheckoutSessionLineItem[]
필수
구매자가 구매하는 항목입니다. 각 항목은 변형(plan_…)과 선택적 quantity(기본값 1)를 지정합니다. 여러 항목을 넣으면 장바구니가 됩니다.
string
필수
탭이 리디렉션된 경우 PayPal 이후 구매자가 도착하는 위치로, payment와 status가 추가됩니다. status는 succeeded, canceled, failed, 또는 Whop이 아직 청구를 마무리하는 동안에는 processing입니다(정산 결과를 확인하려면 서버에서 결제를 조회하세요). 데스크톱에서는 대신 팝업이 닫히고 show()가 settle됩니다.
Record<string, string>
최대 40개의 자체 문자열 키와 값으로, 체크아웃 세션에 보관되고 생성되는 결제에 복사됩니다. 따라서 결제와 해당 웹훅에 다시 포함되며, 광고 및 제휴 어트리뷰션 등에 활용할 수 있습니다. 구매자의 브라우저에서 설정되므로 가격이나 주문 이행에 절대 의존하지 마세요.
"off_session"
off_session으로 설정하면 구매자의 PayPal 계정을 저장하여, 나중에 서버가 구매자 없이 청구할 수 있습니다(예: 원클릭 업셀). PayPal은 구매자가 승인할 때 향후 결제에 동의하도록 요청합니다. 구매자에게 PayPal 계정이 저장된다는 사실을 알린 후에만 설정하세요.
string
결제와 멤버십이 속하는 구매자의 이메일입니다. 생략하면 승인하는 PayPal 계정의 이메일을 사용합니다.
CheckoutSessionPaymentMethodOptions
하나의 결제 수단에 대한 옵션입니다. paypal.requestShipping을 사용하면 PayPal이 구매자에게 배송 주소를 요청합니다. 계정에 shipping_address.changed를 구독한 활성화된 https 웹훅이 있으면 Whop은 각 주소마다 웹훅을 호출하고 응답받은 합계를 청구합니다. 기본값은 false입니다.

메서드

리소스에서 호출합니다.
show는 사용자 활성화 중에 동기적으로 호출하세요. 선행 작업은 먼저 await하세요.

load

lineItems로 체크아웃 세션을 생성합니다. 다시 호출하면 같은 세션을 반환합니다. 아직 로드되지 않았다면 show()가 먼저 로드합니다. terms는 구매자가 결제함으로써 동의하는 내용입니다. 버튼 옆에 links(판매자가 게시한 정책과 Whop 구매자 약관)를 표시하고, terms.required가 true이면 체크박스 등으로 구매자가 적극적으로 동의하도록 하세요. requirements는 세션을 결제하기 전에 필요한 항목을 나열합니다. email, terms, 그리고 paypal.requestShipping 사용 시 shipping_address 외의 항목은 여기서 수집할 수 없으므로 show()가 거부합니다. 반환값 Promise<CheckoutSessionLoaded>
string
필수
string
필수
string[]
필수
CheckoutSessionTerms
필수

show

PayPal 버튼의 클릭 핸들러에서 동기적으로 호출하세요. 데스크톱에서는 그 자리에서 팝업을 열며, 나중에 열린 팝업은 차단됩니다. termsAccepted: true는 이번 클릭에 대해 load()의 terms.links가 버튼 옆에 표시되었고, terms.required가 true인 경우 구매자가 적극적으로 동의했을 때만 전달하세요. 구매자가 승인하고 Whop이 청구하면 { payment }와 함께 resolve됩니다. 다음과 같은 code의 오류와 함께 reject됩니다: termsAccepted 없이 호출하면 attestation_required, 세션에 PayPal이 수집할 수 없는 항목이 필요하면 requirements_unsupported(load()의 requirements 참고), 구매자가 PayPal을 취소하거나 닫으면 payment_request_cancelled, 계정이 웹훅을 통해 이 결제의 가격을 책정할 수 없으면 seller_pricing_unavailable(자체 세금을 처리하지 않거나, 장바구니에 프로모션 코드, 구매자 수수료, 마켓플레이스 분할 또는 갱신되는 플랜이 있는 경우), 그 외에는 payment_failed. 휴대폰에서는 탭이 PayPal로 이동하며 promise는 settle되지 않습니다. 사용자 활성화 중에 동기적으로 호출하세요. 브라우저는 비동기 단계를 거치면 활성화를 취소하므로 선행 작업은 먼저 await하세요. 매개변수
"paypal"
필수
CheckoutSessionShowOptions
반환값 Promise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
필수