Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원. Dashboard 안에 마운트됩니다. accountId와 accessToken은 Dashboard에서 가져옵니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다. refresh()를 호출하려면 생성된 핸들 또는 React ref를 보관하세요.

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

Props

boolean
오른쪽 상단의 Refund 버튼과 작업 메뉴를 표시합니다. 변경 작업에는 이벤트 핸들러가 필요합니다. 기본값은 true입니다.
string
표시할 결제로, pay_ 접두사가 붙습니다. 결제를 불러오려면 필수입니다. 기본값은 ""입니다.
boolean
결제 금액, 수수료, 순 금액을 표시합니다. 기본값은 true입니다.
boolean
결제 활동 타임라인을 표시합니다. 기본값은 true입니다.
boolean
권한이 있는 경우 고객 이름, 사용자 이름, 이메일, 전화번호, 청구지 주소를 표시합니다. 기본값은 true입니다.
boolean
상품, 플랜, 결제 수단, 결제 메타데이터, 결제 식별자를 표시합니다. 기본값은 true입니다.
boolean
고객 여정을 표시합니다. 표시되는 동안에만 계정 범위의 Events API를 읽습니다. 기본값은 true입니다.

이벤트

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

onRefundRequested

애플리케이션에서 환불을 확인하고 승인합니다. 환불 가능하고 핸들러가 제공된 경우에만 활성화됩니다.
object

onRetryRequested

애플리케이션에서 추가 청구 시도를 확인하고 승인합니다.
object

onVoidRequested

애플리케이션에서 이 결제의 무효화를 확인하고 승인합니다.
object

onInvoiceRequested

애플리케이션에서 인보이스를 보거나 다운로드합니다.
object

onCustomerSelected

애플리케이션에서 고객을 엽니다.
object

onMessageRequested

고객 메시지 UI를 엽니다.
object

onLoaderStart

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

onReady

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

onError

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

메서드

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

refresh

호스트 작업이 완료된 후 결제와 수수료를 다시 불러옵니다. 반환값 Promise<void>

mount

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

destroy

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

update

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

스타일링

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