Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원.
Payments 안에 마운트됩니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다.
WhopPayments 스코프 안에 마운트됩니다. 값 필드 옆에 등록 유형 선택기가 있으며, 구매자의 국가에 따라 미리 선택됩니다.
청구와 확인 토큰을 소유하는 <Payments> 안에 마운트합니다. <Payments> 자체는 <WhopElements> 안에 마운트됩니다. 값 입력란 옆에 등록 유형 선택기가 있어, VAT 또는 CUIT 번호를 입력하는 구매자가 먼저 올바른 유형을 고를 수 있습니다.

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

Props

boolean
호스트가 마지막으로 확정된 등록 정보를 저장하는 동안 두 필드를 모두 비활성화합니다. 기본값은 false입니다.
string
유형을 미리 선택하는 데 사용되는 ISO 3166-1 alpha-2 구매자 국가입니다. AR은 ar_cuit, LI는 li_uid를 선택합니다. EU 국가와 매핑되지 않았거나 비어 있는 값은 eu_vat를 선택합니다. 그 외 매핑된 국가는 해당 국가의 첫 번째 유형을 선택합니다. 수동으로 선택한 유형은 국가가 바뀌어도 유지됩니다. 기본값은 ""입니다.
object
재개된 세션의 초기 type과 value입니다. 지원되지 않는 type은 국가 기본값으로 대체됩니다.
string
값 입력란 아래에 표시되는 API 유효성 검사 오류입니다. 비어 있으면(기본값) 아무것도 표시하지 않습니다. 기본값은 ""입니다.

이벤트

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

onChange

값이 비어 있지 않을 때 포커스를 잃거나 Enter를 누르면 실행되며, 값이 있는 상태에서 유형이 바뀔 때도 실행됩니다. 동일한 값이 연속되면 한 번만 실행됩니다. 값을 지워도 실행되지 않습니다. 저장된 등록 정보는 호스트가 지워야 합니다.
object

onLoaderStart

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

onReady

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

onError

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

메서드

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

mount

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

destroy

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

update

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

스타일링

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

매개변수

Binding<WhopTaxID?>?
확정된 각 등록 정보를 받습니다.
String?
유형을 미리 선택하는 데 사용되는 ISO 3166-1 alpha-2 구매자 국가입니다.
WhopTaxID?
재개된 세션의 초기 쌍입니다. 지원되지 않는 유형은 기본값으로 대체됩니다.
Bool
마지막으로 확정된 등록 정보를 저장하는 동안 두 필드를 모두 비활성화합니다. 기본값은 false입니다.
String?
값 입력란 아래에 표시되는 API 유효성 검사 오류입니다.

WhopTaxID

선택 시 반환되는 값:
  • type: WhopTaxIDType: 등록 유형(eu_vat, ar_cuit, …)
  • value: String: 등록 정보 자체

상태

즉시 렌더링됩니다. 선택한 유형의 형식과 일치하지 않는 값은 해당 오류를 표시합니다. error는 값 필드 아래에 API 유효성 검사 실패를 렌더링합니다.

알아두면 좋은 점

  • AR은 ar_cuit를 미리 선택하고, EU 회원국과 매핑되지 않은 모든 값은 eu_vat를 미리 선택합니다. 수동으로 선택한 유형은 국가가 바뀌어도 유지됩니다.
  • 두 엘리먼트가 서로 맞춰지도록 주소 엘리먼트의 국가를 전달하세요.
  • 바인딩은 키 입력마다가 아니라 등록 정보가 확정될 때마다 실행됩니다.

설치

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

Props

string
유형을 미리 선택하는 데 사용되는 ISO 3166-1 alpha-2 구매자 국가입니다. AR은 ar_cuit를 선택하고, EU 및 매핑되지 않은 값은 eu_vat를 선택합니다.
{ type: string; value: string }
재개된 세션의 초기 쌍입니다. 지원되지 않는 유형은 기본값으로 대체됩니다.
boolean
마지막으로 확정된 등록 정보를 저장하는 동안 두 필드를 모두 비활성화합니다.
string
값 입력란 아래에 표시되는 API의 유효성 검사 메시지입니다.
(payload: TaxIdChangePayload) => void
유형이나 값이 바뀔 때마다 실행됩니다.
StyleProp<ViewStyle>
엘리먼트의 외부 View에 적용됩니다. 테마 지정에는 이 화면의 모든 엘리먼트에 적용되는 프로바이더의 appearance.parts를 사용하는 것이 좋습니다. 현재 React Native 파트 이름은 웹의 whop-* 클래스 이름과 별개의 체계이므로, 웹 appearance 객체를 그대로 옮겨 쓸 수 없습니다.
ReactNode
엘리먼트가 로드되는 동안 기본 스켈레톤 대신 렌더링됩니다.
() => void
엘리먼트가 상호작용 가능해지면 한 번 실행됩니다. <Payments>가 이를 그룹화하므로 보통은 <Payments> 자체의 onLoadingChange를 사용하는 것이 좋습니다.
(error: { message: string; code?: string }) => void
이 엘리먼트의 로드 또는 구성 실패입니다. 어떤 경우든 엘리먼트는 자체 오류 화면을 렌더링합니다.

TaxIdChangePayload

onChange가 반환하는 값:
  • taxId: { type: TaxIdType; value: string }: 선택한 등록 유형과 구매자가 입력한 내용

상태

즉시 렌더링됩니다. 유형은 country에 따라 미리 선택되며, 값 입력란은 해당 유형의 형식에 맞는지 검사합니다. onChange는 현재 쌍과 함께 실행됩니다.

알아두면 좋은 점

  • country는 미리 선택만 합니다. 구매자가 유형을 직접 선택하면 국가가 바뀌어도 그 선택이 유지됩니다.
  • 자체 API 유효성 검사 메시지를 값 입력란 아래에 표시하려면 error를 전달하세요.
  • 엘리먼트는 쌍을 보고할 뿐이며, 전송은 직접 처리해야 합니다. 자체 주문 또는 고객 레코드에 첨부하세요.
앱을 <WhopElements getToken={…}>로 한 번 감싼 다음, 엘리먼트를 <Payments>로 감싸 마운트하세요. 시작하기 및 Appearance를 참고하세요.