Skip to main content
Current API는 프로그래밍 방식으로 돈을 이동하는 방법입니다. 체크아웃 링크로 결제를 받고, 잔액을 보유하고, 지급을 보내고, 카드를 발급하고, 계정 간에 자금을 이체하고, 판매하는 상품과 변형을 관리하세요. 이 모든 작업을 하나의 API 키로 서버에서 수행할 수 있습니다.

요청 보내기

기본 URL은 https://api.whop.com/api/v1입니다. 모든 요청을 Bearer API 키로 인증하세요.
처음이라면 빠른 시작을 통해 키 생성부터 실제 체크아웃 링크까지 약 5분 안에 진행할 수 있습니다. API v2 또는 공개 GraphQL API에서 통합을 이전하는 경우 이전 버전에서 마이그레이션부터 시작하세요.

요청 작동 방식

인증

Account API Keys 아래에서 여기에서 API 키를 생성하세요. 키는 계정에 속하며 부여한 권한을 가집니다. 키는 서버에만 보관하고, 브라우저 코드, 모바일 앱, 공개 저장소에는 절대 두지 마세요.

버전 관리

Whop은 날짜를 기준으로 API 버전을 관리합니다. 2026-07-01과 같은 Api-Version-Date 헤더를 보내 요청과 응답의 형태를 고정하세요. 이후 변경 사항은 버전을 고정한 호출자에게 영향을 주지 않습니다. 헤더를 생략하면 요청은 최초의 2025-01-01 형태를 사용합니다. 생성된 SDK는 Whop이 SDK를 빌드할 당시 사용 가능한 최신 버전을 항상 보냅니다. 버전 관리를 참고하세요.

페이지네이션

목록 엔드포인트는 data 배열과 page_info 객체를 반환합니다. first를 전달하여 페이지 크기를 선택하세요. 다음 페이지를 가져오려면 이전 응답의 page_info.end_cursor를 after로 전달하세요. page_info.has_next_page로 언제 중단할지 알 수 있습니다. 이를 지원하는 목록은 include_total_count=true를 받아 일치하는 결과 수를 page_info.total_count에 반환합니다. 개수는 10,000에서 멈추며(total_count_capped: true), 집계에 실패하면 null입니다. 개수만 가져오려면 first=0을 추가하세요.

오류

실패한 요청은 일반적인 HTTP 상태(400, 401, 403, 404)와 단일 error 객체가 담긴 본문을 반환합니다. type은 기계가 읽을 수 있는 코드이며 message는 무엇이 잘못되었는지 설명합니다.

모든 리소스의 위치

이 레퍼런스는 Current API를 다룹니다. 다음 리소스는 레거시 API 레퍼런스에 문서화되어 있습니다. 사이드바 상단의 API 선택기를 사용하여 레퍼런스 간에 전환하세요.

리소스

핵심 리소스

다른 모든 것의 기반이 되는 계정과 사람입니다.

결제

구매자로부터 결제를 받고 그 이후의 과정을 처리합니다.

자금

잔액과 뱅킹: 자금이 들어오고 나가는 모든 방법입니다.

커머스

상품을 판매하고 대금을 받습니다.

웹사이트

호스팅된 앱, 해당 빌드와 도메인, 그리고 그 위에서 실행되는 실험입니다.

광고

통합에서 광고 캠페인을 실행하고 측정합니다.

애널리틱스

누가 방문하고, 무엇이 전환되며, 계정의 성과가 어떤지 보여 줍니다.

커뮤니케이션

채널, 채널 내에서 주고받는 메시지, 라이브 스트림, 사용자가 받는 알림, 이메일 메일함입니다.

파트너

사용자와 비즈니스를 Whop에 추천하고 수익을 추적합니다.

워크포스

유료 작업을 게시하고 완료된 작업에 대해 대금을 지급합니다.

미디어

통합에서 미디어 에셋을 생성합니다.

개발자

Whop API와 통합하기 위한 자격 증명, 웹훅, 로그입니다.