샌드박스 URL
sandbox.whop.com에서 샌드박스 계정과 API 키를 생성하세요.
소프트웨어 개발 키트 구성
Whop SDK로 샌드박스 환경을 사용하려면Sandbox 환경을 전달하세요. 환경은 SDK가 통신하는 모든 호스트를 지정하므로, 모든 요청이 한 번에 샌드박스로 이동합니다.
Sandbox 환경은 SDK 2.0에서 도입되었습니다. 1.x에서는 대신 클라이언트를 https://sandbox-api.whop.com/api/v1로 지정하세요: TypeScript에서는 baseUrl, Python과 Ruby에서는 base_url, Go에서는 option.WithBaseURL을 사용합니다. TypeScript, Ruby, Go는 2.0에서도 이 재정의를 유지하지만, 모든 요청을 하나의 호스트로 보냅니다. 그러면 다른 호스트에 도달해야 하는 작업은 거부되므로 environment를 사용하세요. 2.0 Python 클라이언트에는 base_url 매개변수가 없습니다. Rust SDK는 아직 1.x이며 base_url을 유지합니다.샌드박스의 Elements
Whop Elements를 샌드박스로 지정하려면 SDK 인스턴스를 생성할 때environment를 설정하세요. 이 옵션은 구매자가 입력한 내용을 Elements가 보내는 위치를 변경하는 유일한 방법입니다.
변형을 선택하는 Elements 속성은 호환성을 위해 plan이라는 이름을 유지합니다.
애플리케이션 프로그래밍 인터페이스 키 및 웹훅
API 키와 웹훅은 샌드박스에서도 프로덕션과 동일하게 작동합니다:- sandbox.whop.com/dashboard/developer에서 API 키를 생성하세요
- 샌드박스에서 이벤트를 수신하도록 웹훅을 구성하세요
- 동일한 인증 헤더(
Authorization: Bearer YOUR_API_KEY)를 사용하세요
테스트 카드
샌드박스에서 결제를 시뮬레이션하려면 다음 테스트 카드 번호를 사용하세요:
프로덕션에서 거절된 결제에는 카드 발급사의 코드가 포함됩니다. 결제 거절 코드 설명에서 각 코드의 의미를 확인할 수 있습니다.
모든 테스트 카드에 대해:
- 미래의 아무 만료일이나 사용하세요(예: 12/34)
- 아무 3자리 카드 인증 코드나 사용하세요(예: 123)
- 아무 청구 주소나 사용하세요
4000 0000 0000 0341을 사용하세요.
샌드박스의 결제 수단
카드 결제를 테스트하려면 위의 테스트 카드를 사용하세요. 다음 수단도 각 제공업체의 자체 테스트 흐름을 통해 샌드박스에서 완료됩니다: PayPal, Bancontact, iDEAL, Cash App Pay, Pix, Boleto. 다음 수단은 아직 샌드박스에서 지원되지 않습니다:- Apple Pay 및 Google Pay
- 은행 계좌(ACH)
- SEPA Direct Debit
- EU 은행 이체 및 전신 송금
- Alipay, WeChat Pay, MobilePay
알려진 제한 사항
- 지급
- 암호화폐 입금 및 온체인 이체
- Discord 다이렉트 메시지 및 역할 동기화
- 최신 검색 결과
- 사기 검토 및 다이제스트 이메일 등 프로덕션에서 실행되는 일부 예약 및 백그라운드 작업

