Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
Since v1.0.0.

Playground

예시 데이터로 엘리먼트를 조합해 보세요. 컨트롤을 조작하고, 엘리먼트를 추가 및 배치하고, 이벤트가 실시간으로 발생하는 것을 확인하세요.

옵션

whop.wallet.create({ … })에 전달하거나, React에서는 <Wallet>의 props로 전달하세요.
string
금액 입력란에 사용할 세 글자 ISO 4217 통화 코드입니다. 알 수 없는 코드는 usd로 대체됩니다. 기본값은 "usd"입니다.
string
데이터를 사용하는 하위 지갑 엘리먼트에 전달되는 선택적 범위 지정 토큰입니다. 토큰이 없으면 뷰어 세션으로 읽습니다.
boolean
행이 클릭되면 잔액 차트와 목록 대신 보유 자산의 잔액 페이지를 표시합니다. balanceSelected로 라우팅하는 호스트가 두 번째 화면에 가려지지 않도록 기본적으로 꺼져 있습니다. 기본값은 false입니다.
string
필수
이 화면들이 자금을 읽을 계정 또는 사용자 ID입니다. 계정 ID에는 biz_ 접두사가 붙고, 사용자 ID에는 user_ 접두사가 붙으며 뷰어 자신의 잔액만 읽을 수 있습니다.
Appearance
이 그룹 엘리먼트의 시각적 사용자 지정입니다. 전역 WhopElements({ appearance })를 재정의합니다. update({ appearance })로 실시간 변경할 수 있습니다.
WhopElementsLocale
이 그룹 엘리먼트 UI 텍스트의 로케일입니다. 앱에 빌드된 로케일 중 하나로 설정하면 전역 구성을 재정의합니다. 그 외의 값은 기본 로케일로 대체됩니다.

이벤트

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

onIdentityVerificationRequested

입금에 신원 인증이 필요합니다. 이 콜백을 처리하여 설정 또는 인증 흐름을 여세요. Wallet은 직접 페이지를 이동하지 않습니다.
object

onLoadingChange

그룹 로딩 상태가 바뀔 때 실행됩니다. 마운트된 엘리먼트 중 하나라도 로딩 중이면 값은 true입니다.
boolean

메서드

whop.wallet.create({ … }) 또는 useWallet()으로 얻은 Wallet 핸들에서 호출하세요.

update

마운트된 모든 엘리먼트에 새 핸들 옵션을 병합합니다. React에서는 대신 네임스페이스 props를 변경하세요. 매개변수
Partial<WalletOptions>
필수

destroy

이 핸들이 만든 모든 엘리먼트와 하위 컨트롤러를 파괴하고, 컨트롤러 프레임을 제거하고, 구독을 해제합니다. 여러 번 호출할 수 있지만, 파괴된 핸들은 다른 모든 호출을 거부합니다. 다시 시작하려면 새 핸들을 만드세요. React는 프로바이더가 언마운트될 때 그룹을 자동으로 제거합니다.

엘리먼트

이 그룹이 마운트하는 엘리먼트입니다. 각 엘리먼트에는 자체 페이지가 있습니다.

ActionsElement

Whop 잔액 대시보드의 계정 작업 행입니다. Deposit, Send, Withdraw, Convert는 Wallet 컨트롤러의 내장 오버레이를 엽니다. Accept는 비즈니스 계정에서는 Whop의 결제 링크 생성기를, 개인 계정에서는 회사 생성 화면을 엽니다. 각 버튼은 해당 요청 이벤트도 발생시키므로 임베드한 페이지가 작업을 관찰할 수 있습니다.

잔액

계정 자금을 보여 주는 세 가지 뷰입니다. 잔액 뷰는 총액, 그 변화를 보여 주는 차트, 기간 선택기를 표시합니다. 목록 뷰는 총액을 구성하는 보유 자산을 달러 가치로 표시합니다. 내역 뷰는 자금 이동 컨트롤 없이 한 통화를 사용 가능, 대기 중, 리저브, 마이너스 금액으로 나눕니다. openHoldingOnSelect가 켜져 있으면 목록 행이 클릭을 보고하는 데 그치지 않고, 이 유닛의 캔버스(차트와 목록)를 해당 보유 자산의 잔액 페이지로 대체합니다. (하위 컨트롤러, 엘리먼트 4개)

보고서

잔액 내역과 그 뒤에 있는 금융 활동을 CSV 내보내기와 함께 제공합니다. 계정 명세서는 Whop 대시보드에서 확인할 수 있습니다. (하위 컨트롤러, 엘리먼트 2개)

ActivityElement

계정의 원장 활동입니다. 들어오고 나간 모든 자금 이동을 최신순으로 보여 줍니다. 뷰어가 스크롤하면 목록이 페이지 단위로 로드되며, 행은 페이지를 이동하는 대신 어느 행이 탭되었는지 보고하므로 자체 세부 정보 화면을 열 수 있습니다.

