Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원.
Payments 안에 마운트됩니다. 생성하여 핸들을 얻은 다음, 그 핸들에서 엘리먼트를 마운트합니다. destroy()를 호출하면 하위 컨트롤러가 제거되고 슬롯이 해제됩니다. 새 핸들이 필요하면 다시 생성하세요.
배타적. CardFields는 이 Payments 핸들에서 PaymentElement 또는 CardElement의 대안입니다. 한 번에 하나만 마운트하세요. 다른 엘리먼트를 마운트하기 전에 제거하세요.

미리보기

예시 데이터로 이 하위 컨트롤러의 기본 배치를 보여주는 실시간 인터랙티브 데모입니다.
WhopPayments 스코프 안에 마운트됩니다. WhopCardElement와 동일한 세 개의 호스팅 입력을 콘텐츠 빌더 안에 하나씩 배치하므로, 각 필드의 위치는 직접 만든 레이아웃이 결정합니다.
개별적으로 배치되는 카드 필드를 위한 프로바이더입니다. 필드가 들어갈 폼 영역을 감싼 다음, CardNumberElement, CardExpiryElement, CardCvcElement를 레이아웃에서 원하는 위치에 배치하세요.

미리보기

React Native 예제 앱에서 실행 중인 모습:

옵션

payments.create('cardFields', { … })에 전달하거나, React에서는 <CardFields>의 props로 전달합니다. 부모가 주입하는 props는 여기에 표시되지 않습니다.
CardNetworkArt[]
판매자가 허용하는 카드 네트워크를 표시 순서대로 나열한 값입니다. 매트릭스 카드 항목의 networks 객체이며, API가 제공하는 아이콘이 번호 필드의 브랜드 아트를 결정합니다. 생략하면 키와 함께 가져옵니다.
"compact" | "stacked"
stacked(기본값)는 함께 구성된 필드를 번호 행이 만료일 및 보안 코드 위에 오도록 배치합니다. compact는 한 줄로 배치합니다. 별도로 마운트된 필드는 이 레이아웃을 무시하고 전체 테두리와 둥근 모서리로 렌더링됩니다. 기본값은 "stacked"입니다.
string
고급 Basis Theory 퍼블리셔블 키입니다. 생략하면 키를 자동으로 가져옵니다.

이벤트

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

onChange

완료 상태가 변경될 때 실행됩니다. 구매자가 세 필드를 모두 채우면 complete가 true가 됩니다. 이를 사용해 확인 버튼을 활성화하세요. brand는 필드가 보고하는 감지된 카드 네트워크이고, network는 동일한 감지 결과를 API의 네트워크 용어로 나타낸 값입니다(매트릭스 카드 항목의 networks와 일치하며, 알 수 없는 동안에는 null). last4는 번호의 마지막 네 자리이며, 번호가 충분히 입력되기 전까지는 null입니다. funding은 감지된 자금 유형(credit, debit, prepaid)이며, 번호로 식별되기 전까지는 null입니다. issuingCountry는 카드가 발급된 국가의 소문자 두 글자 코드이며, 번호로 식별되기 전까지는 null입니다.
object

메서드

payments.create('cardFields', { … })에서 반환된 하위 핸들에서 호출합니다.

tokenize

확인 토큰을 생성하지 않고 세 필드를 토큰화하는 고급 메서드입니다. payments 컨트롤러에 tokenized를 전달합니다. 유효성 검사 오류는 실패한 필드에 표시되며, 메서드는 예외를 발생시킵니다. 결제를 확인하려면 payments.createConfirmationToken()을 사용하세요.매개변수
object
필수
반환값 Promise<object>
string
필수

collect

payments.createConfirmationToken()이 cardFields에 대해 이 액션을 호출합니다. 직접 호출하지 마세요. 필드를 토큰화하고 확인 토큰 생성에 사용되는 데이터를 반환합니다.매개변수
object
필수
반환값 Promise<object>
object
필수
object
필수

update

하위 컨트롤러에 새 props와 콜백을 병합합니다.매개변수
Partial<CardFieldsSubOptions>
필수

destroy

