Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원.
Checkout 안에 마운트됩니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다.
배타적. ExpressCheckoutElement는 이 Checkout 핸들에서 CheckoutElement의 대안입니다. 한 번에 하나만 마운트하세요. 다른 엘리먼트를 마운트하기 전에 제거하세요.
<Checkout> 안에 마운트합니다. <Checkout>은 plan, items 또는 checkoutConfiguration으로 체크아웃 세션을 열고 자격 증명을 내부에만 보관합니다. <Checkout> 자체는 <WhopElements> 안에 마운트됩니다. 버튼을 한 번 누르는 것으로 구매가 완료되며, 서버에 전달할 확인 토큰은 없습니다.

예시 데이터입니다. Playground 열기.

Props

object | ("apple_pay" | "google_pay" | "paypal_express")[]
배열 형식의 wallets는 더 이상 권장되지 않으며 다음 메이저 버전에서 제거됩니다. 대신 "auto" 또는 "never" 값과 함께 { applePay, googlePay, payPal }을 전달하세요.
렌더링할 수 있는 지갑입니다. 해당 버튼을 제외하려면 applePay, googlePay, 또는 payPal을 'never'로 설정하세요. 각 키의 기본값은 'auto'로, 구매자의 기기와 판매자가 실제로 제공하는 항목을 기준으로 필터링합니다. 엘리먼트는 기기, 제공된 매트릭스 또는 체크아웃의 결제 수단 구성이 지원하지 않는 지갑을 절대 표시하지 않으며, 렌더링 순서는 가장 적합한 네이티브 지갑이 먼저이고 PayPal이 마지막입니다. 지갑 유형 목록(['apple_pay', 'google_pay'])도 허용 목록으로 계속 받지만 더 이상 권장되지 않으며 다음 메이저 버전에서 제거됩니다. 빈 목록은 아무것도 렌더링하지 않습니다(개발 빌드에서 경고). 모든 지갑은 Domains API를 통해 페이지 도메인에 Apple Pay가 준비되어 있어야 합니다. 퍼스트 파티 whop.com 페이지는 사전 승인되어 있으며, 그 외 사이트에서는 도메인에 Apple Pay를 추가하지 않으면 버튼이 숨겨진 상태로 유지됩니다. 자체 사이트에서 Google Pay를 제공하는 경우 Google Pay API 서비스 약관이 적용됩니다. 기본값은 {}입니다.
"auto" | "horizontal" | "vertical"
버튼을 배치하는 방식입니다. auto는 엘리먼트 자체 컨테이너를 따라 좁은 컨테이너에서는 세로로 쌓고, 넓은 컨테이너에서는 가로로 나란히 배치합니다. horizontal과 vertical은 한 가지 배치를 강제합니다. 기본값은 "auto"입니다.

이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

onLoaderStart

로딩 스켈레톤이 처음 그려진 후, onReady 전에 실행됩니다.

onReady

엘리먼트가 처음으로 완전히 그려진 후 실행됩니다.

onError

엘리먼트가 로드에 실패하거나 충돌할 때 실행됩니다. 대체 화면은 계속 표시됩니다. 프로그래밍 방식으로 처리하려면 code를 사용하세요. sourceKey는 실패한 호스트 상태 소스를 식별합니다.
object

메서드

create가 반환한 핸들에서, 또는 React ref를 통해 호출합니다.

mount

target에 엘리먼트를 마운트하고 로딩을 시작합니다. React 컴포넌트는 자동으로 마운트됩니다.매개변수
string | HTMLElement
필수

destroy

엘리먼트를 제거하고 프레임과 구독을 해제합니다. 여러 번 호출해도 됩니다. React는 엘리먼트를 자동으로 제거합니다.

update

마운트된 엘리먼트에 새 props를 병합합니다. React에서는 대신 컴포넌트 props를 변경하세요.매개변수
Partial<ExpressCheckoutElementProps>
필수

스타일링

appearance.classes를 통해 다음 부분의 스타일을 지정합니다. 속성 이름은 카멜 케이스 또는 케밥 케이스를 사용하고 단위를 포함하세요. 페이지 스타일시트는 엘리먼트의 프레임에 적용되지 않습니다. 프레임워크는 각 선언을 삽입하기 전에 유효성을 검사합니다.
React에서는 appearance를 <Checkout>에 전달합니다. 전역으로 설정하려면 WhopElements({ appearance })를 사용하세요.

Props

