Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원.
Payments 안에 마운트됩니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다.
필수. Payments 핸들의 다른 엘리먼트는 AddressElement, EmailElement, TaxIdElement를 제외하고 BrandingElement가 마운트될 때까지 로딩 상태로 유지됩니다. 함께 마운트하세요.
WhopPayments 스코프 안에 마운트됩니다. 모든 결제 화면에 반드시 포함되어야 하는 판매 대행자 고지 문구이며, Whop 워드마크가 패스로 그려집니다.
청구와 확인 토큰을 소유하는 <Payments> 안에 마운트합니다. <Payments> 자체는 <WhopElements> 안에 마운트됩니다. 결제 정보를 수집하는 모든 양식에 필수입니다. 마운트되지 않은 동안 createConfirmationToken은 거부되며, 양식의 나머지 부분과 같은 테마가 적용됩니다.

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

Props

이 엘리먼트는 사용자 props를 받지 않습니다.

이벤트

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

onLoaderStart

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

onReady

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

onError

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

메서드

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

mount

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

destroy

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

update

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

스타일링

이 엘리먼트는 스타일링용 클래스 이름을 노출하지 않습니다. 스타일을 변경하려면 appearance(테마, 강조 색상, 변수)를 사용하세요.

상태

즉시 렌더링됩니다. 아무것도 가져오지 않으며 실패 상태가 없습니다.

알아두면 좋은 점

  • 마운트되지 않은 동안 createConfirmationToken은 거부됩니다. Whop은 이러한 판매의 판매 대행자이므로 구매자가 결제하는 화면에서 이 사실을 알려야 합니다.
  • 워드마크는 에셋이 아닌 벡터 패스이므로 프레임워크에 이미지 번들이 포함되지 않습니다.

설치

컨트롤러를 생성하여 콘텐츠에 전달하는 WhopPayments(accountID:charge:) 스코프 안에 마운트하세요. 이메일 로그인으로 구매자가 확인되면 payments.buyer는 로그인한 구매자입니다. Whop은 이러한 판매의 판매 대행자이며 createConfirmationToken은 WhopBrandingElement 없이는 거부되므로, 이 엘리먼트도 화면에 있어야 합니다. 스타일은 .whopElementsAppearance(_:)로 지정합니다. 모듈은 지갑 SDK의 WhopElements가 아니라 Elements입니다. 시작하기 및 Appearance를 참고하세요.

Props

StyleProp<ViewStyle>
엘리먼트의 외부 View에 적용됩니다. 테마 지정에는 이 화면의 모든 엘리먼트에 적용되는 프로바이더의 appearance.parts를 사용하는 것이 좋습니다. 현재 React Native 파트 이름은 웹의 whop-* 클래스 이름과 별개의 체계이므로, 웹 appearance 객체를 그대로 옮겨 쓸 수 없습니다.
ReactNode
엘리먼트가 로드되는 동안 기본 스켈레톤 대신 렌더링됩니다.
() => void
엘리먼트가 상호작용 가능해지면 한 번 실행됩니다. <Payments>가 이를 그룹화하므로 보통은 <Payments> 자체의 onLoadingChange를 사용하는 것이 좋습니다.
(error: { message: string; code?: string }) => void
이 엘리먼트의 로드 또는 구성 실패입니다. 어떤 경우든 엘리먼트는 자체 오류 화면을 렌더링합니다.

상태

즉시 렌더링됩니다. 불러올 데이터가 없으며 자체 상태도 없습니다.

알아두면 좋은 점

  • 필수입니다. BrandingElement가 마운트되지 않은 동안 createConfirmationToken은 BrandingRequiredError와 함께 거부됩니다. 웹 엘리먼트가 브랜딩이 연결될 때까지 표시를 보류하는 것과 같습니다.
  • <Payments> 안의 아무 곳에나 한 번 마운트하세요. 보통 제출 버튼 아래에 둡니다.
  • 워드마크는 결정된 테마의 라이트 또는 다크 모드를 자동으로 따릅니다.
앱을 <WhopElements getToken={…}>로 한 번 감싼 다음, 엘리먼트를 <Payments>로 감싸 마운트하세요. 시작하기 및 Appearance를 참고하세요.