하위 컨트롤러와 그 엘리먼트를 제거한 다음, 배타적 슬롯을 해제합니다. 이후의 create("cardFields")는 새로 시작합니다.

매개변수

String?
고급 퍼블리셔블 키입니다. 생략하면 계정 자체의 키를 가져옵니다.
WhopCardElement.Layout
구성 단위가 필드를 직접 배치할 때만 읽힙니다. 별도로 마운트된 필드는 이를 무시합니다.
Binding<WhopCardState>?
완료 여부와 감지된 브랜드를 다시 읽어옵니다.
() -> Content
필수
세 개의 필드 뷰가 들어갈 곳입니다. 여기에 넣은 다른 요소는 평소처럼 렌더링됩니다.

WhopCardState

선택 시 반환되는 값:
  • isComplete: Bool: 세 필드가 모두 유효함
  • brand: String?: 감지된 네트워크

상태

각 필드는 즉시 렌더링되며 구매자가 입력하는 동안 유효성을 검사합니다. 필드를 어디에 배치하든 세 필드가 모두 유효하면 state.isComplete가 true가 됩니다.

알아두면 좋은 점

  • 세 개의 필드 뷰는 WhopCardFields 빌더 안에서만 작동합니다. 빌더가 생성하는 단위를 읽기 때문입니다. 다른 곳에 마운트하면 아무것도 렌더링되지 않습니다.
  • 세 필드를 모두 마운트하세요. 하나라도 빠진 단위는 완료되지 않으므로 확인 버튼이 활성화되지 않습니다.

설치

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

Props

ReactNode
필수
세 개의 필드 엘리먼트가 내부 어딘가에 포함된 레이아웃입니다.
string
고급 토크나이저 퍼블리셔블 키입니다. 생략하면 SDK가 계정의 키를 직접 가져옵니다.
'stacked' | 'compact'
함께 구성된 필드의 배치를 결정합니다. 별도로 마운트된 필드는 이를 무시하고 전체 테두리로 렌더링됩니다. 기본값은 stacked입니다.
(payload: CardFieldsChangePayload) => void
편집할 때마다 마운트된 필드의 통합 상태와 함께 실행됩니다.

CardFieldsChangePayload

onChange가 반환하는 값:
  • complete: boolean: 마운트된 모든 필드가 채워지고 유효함
  • errors: Record<string, string>: 필드별 메시지이며, 키는 cardNumber, cardExpiry, cardCvc

상태

퍼블리셔블 키가 확인되면 자식 요소가 렌더링됩니다. onChange는 마운트된 모든 필드의 통합 상태를 보고하므로, 하나의 핸들러로 카드 전체를 처리할 수 있습니다.

알아두면 좋은 점

  • 카드 번호는 절대 사용자 코드를 거치지 않습니다. 필드는 PCI로 격리된 네이티브 입력이며 SDK가 Whop에 토큰을 전달하므로, 앱은 PCI 범위 밖에 머무릅니다.
  • 모든 필드는 같은 CardFields 안에 있어야 합니다. 필드들은 하나의 토큰화를 공유하므로, 그 밖에 마운트된 필드는 아무것도 수집하지 않습니다.
  • CardFields가 수집 화면을 등록하므로, 추가 연결 없이 createConfirmationToken이 카드를 토큰화합니다.
  • 퍼블리셔블 키는 자동으로 가져옵니다. 이미 키를 가지고 있는 경우에만 publicKey를 전달하세요.
앱을 <WhopElements getToken={…}>로 한 번 감싼 다음, 엘리먼트를 <Payments>로 감싸 마운트하세요. 시작하기 및 Appearance를 참고하세요.

엘리먼트

이 하위 컨트롤러가 마운트하는 엘리먼트입니다. 각각 별도의 페이지가 있습니다.

CardNumberElement

PCI로 격리된 호스팅 카드 번호 필드입니다. 카드 번호는 호스트 페이지에 도달하지 않습니다.

CardExpiryElement

PCI로 격리된 호스팅 카드 만료일 필드입니다.

CardCvcElement

PCI로 격리된 호스팅 카드 보안 코드 필드입니다.