window.postMessage를 사용하는 요청-응답 API를 통해 Whop 애플리케이션과 타입 안전하게 통신하는 방법을 제공합니다.
이 패키지는 window.postMessage에 의존하므로 클라이언트 컴포넌트 또는 클라이언트 측 JavaScript에서만 작동합니다.
관련 패키지
@whop/iframe- iframe SDK의 기본 패키지입니다.@whop/react- iframe SDK용 헬퍼를 포함한 Whop 앱용 React 래퍼입니다.
설정
@whop/iframe 패키지에서 내보내는 주요 함수는 createSdk 함수입니다. 이 함수를 호출하면 window.on('message', ...)를 사용해 메인 Whop 사이트에서 오는 메시지에 대한 리스너를 설정합니다. 이 함수는 @whop/react의 WhopIframeSdkProvider 컴포넌트를 통해서도 제공됩니다.
React
React를 사용한다면@whop/react의 WhopIframeSdkProvider 컴포넌트를 추가하여 모든 하위 컴포넌트에 iframe SDK를 제공하세요.
1
루트 레이아웃에 프로바이더 마운트하기
2
컴포넌트에서 iframe SDK 사용하기
기타 프레임워크
다른 프레임워크에서는@whop/iframe의 createSdk 함수를 사용해 iframe SDK 인스턴스를 만들 수 있습니다.
1
iframe SDK 인스턴스 만들기
2
iframe SDK 인스턴스 사용하기
이제 SDK와 iframe이 설정되었습니다.
외부 링크 열기
iframe SDK를 초기화한 후에는 이를 사용해 외부 링크를 열 수 있습니다. 이렇게 하면 앱이 닫히고 새 웹사이트로 이동합니다.사용자 프로필 열기
Whop 사용자 프로필을 표시하려면openExternalUrl 메서드를 사용하고 https://whop.com/@username 형식의 프로필 페이지 링크를 전달하세요.
Whop 앱이 이를 가로채서 다른 페이지로 이동하는 대신 사용자 프로필이 담긴 모달을 표시합니다.
사용자 이름 대신 사용자 ID를 사용할 수도 있습니다. 최종 링크는 다음과 같은
형태여야 합니다:
https://whop.com/@user_XXXXXXXX인앱 구매
iframe SDK는 앱 내에서 직접 인앱 구매를 시작하는 메서드를 제공합니다. 이를 통해 Whop의 체크아웃을 사용해 일회성 구매나 구독 결제를 받을 수 있습니다. 인앱 구매를 처리하려면 다음을 수행해야 합니다:- 서버에서 체크아웃 구성을 만듭니다(호환성
plan필드의 변형 세부 정보와 메타데이터 포함) - iframe SDK의
inAppPurchase메서드를 사용해 결제 모달을 엽니다 - 응답을 처리하고 웹훅으로 결제를 검증합니다
체크아웃 구성 생성, 웹훅 처리, 결제 검증을 포함한 인앱 구매 설정 전체 가이드는
결제 받기 문서를 참고하세요.

