통합 방식 선택하기
두 방식 모두 동일한 설정을 공유합니다.
설정
whop과 상품 만들기
whop.com/sell에서 시작하여 whop의 이름을 정하고 URL을 선택하세요. 그런 다음 대시보드의 Products로 이동하여 고객이 지불할 가격으로 상품을 추가하세요. 상품 ID(
prod_)와 플랜 ID(plan_)를 복사하세요. 아래에서 둘 다 필요합니다.API 키 만들기
대시보드에서 Developer → API keys로 이동하여 계정 API 키를 만드세요. 이 키는 비즈니스를 대신하여 작동하므로 서버에 보관하고, 클라이언트 코드나 다운로드형 앱에 절대 포함하지 마세요.
WHOP_API_KEY로 저장하세요.이메일 로그인 통합
고객이 자체 웹 앱에 로그인할 때 이 방식을 사용하세요. 각 고객의 Whop 사용자 ID를 사용자 레코드에 저장한 다음, 유료 기능을 제공하기 전에 이를 사용해 접근 권한을 확인하세요.로그인한 사용자를 체크아웃으로 보내기
서버에서 체크아웃 구성을 만들고 자체 사용자 ID를 구매자를 자체 페이지에 머물게 하려면 Checkout 요소를 임베드하고 핸들에 동일한
metadata에 넣으세요. Whop은 이 메타데이터를 멤버십에 복사하며, 다음 단계에서 이를 통해 구매를 사용자와 연결합니다. 그런 다음 사용자를 purchase_url로 리디렉션하세요.metadata를 전달하세요. 결제 받기에서 모든 체크아웃 옵션을 비교합니다.웹훅에서 Whop 사용자 ID 저장하기
대시보드의 Developer 탭을 열고 Create webhook을 선택한 다음,
membership.activated를 구독하고 서명 시크릿을 WHOP_WEBHOOK_SECRET으로 저장하세요. 이벤트의 data는 구매자의 user_id와 체크아웃에서 설정한 metadata가 포함된 멤버십입니다.membership.activated는 갱신 시에도 발생하므로, 반복해도 안전하도록 쓰기 작업을 구성하세요. 재시도와 테스트는 웹훅에서 다룹니다.유료 기능 제공 전에 접근 권한 확인하기
사용자가 상품에 접근 권한이 있는지 Whop에 물어보세요. 응답은 갱신, 취소, 환불을 반영하므로 청구 상태를 직접 추적할 필요가 없습니다.같은 응답의
access_level은 customer, admin, no_access 중 하나입니다.고객이 청구를 관리할 수 있게 하기
고객이 결제 수단을 업데이트하거나 취소할 수 있도록 Whop 주문 링크를 제공하세요. 고객은 구매 시 사용한 이메일로 로그인합니다.
라이선스 키 통합
고객의 기기에서 실행되는 소프트웨어에는 이 방식을 사용하세요. 구매할 때마다 고유한 라이선스 키가 제공됩니다. 소프트웨어가 키를 요청하고, 서버가 Whop으로 키를 확인합니다.상품에 Software 앱 추가하기
whop에 Software 앱을 설치하고, 앱을 열어 소프트웨어 이름과 다운로드 링크를 추가하세요. 그러면 구매자는 주문 내역에서 라이선스 키와 다운로드를 확인할 수 있습니다. API는 상품에 이 앱이 포함된 경우에만 멤버십의
license_key를 반환합니다.서버에서 키 검증하기
배포하는 소프트웨어가 아니라 자체 서버에서 키를 확인하세요. API 키는 비즈니스의 모든 멤버십을 읽고 변경할 수 있으므로, 사용자가 다운로드하는 데스크톱 앱이나 스크립트에 절대 포함하지 마세요. 소프트웨어는 라이선스 키와 기기 식별자를 서버로 전송하고, 서버는 Whop으로 이를 확인합니다.각 키를 한 대의 기기로 제한하려면, 누군가 키를 처음 사용할 때 멤버십의 메타데이터에 하드웨어 ID를 저장한 다음 이후 확인할 때마다 비교하세요:
- 키가 아직 연결되지 않은 경우(메타데이터에
hwid가 없음): 기기의hwid를 저장하고 접근을 허용합니다. - 저장된
hwid가 일치하는 경우: 접근을 허용합니다. - 저장된
hwid가 다른 경우: 접근을 거부합니다. 고객이 재설정할 때까지 키는 다른 기기에서 사용 중입니다.
라이선스 키 재설정하기
고객은 주문 내역에서 키를 재설정할 수 있습니다. 서버에서 재설정하려면 빈 메타데이터 객체(
metadata: {})로 멤버십을 업데이트하세요. 이후 어떤 기기에서든 다음 확인 시 키가 다시 연결됩니다.스토어 페이지 디자인하기
스토어 페이지는 사람들이 구매하기 전에 소프트웨어에 대해 알아보는 곳입니다. 왼쪽 상단에서 whop 이름을 선택한 다음 Design store page를 선택하여 편집기를 여세요. Edit details를 선택하여 다음을 사용자 지정하세요:- 이름과 헤드라인: 소프트웨어가 무엇을 하고 누구를 위한 것인지 알려 주세요.
- 설명: 해결하는 문제와 업데이트, 지원, 커뮤니티 등 구매자가 얻는 것에 초점을 맞추세요.
- 로고: 깔끔하고 간단한 로고를 추가하세요.
- 갤러리 이미지 또는 동영상: 소프트웨어가 사용되는 모습을 보여 주세요. 짧은 데모 동영상은 구매자의 결정에 도움이 됩니다.
- 카테고리: 사람들이 Whop을 둘러볼 때 소프트웨어를 찾는 데 도움이 되는 카테고리를 선택하세요.
다음 단계
결제 받기
체크아웃 링크, Checkout 요소, 결제 요소를 비교하세요.
웹훅
서명을 확인하고, 재시도를 처리하고, 이벤트를 테스트하세요.
멤버십 관리
서버에서 멤버십을 취소, 일시 중지, 연장, 업데이트하세요.
Whop으로 로그인
고객이 비밀번호 대신 Whop 계정으로 로그인할 수 있게 하세요.