('apple_pay' | 'google_pay')[]
렌더링할 수 있는 지갑으로, 기기가 제공하는 항목을 기준으로 필터링합니다. 엘리먼트는 기기, 계정 또는 체크아웃의 결제 수단 구성이 지원하지 않는 지갑을 절대 표시하지 않습니다. 빈 목록은 아무것도 렌더링하지 않습니다. 기본값은 둘 다입니다.
StyleProp<ViewStyle>
엘리먼트의 외부 View에 적용됩니다. 테마 지정에는 이 화면의 모든 엘리먼트에 적용되는 프로바이더의 appearance.parts를 사용하는 것이 좋습니다. 현재 React Native 파트 이름은 웹의 whop-* 클래스 이름과 별개의 체계이므로, 웹 appearance 객체를 그대로 옮겨 쓸 수 없습니다.
ReactNode
엘리먼트가 로드되는 동안 기본 스켈레톤 대신 렌더링됩니다.
() => void
엘리먼트가 안정되면 한 번 실행됩니다. 즉, 버튼이 표시되었거나 엘리먼트가 아무것도 렌더링하지 않는다는 것을 알게 된 시점입니다. <Checkout>이 이를 기다리므로 보통은 <Checkout> 자체의 onLoadingChange를 사용하는 것이 좋습니다.
(error: { message: string; code?: string }) => void
이 엘리먼트의 로드 또는 구성 실패입니다. 어떤 경우든 엘리먼트는 자체 오류 화면을 렌더링합니다.

상태

세션이 열리고 기기에 결제 가능 여부를 확인하는 동안 스켈레톤 알약 하나가 표시되고, 이후 Powered by Whop 안내 위에 플랫폼 자체의 Apple Pay 또는 Google Pay 버튼이 표시됩니다. 지갑이 없는 기기, 체크아웃의 결제 수단 구성에서 비활성화된 지갑, 품절되었거나 보관된 플랜은 아무것도 렌더링하지 않습니다. 시트로 제대로 마무리할 수 없는 체크아웃(설정, 대기자 명단 가입, 이전, 페이지에서만 물을 수 있는 양식 질문)은 설명 화면을 렌더링하고 onError를 통해 EXPRESS_CHECKOUT_UNAVAILABLE을 보고합니다. 구매 후 엘리먼트는 결과를 표시합니다. 완료, 처리 중, 또는 결제에 아직 구매자의 조치가 필요하면 Finish payment 또는 Try again 버튼이 표시됩니다.

알아두면 좋은 점

  • 기기는 하나의 지갑을 제공합니다. iOS에서는 Apple Pay, Android에서는 Google Pay입니다. 그래서 여기에는 layout prop이 없습니다. 배치할 두 번째 버튼이 없기 때문입니다.
  • 시트는 세션에 아직 필요한 항목을 수집합니다. 세션에 이메일이 없으면 이메일, 판매자가 수집하는 경우 전화번호, 실물 상품의 경우 배송 주소입니다. 전화번호를 인증하는 판매자의 경우 시트가 닫힌 후 네이티브 모달에서 코드 입력 단계가 진행됩니다.
  • iOS에서는 구매자가 카드를 변경하면 시트가 가격을 다시 계산하므로 세금이 청구지 주소를 따르며, 판매자가 코드를 허용하면 프로모션 코드 필드를 제공합니다. Google의 Android 시트는 체크아웃 합계를 표시하며 코드 필드가 없습니다.
  • 앱은 절대 이동되지 않습니다. 구매가 확정되면 <Checkout>의 onComplete가 sessionId 및 receiptId와 함께 한 번 실행되며, 이 시점에 구매자를 다음 화면으로 이동시키면 됩니다. 주문 이행은 이 콜백이 아니라 웹훅에서 처리하세요.
  • 3D Secure 및 기타 외부 단계는 iOS에서는 ASWebAuthenticationSession, Android에서는 Custom Tabs로 열리며, 엘리먼트는 결제가 안정될 때까지 폴링합니다. <Checkout>의 returnUrl은 직접 호스팅하는 https URL이어야 합니다.
  • 모든 <Checkout> 옵션은 생성 시점에 고정됩니다. 마운트 후 옵션을 변경하면 CHECKOUT_OPTIONS_FROZEN이 보고되고 원래 주문이 유지됩니다. 다른 상품을 판매하려면 <Checkout>에 새 key를 지정하세요.
앱을 <WhopElements getToken={…}>로 한 번 감싼 다음, 엘리먼트를 <Checkout>으로 감싸 마운트하세요. <Checkout>은 plan, items, checkoutConfiguration, quantity, promoCode, affiliateCode, attribution, metadata, returnUrl과 함께 onComplete, onError, onLoadingChange, fallback을 받습니다. 시작하기 및 Appearance를 참고하세요.