payment.succeeded 웹훅을 받게 됩니다. 라이브 전환은 마지막 단계이며, 대부분 키를 바꾸는 작업입니다.
샌드박스와 프로덕션
Whop은 아무것도 공유하지 않는 두 가지 환경을 운영합니다. 계정, 키, 상품, 웹훅 중 어느 것도 공유되지 않습니다. 샌드박스에서 빌드하고 프로덕션에서 출시합니다. 아래의 모든 값은 두 환경 간에 달라집니다.샌드박스 API 키 받기
1
샌드박스에 가입하기
sandbox.whop.com으로 이동해 계정을 만드세요. 이 계정은 whop.com에 있는 계정과는 별개입니다. 가입 과정에서 첫 비즈니스가 생성되며, 이것이 API 키, 상품, 웹훅, 결제를 소유하는 계정입니다.
2
계정 API 키 만들기
sandbox.whop.com/dashboard/developer를 여세요. Account API Keys에서 Create를 선택하고, 키 이름을
Local development처럼 지정하세요.이 빠른 시작에서는 Admin 역할을 사용하세요. 프로덕션 전에는 호출하는 엔드포인트만 포함하는 사용자 지정 권한 세트로 전환하세요.3
서버에 키 저장하기
Whop이 키를 보여 줄 때 복사하고, 해당 키가 속한 환경과 함께 로컬 
.env 파일에 넣으세요.
WHOP_API_KEY는 서버에 보관하세요. API 키를 브라우저 코드, 모바일 앱, 공개 저장소에 넣지 마세요. 샌드박스와 프로덕션 키는 생김새가 똑같으므로 구분할 수 있도록 이름을 지정하세요.SDK 설치하기
이 페이지에는 SDK 2.7.0 이상이 필요합니다. 이전 버전은 체크아웃 구성에서 인라인
variant를 허용하지 않습니다.첫 호출하기
클라이언트가WHOP_ENVIRONMENT에 지정된 환경을 가리키도록 하고 키에 연결된 계정을 조회하세요. 이렇게 하면 키가 작동하는지 확인되고, biz_로 시작하는 계정 ID가 출력됩니다.
이것이 샌드박스 계정입니다. 키가 작동합니다.
체크아웃 만들기
한 번의 호출로 변형을 만들고sandbox.whop.com에서 호스팅되는 체크아웃 페이지인 purchase_url을 반환합니다.
variant 대신 해당 ID를 variant_id로 전달하세요. 둘 다 보낼 수는 없습니다. 체크아웃 구성 만들기에는 반복 가격, 체험, 리디렉션 URL을 포함한 모든 옵션이 나와 있습니다.
웹훅 수신하기
결제하기 전에 엔드포인트를 설정해payment.succeeded 이벤트가 도착할 곳을 마련하세요.
1
엔드포인트 추가하기
서명을 검증하고 이벤트를 기록하는 개발하는 동안에는 ngrok, Cloudflare Tunnel 또는 다른 터널로 라우트를 HTTPS로 노출하세요.
POST 라우트를 추가하세요. 검증에는 원시 요청 본문이 필요하므로 JSON 파싱 전에 읽어야 합니다.2
샌드박스 대시보드에서 웹훅 만들기
샌드박스 대시보드에서 Developer > Webhooks를 연 다음 Create webhook을 선택하세요. 엔드포인트의 HTTPS 주소를 붙여 넣고, API 버전은 
v1으로 유지한 채 payment.succeeded를 선택하세요.
3
서명 시크릿 저장하기
웹훅의 Secret 열에서 시크릿을 복사하고, 새 값이 반영되도록 서버를 다시 시작하세요.
ws_ 접두사를 포함해 표시된 그대로 .env에 추가하세요.테스트 카드로 결제하기
체크아웃 단계에서 받은purchase_url을 열고 다음 정보로 결제하세요.
몇 초 안에 서버가
payment.succeeded와 pay_로 시작하는 결제 ID를 기록합니다.
결제를 받고 해당 웹훅을 처음부터 끝까지 처리했습니다. 실제로 청구된 금액은 없습니다.
라이브로 전환하기
샌드박스와 프로덕션은 아무것도 공유하지 않으므로, 라이브 전환은 프로덕션 자격 증명으로 whop.com에서 설정을 반복하는 것을 의미합니다. 코드는 바뀌지 않습니다. 환경의 값만 바뀝니다.1
프로덕션 키 만들기
whop.com에 로그인하고 whop.com/dashboard/developer를 연 다음, 통합에서 사용하는 권한만 가진 계정 API 키를 만드세요.
2
모든 값을 프로덕션 값으로 바꾸기
프로덕션 환경에서 세 변수를 모두 프로덕션 값으로 설정하세요. 샌드박스 키나 시크릿을 프로덕션에서 재사용하거나 그 반대로 하지 마세요.API를 직접 호출한다면 기본 URL을
https://api.whop.com/api/v1로 바꾸세요.3
샌드박스에서 만든 것 다시 만들기
상품, 변형, 체크아웃 구성, 웹훅은 이전되지 않습니다. 프로덕션 URL로 프로덕션 웹훅을 만들고 새 서명 시크릿을 저장하세요.
4
API 버전 고정하기
SDK는 빌드 기준이 된 버전을 전송합니다. API를 직접 호출한다면 이후 변경 사항이 응답을 바꾸지 않도록 모든 요청에
Api-Version-Date를 보내세요. API 버전 관리를 참고하세요.이제 원래 만들려던 것을 빌드하세요
구독 또는 일회성 상품을 판매합니다
체크아웃 링크, Checkout 엘리먼트, 변형, 체험.
다른 사람들에게 돈을 지급해야 합니다
지급, 이체, 잔액, 지급 포털.
다른 사람들의 판매에서 수수료를 받습니다
하위 계정, 대신 수금하기, 지급하기.
인프라뿐 아니라 유통도 원합니다
인증, 뷰, CLI를 갖추고 Whop 안에서 실행되는 앱.
제품에 사람들 간의 대화가 필요합니다
임베드할 수 있는 채팅, DM, 포럼.
레퍼런스만 읽고 싶습니다
각 엔드포인트에 플레이그라운드가 있는 Current API의 모든 리소스.

