> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Whop API 개요

> Whop API 요청의 작동 방식과 모든 리소스 및 해당 문서 위치를 정리한 지도입니다.

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

## 요청 보내기

기본 URL은 `https://api.whop.com/api/v1`입니다. 모든 요청을 Bearer API 키로 인증하세요.

```bash theme={null}
curl https://api.whop.com/api/v1/accounts/me \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

```json theme={null}
{
	"id": "biz_XXXXXXXX",
	"title": "Acme Studio",
	"route": "acme-studio",
	"status": "approved"
}
```

처음이라면 [빠른 시작](https://docs.whop.com/ko/developer/quickstart.md)을 통해 [키 생성](https://whop.com/dashboard/developer)부터 실제 체크아웃 링크까지 약 5분 안에 진행할 수 있습니다. API v2 또는 공개 GraphQL API에서 통합을 이전하는 경우 [이전 버전에서 마이그레이션](https://docs.whop.com/ko/developer/api/migrate-from-previous-versions.md)부터 시작하세요.

## 요청 작동 방식

### 인증

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

### 버전 관리

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

### 페이지네이션

목록 엔드포인트는 `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`는 무엇이 잘못되었는지 설명합니다.

```json theme={null}
{
	"error": {
		"type": "invalid_parameters",
		"message": "initial_price must be greater than 0"
	}
}
```

## 모든 리소스의 위치

이 레퍼런스는 Current API를 다룹니다. 다음 리소스는 [레거시 API 레퍼런스](https://docs.whop.com/ko/api-reference/payments/payment)에 문서화되어 있습니다.

* 청구: [결제](https://docs.whop.com/ko/api-reference/payments/payment), [환불](https://docs.whop.com/ko/api-reference/refunds/refund), [인보이스](https://docs.whop.com/ko/api-reference/legacy/invoices/legacy-invoice.md), [결제 수단](https://docs.whop.com/ko/api-reference/legacy/payment-methods/payment-method.md)
* 콘텐츠 및 커뮤니티: [코스](https://docs.whop.com/ko/api-reference/legacy/courses/course.md), [포럼](https://docs.whop.com/ko/api-reference/legacy/forums/forum.md), [메시지](https://docs.whop.com/ko/api-reference/legacy/messages/message.md)
* 성장: [제휴자](https://docs.whop.com/ko/api-reference/legacy/affiliates/affiliate.md), [리뷰](https://docs.whop.com/ko/api-reference/legacy/reviews/review.md)

사이드바 상단의 API 선택기를 사용하여 레퍼런스 간에 전환하세요.

## 리소스

### 핵심 리소스

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

| 리소스 | 용도 |
| - | - |
| [계정](https://docs.whop.com/ko/api-reference/accounts/account) | Whop의 비즈니스: 프로필, 지갑, 기능, 설정. |
| [사용자](https://docs.whop.com/ko/api-reference/users/user) | Whop의 개인: 프로필 및 연결된 신원. |
| [멤버](https://docs.whop.com/ko/api-reference/members/member) | 모든 구매에 걸친 한 구매자와 계정의 관계. |
| [팀원](https://docs.whop.com/ko/api-reference/team-members/team-member) | 계정의 팀원과 그들의 접근 범위를 정하는 역할. |
| [검색](https://docs.whop.com/ko/api-reference/search/search) | ID, 이메일, 카드, 전화번호, 번호, 링크 또는 텍스트로 계정의 멤버, 결제 및 기타 레코드를 한 번의 호출로 찾기. |
| [외부 계정](https://docs.whop.com/ko/api-reference/external-accounts/external-account) | 계정 또는 사용자에 연결된 다른 플랫폼의 계정. |
| [소셜 계정](https://docs.whop.com/ko/api-reference/social-accounts/social-account) | 외부 계정을 위한 지원 중단된 호환성 엔드포인트. |

### 결제

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

| 리소스 | 용도 |
| - | - |
| [결제](https://docs.whop.com/ko/api-reference/payments/payment) | 구매자에 대한 청구와 구매자가 아직 수행해야 하는 단계. |
| [인보이스](https://docs.whop.com/ko/api-reference/invoices/invoice) | 초안부터 수금까지 동일한 영수증을 유지하는 결제 요청. |
| [확인 토큰](https://docs.whop.com/ko/api-reference/confirmation-tokens/confirmation-token) | 구매자로부터 수집한 결제 정보에 대한 단기 참조. |
| [결제 견적](https://docs.whop.com/ko/api-reference/payment-quotes/payment-quote) | 결제 전에 가격이 산정된 구매: 항목, 프로모션 코드, 세금. |
| [설정 인텐트](https://docs.whop.com/ko/api-reference/setup-intents/setup-intent) | 청구하지 않고 구매자의 결제 수단 저장. |
| [환불](https://docs.whop.com/ko/api-reference/refunds/refund) | 결제에서 구매자에게 반환된 돈. |
| [Resolution Center 사례](https://docs.whop.com/ko/api-reference/resolution-center-cases/resolution-center-case) | 구매자 또는 판매자로서 결제에 대한 사례를 제기하거나 응답. |
| [분쟁 알림](https://docs.whop.com/ko/api-reference/dispute-alerts/dispute-alert) | 지불 거절보다 먼저 도착하는 카드 발급사 경고. |
| [분쟁](https://docs.whop.com/ko/api-reference/disputes/dispute) | 증거 및 결과와 함께 계정에 제기된 지불 거절. |
| [결제 규칙](https://docs.whop.com/ko/api-reference/payment-rules/payment-rule) | 계정이 자체 결제를 결정하기 위해 작성하는 규칙. |
| [금융 신청](https://docs.whop.com/ko/api-reference/financing-applications/financing-application) | 선구매 후결제(BNPL) 결제 수단을 받기 위한 계정의 요청. |

### 자금

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

| 리소스 | 용도 |
| - | - |
| [입금](https://docs.whop.com/ko/api-reference/deposits/deposit) | 잔액에 자금 추가. |
| [이체](https://docs.whop.com/ko/api-reference/transfers/transfer) | Whop 계정과 사용자 간 자금 이동. |
| [지급](https://docs.whop.com/ko/api-reference/payouts/payout) | 잔액에서 은행 또는 지갑으로 송금. |
| [금융 활동](https://docs.whop.com/ko/api-reference/ledgers/ledger-activity) | 계정 또는 사용자 잔액의 기반이 되는 활동 피드. |
| [카드](https://docs.whop.com/ko/api-reference/cards/card) | 잔액에서 사용하는 카드 발급. |
| [캐시백 규칙](https://docs.whop.com/ko/api-reference/cashback-rules/cashback-rule) | 플랫폼 후원 카드 캐시백 구성. |
| [스왑](https://docs.whop.com/ko/api-reference/swaps/swap) | 통화 간 잔액 환전. |
| [트레이드](https://docs.whop.com/ko/api-reference/trades/trade) | Whop 관리 지갑에서 무기한 및 현물 거래를 위한 주문 실행, 포지션 종료, 자금 이동. |
| [인증](https://docs.whop.com/ko/api-reference/verifications/verification) | 지급 및 카드 발급 전에 필요한 법적 신원. |

### 커머스

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

| 리소스 | 용도 |
| - | - |
| [상품](https://docs.whop.com/ko/api-reference/products/product) | 판매하는 것. 각 상품은 변형과 스토어 페이지를 가집니다. |
| [변형](https://docs.whop.com/ko/api-reference/variants/variant) | 구매 가능한 상품 구성. |
| [프로모션 코드](https://docs.whop.com/ko/api-reference/promo-codes/promo-code) | 크리에이터가 체크아웃용으로 구성하는 할인. |
| [체크아웃 구성](https://docs.whop.com/ko/api-reference/checkout-configurations/checkout-configuration) | 변형을 공유 가능한 사전 입력 체크아웃 링크로 변환. |
| [대기자 명단 항목](https://docs.whop.com/ko/api-reference/waitlist-entries/waitlist-entry) | 대기자 명단에 참여하고 승인 대기 중인 고객 가입 관리. |
| [멤버십](https://docs.whop.com/ko/api-reference/memberships/membership) | 체크아웃부터 취소까지, 고객의 변형 구매. |
| [배송](https://docs.whop.com/ko/api-reference/shipments/shipment) | 운송업체 추적 번호로 주문 배송 추적. |
| [리뷰](https://docs.whop.com/ko/api-reference/reviews/review) | 상품에 대한 고객 별점과 작성된 피드백. |
| [리뷰 신고](https://docs.whop.com/ko/api-reference/review-reports/review-report) | 계정 관리자가 고객 리뷰에 대해 제기한 신고. |
| [상품 제휴자](https://docs.whop.com/ko/api-reference/product-affiliates/product-affiliate) | 추천이 없는 제휴자를 포함하여 상품 홍보에 등록된 사용자. |

### 웹사이트

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

| 리소스 | 용도 |
| - | - |
| [도메인](https://docs.whop.com/ko/api-reference/domains/domain) | 호스팅된 앱에 할당된 사용자 지정 도메인. |
| [앱](https://docs.whop.com/ko/api-reference/apps/app) | Whop에서 빌드하는 앱: 메타데이터, 호스팅된 빌드, 런타임 로그. |
| [앱 빌드](https://docs.whop.com/ko/api-reference/app-builds/app-build) | 앱의 플랫폼에 배포된 버전 관리 빌드 아티팩트. |
| [앱 설치](https://docs.whop.com/ko/api-reference/app-installations/app-installation) | 계정에 설치된 앱과 각 설치에 대해 앱이 보관하는 데이터. |
| [실험](https://docs.whop.com/ko/api-reference/experiments/experiment) | 점진적 출시를 위한 기능 플래그 및 A/B 실험. |

### 광고

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

| 리소스 | 용도 |
| - | - |
| [광고 캠페인](https://docs.whop.com/ko/api-reference/ad-campaigns/ad-campaign) | 광고 세트의 목표와 예산. |
| [광고 그룹](https://docs.whop.com/ko/api-reference/ad-groups/ad-group) | 캠페인 내 오디언스, 일정, 예산. |
| [광고](https://docs.whop.com/ko/api-reference/ads/ad) | 크리에이티브: 문구, 에셋, 도착 URL. |
| [오디언스](https://docs.whop.com/ko/api-reference/audiences/audience) | 광고 그룹용 재사용 가능한 타기팅 목록. |
| [광고 픽셀](https://docs.whop.com/ko/api-reference/ad-pixels/ad-pixel) | 소유권을 주장한 캠페인의 전환을 받는 자체 픽셀. |

### 애널리틱스

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

| 리소스 | 용도 |
| - | - |
| [통계](https://docs.whop.com/ko/api-reference/stats/stats) | 집계된 재무, 오디언스, 트래픽 보고. |
| [사람](https://docs.whop.com/ko/api-reference/people/person) | 신원, 구매, 트래픽 프로필을 포함한 계정의 방문자 및 고객. |
| [이벤트](https://docs.whop.com/ko/api-reference/events/event) | 어트리뷰션을 위해 추적되는 전환 및 참여 이벤트. |
| [내보내기](https://docs.whop.com/ko/api-reference/exports/export) | 계정 대시보드 데이터의 비동기 CSV 덤프. |
| [Economic Intelligence](https://docs.whop.com/ko/api-reference/economic-intelligence/economic-intelligence) | 계정 자체 데이터를 바탕으로 생성된, 성장을 위해 다음에 해야 할 일. |

### 커뮤니케이션

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

| 리소스 | 용도 |
| - | - |
| [채널](https://docs.whop.com/ko/api-reference/channels/channel) | 비공개, 커뮤니티 및 지원 채팅 채널. |
| [채널 멤버](https://docs.whop.com/ko/api-reference/channel-members/channel-member) | 채널 참여자와 개인 멤버십 상태. |
| [메시지](https://docs.whop.com/ko/api-reference/messages/message) | 채팅 메시지, 첨부 파일, 반응, 투표. |
| [라이브 스트림](https://docs.whop.com/ko/api-reference/livestreams/livestream) | 익스피리언스 내 라이브 비디오 방송과 그 녹화본. |
| [알림](https://docs.whop.com/ko/api-reference/notifications/notification) | 사용자의 알림 피드: 읽지 않은 배지, 읽음 표시, 앱 전송, 토픽 카탈로그. |
| [이메일 주소](https://docs.whop.com/ko/api-reference/email-addresses/email-address) | 이메일 송수신을 위한 계정 도메인의 메일함. |
| [자동화](https://docs.whop.com/ko/api-reference/automations/automation) | 웹훅 이벤트 또는 트리거 요청이 각 멤버에 대해 시작하는 워크플로로, 멤버에게 메시지를 보내는 시간 지정 단계를 실행합니다. |
| [자동화 단계](https://docs.whop.com/ko/api-reference/automation-steps/automation-step) | 자동화 버전의 대기, 이메일, 메시지 단계. |
| [자동화 등록](https://docs.whop.com/ko/api-reference/automation-enrollments/automation-enrollment) | 자동화를 진행 중인 멤버와 각 멤버가 대기 중인 단계. |

### 파트너

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

| 리소스 | 용도 |
| - | - |
| [파트너](https://docs.whop.com/ko/api-reference/partners/partner) | 파트너 프로필, 추천 링크, 지급 요율, 추천한 비즈니스. |
| [파트너 추천 요청](https://docs.whop.com/ko/api-reference/partner-referral-requests/partner-referral-request) | 비즈니스 또는 파트너 어트리뷰션을 요청하고 승인 관리. |

### 워크포스

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

| 리소스 | 용도 |
| - | - |
| [바운티](https://docs.whop.com/ko/api-reference/bounties/bounty) | 검토되는 제출물과 에스크로 보상이 있는 유료 작업. |
| [바운티 제출물](https://docs.whop.com/ko/api-reference/bounty-submissions/bounty-submission) | 시도부터 지급까지, 바운티에 제출된 작업. |

### 미디어

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

| 리소스 | 용도 |
| - | - |
| [파일](https://docs.whop.com/ko/api-reference/files/file) | 파일을 업로드하고 Whop이 문서를 허용하는 곳 어디에나 첨부. |
| [미디어](https://docs.whop.com/ko/api-reference/media/media) | 잔액에서 청구되며 파일이 허용되는 곳 어디에나 첨부할 수 있는 AI 생성 에셋. |

### 개발자

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

| 리소스 | 용도 |
| - | - |
| [API 키](https://docs.whop.com/ko/api-reference/api-keys/api-key) | 계정 또는 앱의 프로그래밍 방식 자격 증명. |
| [웹훅](https://docs.whop.com/ko/api-reference/webhooks/webhook) | 일이 발생할 때 서버로 푸시되는 이벤트 알림. |
| [권한](https://docs.whop.com/ko/api-reference/permissions/permission) | 자격 증명이 리소스에서 수행할 수 있는 작업. |
| [API 로그](https://docs.whop.com/ko/api-reference/api-logs/api-log) | 계정의 API 키로 Whop API에 보낸 요청. |
| [피드백](https://docs.whop.com/ko/api-reference/feedback/feedback) | 검토를 위해 Whop에 보낸 문제 및 답변되지 않은 질문. |


## Related topics

- [Ads API 개요](https://docs.whop.com/ko/api-reference/ads/overview.md)
- [Whop API 핵심 개념](https://docs.whop.com/ko/developer/concepts.md)
- [Whop API 빠른 시작](https://docs.whop.com/ko/developer/quickstart.md)