ActivityDetailElement

자금 이동 하나에 대한 독립된 세부 정보 드로어입니다. 미리 가져온 금융 활동 행, 원장 활동 ID 또는 카드 거래 ID를 지정하세요. 미리 가져온 행이 우선하며, 그렇지 않으면 엘리먼트가 직접 기록을 조회합니다. 카드 거래는 카드 영수증을 엽니다. 가맹점, 금액, 상태, 청구된 카드, 회사 계정의 카드 소지자, 정산일, 카테고리, 환전, 캐시백이 표시됩니다.

DepositElement

Whop 계정에 자금을 입금합니다. 금액 입력란과 계정에서 현재 사용 가능한 입금 수단을 렌더링합니다. 암호화폐(네트워크별 입금 주소와 QR 코드)와 은행 송금(정산 통화별 송금 정보)을 지원합니다. 비즈니스 계정의 입금 수단은 자격 증명 없이 확인되므로 어떤 페이지에서도 작동합니다. 개인(user_) 계정은 입금 수단을 본인에게만 공개하므로 accessToken을 전달하세요. 생략하면 뷰어 자신의 동일 출처 세션이 사용됩니다. 카드와 플랫폼 잔액은 선택 사항입니다. savedCards, allowNewCard 또는 showPlatformBalance를 전달하면 엘리먼트가 금액과 선택 항목을 수집한 다음 cardDepositRequested / addCardRequested / platformBalanceSelected를 발생시키고, 자체 화면이 완료되면 showStep({ step: 'amount' })을 호출할 때까지 기다립니다.

ConvertElement

Whop의 공개 스왑 API를 통해 계정의 USD 잔액을 Gold, Coinbase Wrapped Bitcoin 또는 주식 토큰으로 전환하거나 다시 USD로 전환합니다. 교차 출처 마운트에는 company:balance:read와 함께 crypto_wallet:swap 또는 crypto_wallet:manage 스코프가 지정된 accessToken이 필요합니다.

WithdrawElement

출금 금액과 저장된 출금 수단을 수집하고, 표준 및 즉시 지급 옵션을 실시간 수수료와 도착 예상 시간과 함께 묶어 보여 주며, 필요한 경우 새 출금 수단을 수집합니다. 호스트가 흐름을 제어하지 않으면 엘리먼트가 직접 출금 수단을 나열하고 출금을 생성하므로 accessToken을 전달하세요(또는 뷰어의 동일 출처 세션을 사용하세요). 이미 출금 API와 통신하는 호스트는 여전히 출금 수단, 한도, 로딩 플래그를 제공할 수 있으며, 이 경우 확정하면 호스트가 출금을 생성하도록 withdrawalRequested가 발생합니다.

SendElement

계정에서 수신자에게 자금을 보냅니다. 수신자는 사용자, 다른 계정 또는 누구나 받을 수 있는 공개 수령 링크일 수 있습니다. 직접 이체는 출금 계정에 구성된 법정 화폐 또는 암호화폐 수단을 사용합니다. 계정 자체 토큰 외의 자격 증명 없이 계정 ID로 확인되는 자체 수신자 검색을 렌더링합니다. 직접 이체에는 payout:transfer_funds, 수신자 목록에는 payout:withdraw_funds 스코프가 지정된 accessToken이 필요합니다. 계정 수신자 검색에는 추가로 company:authorized_user:read와 member:basic:read가, 계정 수령 링크에는 airdrop_link:manage가 필요합니다. 이 스코프 중 하나가 없는 호스트는 403 오류를 낼 행을 남겨 두지 말고 해당 prop을 끄세요.

CardDetailsElement

카드 한 장과 그 카드의 지출 내역입니다. 카드 자체, 한도 대비 지출액, 최근 거래를 보여 줍니다. 드로어로 열립니다. 카드 앞면, 정보 공개, 잠금은 내부에 구성된 whopCard 엘리먼트에서 제공되므로, 호스트는 세 가지를 조립하는 대신 하나의 화면을 얻습니다. 거래를 누르거나 전체 목록을 요청하면 요청이 보고될 뿐이며, 드로어가 직접 페이지를 이동하지는 않습니다.

카드

한 곳에서 마운트하는 계정의 카드 화면들입니다. 간결한 발급 카드 목록, 정렬 가능한 전체 목록, 지출 차트, 정보를 공개할 수 있는 단일 카드를 제공합니다. 페이지에 필요한 화면을 마운트하세요. 모두 이 유닛이 발급받은 계정과 자격 증명을 공유하므로, 목록 위에 차트를 표시하는 페이지도 한 번만 연결하면 됩니다. (하위 컨트롤러, 엘리먼트 5개)