whop.com의 iframe 안에서 렌더링됩니다. 앱에 누가 요청하는지 알 수 있도록 Whop은 모든 동일 출처 요청의 x-whop-user-token 헤더에 수명이 짧은 JSON Web Token(JWT)을 전달합니다. SDK로 이 토큰을 검증해 사용자 ID를 얻은 다음, 해당 사용자가 무엇을 볼 수 있는지 확인합니다.
iframe 사용자 토큰 검증하기
각 요청에서verifyUserToken을 호출하세요. 이 함수는 x-whop-user-token 헤더를 읽고, JWT 서명과 만료를 검증한 뒤 사용자 ID를 반환합니다. 유효하지 않은 토큰은 기본적으로 예외를 발생시킵니다. TypeScript와 Python은 예외를 발생시키지 않는 변형도 제공합니다:
window.location.origin으로 향하는 요청에만 첨부됩니다. 예시:
- 상대 경로 페이지 이동:
<a href="/ko/sub_page">...</a> - 도메인 없는 fetch:
await fetch("/api/quizzes")
App.base_url 도메인으로 확인됩니다.
API가 다른 도메인에 있는 경우
API가 다른 도메인에 있는 경우
프런트엔드는
example.com에서, API는 api.example.com에서 실행된다면 API 요청이 x-whop-user-token 헤더를 전달하도록 example.com/api를 통해 리버스 프록시하세요.- Cloudflare:
example.com의/api를api.example.com/api로 다시 쓰는 “origin rule”을 생성합니다. - Next.js:
next.config.mjs에 rewrite를 추가합니다. - nginx / Caddy: 서버 구성에서 rewrite 기능을 사용합니다.
이 설정은 브라우저의 엄격한 교차 출처 쿠키 정책 때문에 필요합니다.
로컬 설정
Whop은 프로덕션 iframe 및 쿠키 동작과 일치하는 로컬 리버스 프록시를 제공하므로, 작성한 코드가localhost와 프로덕션에서 동일하게 작동합니다. 설정 방법은 개발 프록시 가이드를 참고하세요.
접근 권한 확인하기
누가 요청하는지 알았으니 이제 무엇을 볼 수 있는지 확인하세요.checkAccess 메서드를 사용해 경험, 계정 또는 상품에 대한 접근 권한을 확인합니다.
리소스 ID 및 접근 수준
응답의
access_level은 다음 중 하나입니다:
고객 앱(경험 뷰)
고객 앱은 경로 매개변수로 전달된experienceId를 기준으로 접근을 제한해야 합니다. 보는 사람에게 유효한 멤버십이 없으면 no_access를 반환하거나 리디렉션하세요.
headers()를 request.headers로 바꾸고 JSX 대신 403 Response를 반환하세요.
대시보드 앱(대시보드 뷰)
대시보드 앱은 계정 팀 멤버만 뷰를 로드할 수 있도록access_level === "admin"을 기준으로 접근을 제한해야 합니다.
headers()를 request.headers로 바꾸고 JSX 대신 403 Response를 반환하세요.
다음 단계
로컬 개발 프록시 실행하기
localhost에서 프로덕션 iframe 및 쿠키 설정을 재현합니다.
권한 요청하기
게시하기 전에 앱에 필요한 범위를 추가하세요.
웹훅 수신하기
서버에서 결제, 멤버십, 신청 이벤트를 받으세요.
앱 뷰 만들기
대시보드 뷰, 경험, 디스커버 등록을 설정하세요.

