Skip to main content
하위 계정이 고객 확인(KYC) 인증을 완료하고, 지급 수단을 추가하고, 자금을 직접 출금할 수 있도록 하세요. Whop Elements 지갑 화면을 앱에 직접 마운트하거나 사용자를 Whop이 호스팅하는 포털로 리디렉션할 수 있습니다.

임베디드 지급 포털

서버 측 구현

지갑 엘리먼트를 마운트하려면 서버에서 하위 계정에 대한 액세스 토큰을 생성하세요. 엘리먼트는 이 토큰으로 해당 계정의 잔액과 지급 내역을 읽습니다. 토큰의 범위를 지정하는 방법과 Whop의 다른 자격 증명 유형과의 비교는 인증 & API 키를 참고하세요.

Create Access Token API

액세스 토큰 생성 및 사용 가능한 모든 매개변수에 대한 전체 API 레퍼런스를 확인하세요

클라이언트 측 설정

클라이언트 측 구현

하위 계정에 대한 Wallet 핸들을 하나 생성하고 필요한 화면을 그 아래에 마운트하세요. 핸들은 하위의 모든 엘리먼트에 액세스 토큰을 전달하므로, 해당 엘리먼트들이 읽는 모든 범위를 포함하는 토큰 하나를 발급하세요.
iOS에서 지갑 SDK는 BalanceElement, ListElement, ActivityElement를 제공합니다. Elements 시작하기를 참고하고 Swift 탭을 선택하세요.

신원 인증

하위 계정은 출금하기 전에 신원을 인증해야 합니다. 세부 정보를 수집하고, 호스팅된 제공업체 세션을 실행하며, 결과를 보고하는 전체 페이지 내 흐름을 위해 KYC 엘리먼트를 마운트하세요. 또는 RequiredActions 엘리먼트를 마운트하여 인증을 포함한 모든 미완료 작업을 표시하고 사용자가 각 작업을 시작하도록 하세요.
React

Wallet 옵션

모든 옵션, 이벤트, 메서드는 Wallet 레퍼런스에 나열되어 있습니다.

범위

엘리먼트는 발급한 토큰으로 데이터를 읽으므로, 필요한 모든 범위를 해당 토큰 하나에 부여하세요:
  • Balances와 Activity는 company:balance:read로 읽습니다.
  • Withdraw는 payout:withdraw_funds, payout:destination:read가 필요하며, 은행을 추가하려면 payout:create_destination이 필요합니다.
  • KYC는 identity:read와 identity:write가 필요합니다.
scoped_actions 없이 생성된 토큰은 API 키의 모든 권한을 상속합니다.

토큰 갱신

액세스 토큰은 기본적으로 1시간 후에 만료되며 최대 3시간까지 유지됩니다. 만료되기 전에 핸들에 새 토큰을 설정하세요:
React에서는 새 값을 accessToken prop으로 전달하세요.
accessToken은 SDK가 호출하는 콜백이 아니라 직접 설정하는 값입니다. Verifications는 예외로, getToken 콜백을 받아 엘리먼트가 마운트되기 전에 호출합니다.

호스팅된 지급 포털

앱에 지급 포털을 임베드하는 대신 사용자를 Whop이 호스팅하는 지급 포털로 리디렉션할 수 있습니다. 사용자 지정 UI를 구축하고 싶지 않거나 빠른 통합이 필요한 경우에 유용합니다. 계정 링크를 생성하고 반환된 URL로 사용자를 리디렉션하세요:
이 예시에서:
  • account_id는 플랫폼 또는 하위 계정입니다
  • use_case는 포털 유형을 지정합니다
  • return_url은 사용자가 사이트로 돌아가려고 할 때 Whop이 사용자를 리디렉션하는 위치입니다
  • refresh_url은 세션이 만료된 경우 Whop이 사용자를 리디렉션하는 위치입니다

사용 가능한 사용 사례

계정 링크를 생성한 후 응답으로 반환된 url로 사용자를 리디렉션하세요. 사용자는 Whop 호스팅 포털에서 지급 흐름을 완료하며, 이후 Whop이 사용자를 return_url로 리디렉션합니다.

지갑 엘리먼트

옵션, 이벤트, 범위를 포함한 모든 지갑 화면

하위 계정에 지급

하위 계정으로 자금 이체