> ## 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 CLI 명령

> CLI 자체의 설명이 포함된 모든 Whop CLI 명령 그룹과 하위 명령.

`whop`의 모든 명령 그룹과 각 그룹의 설명입니다. 플래그는 `whop <group> --help`를, 완전한 기계 판독 가능 레퍼런스는 `whop --llms-full`을 실행하세요. 상태를 변경하는 명령은 실행 전에 확인을 요청합니다.

`whop --version`은 설치된 버전을 출력하고, `whop --help`는 CLI가 사용하는 API 버전을 보여줍니다. `whop --update`는 최신 릴리스를 설치하며, 최신 릴리스가 없으면 `upToDate`를 보고합니다(Homebrew 설치는 `brew upgrade whop`을 사용).

> [!WARNING]
>
> CLI에는 샌드박스나 테스트 모드가 없으므로 모든 명령은 프로덕션 환경에서 실행됩니다. 유일한 미리보기는 `whop send --dry-run`으로, 송금하지 않고 수신자를 찾습니다.

## 시작하기

### `quickstart`

CLI가 사용할 비즈니스 계정을 설정합니다. 대화형으로 선택하거나 생성하거나, `--account_id biz_xxx` / `--business_name`을 전달하세요.

### `apps`

`*.whop.site` 및 연결된 커스텀 도메인에서 제공되는, Whop에서 완전히 호스팅되는 웹 앱을 빌드하고 배포합니다.

| 명령 | 설명 |
| - | - |
| `whop apps init` | 앱 코드 시작: 새 앱을 등록하고(또는 `--app`으로 한 번도 배포되지 않은 앱을 가져오고), 스캐폴딩하고, 프로젝트를 연결합니다. `--account_id`는 다른 비즈니스에 등록하며, `--template storefront`는 완전한 상점으로 시작합니다 |
| `whop apps dev` | 이 앱의 로컬 개발 서버 실행 |
| `whop apps deploy` | 이 앱을 빌드, 업로드하고 라이브로 배포(`--preview`는 승격 없이 업로드) |
| `whop apps pull` | 앱의 배포된 소스를 가져와 이 디렉터리에 병합 |
| `whop apps create` / `get` / `list` / `update` / `delete` | 앱 레코드 관리 |
| `whop apps builds get` / `list` / `promote` | 앱 빌드 관리. 이전 빌드를 승격하는 것이 롤백하는 방법입니다 |
| `whop apps secrets list` / `set` / `unset` | 호스팅 런타임에 환경 바인딩으로 주입되는 앱 시크릿 관리 |
| `whop apps logs` | 앱 로그 나열 |
| `whop apps categories` | App Store 카테고리 나열 |

## 커머스

### `products`

판매하는 항목입니다. 각 상품은 변형와 상점 페이지를 소유합니다.

`create` · `get` · `list` · `update` · `delete` · `publish` · `unpublish`

`create`와 `update`는 업로드된 파일 `id` 또는 완료된 `direct_upload_id`를 포함하는 객체의 JSON 배열로 `--gallery_images`를 받습니다:

```bash theme={null}
whop products update prod_xxxxxxxx --gallery_images '[{"id":"file_xxxxxxxx"}]'
```

배열은 표시 순서대로 갤러리를 대체하므로 유지하려는 모든 파일을 포함하세요. 비우려면 `'[]'`를 전달하세요. 옵션을 생략하면 갤러리가 유지됩니다. `banner_image`는 별개이며 마켓플레이스 갤러리 요구 사항을 충족하지 않습니다.

### `waitlist-entries`

대기자 명단에 참여하고 승인 대기 중인 고객 가입을 관리합니다.

`create` · `get` · `list` · `approve` · `approve_all` · `deny` · `cancel`

### `variants`

상품의 구매 가능한 구성입니다.

`create` · `get` · `list` · `update` · `delete` · `calculate_tax`

### `promo-codes`

크리에이터가 결제용으로 구성하는 할인입니다.

`create` · `get` · `list` · `delete` · `activate` · `deactivate`

### `memberships`

결제부터 취소까지, 고객의 변형 구매입니다.

`get` · `list` · `update` · `cancel` · `pause` · `resume` · `reactivate` · `extend` · `transfer` · `invite` · `apply_promo_code` · `assign_affiliate` · `resync_access`

### `checkout-configurations`

변형를 공유 가능하고 미리 채워진 결제 링크로 만듭니다.

`create` · `get` · `list` · `delete`

### `shipments`

운송업체 추적 번호로 주문 배송을 추적합니다.

`create` · `get` · `list` · `update`

## 핵심 리소스

### `accounts`

Whop의 비즈니스: 프로필, 지갑, 기능, 설정.

`create` · `get` · `list` · `update` · `delete` · `suspend` · `form_company` · `transfer_ownership` · `preferences` · `update-preferences` · `reserves` · `retry_ads_payment`

`fees`: `get` · `update`

`financing-applications`: `list` · `get` · `create` · `update` · `submit`

계정의 판매자 결제 금융 신청을 관리합니다. 신청을 생성할 때 기존의 열린 신청이 있으면 그 신청이 반환됩니다. 생성만으로는 신청이 검토를 위해 제출되지 않습니다. 판매자가 약관에 동의한 후 `submit`이 제출합니다. 계정 및 신청 인수는 각 명령을 `--help`와 함께 실행하여 확인하세요.

### `users`

Whop의 사람: 프로필과 연결된 ID.

`get` · `list` · `update` · `access` · `recommend_actions` · `fees`

`preferences`: `get` · `update`

`preferences notifications`: `topics` · `experiences` · `update`

### `team-members`

계정의 팀 멤버와 그들의 액세스 범위를 정하는 역할입니다.

`create` · `get` · `list` · `delete`

### `members`

모든 구매에 걸친, 한 구매자와 계정의 관계입니다.

`get` · `list` · `logs`

### `economic-intelligence`

계정 자체의 데이터에서 생성된, 성장을 위해 계정이 다음에 해야 할 일입니다.

`list` · `update`

### `webhooks`

이벤트가 발생할 때 서버로 푸시되는 이벤트 알림입니다.

`create` · `get` · `list` · `update` · `delete` · `test` · `deliveries` · `deliveries-replay` · `replay`

### `stats`

집계된 재무, 오디언스, 트래픽 보고입니다.

`time-series`: `list`(지표 카탈로그) · `get`(필터, 분류, 간격이 포함된 단일 지표)

`reports`: `list` · `platform_trends`

배열 플래그는 반복합니다(`--ad_campaign_ids adcamp_a --ad_campaign_ids adcamp_b`). 객체 플래그는 퍼널의 순서 있는 단계와 같은 JSON을 받습니다:

```bash theme={null}
whop stats time-series get funnel --from 2026-09-01 --to 2026-09-21 \
  --steps '{"1":{"event":"pixel.page"},"2":{"event":"payment.completed"}}'
```

### `verifications`

지급 및 카드 발급 전에 Whop이 요구하는 법적 신원입니다.

`create` · `get` · `list` · `update`

### `exports`

계정 대시보드 데이터의 비동기 CSV 덤프입니다.

`create` · `get` · `list`. 지급, 영수증, 프로모 코드 등 40개 이상의 내보내기 가능한 리소스를 지원합니다.

## 알림

### `notifications`

사용자의 알림 피드: 읽지 않음 배지, 읽음 표시, 앱 발송, 토픽 카탈로그.

`create`(발송) · `get` · `list` · `badges` · `mark_read` · `topics`

## 결제

### `payments`

구매자에 대한 청구와 구매자가 아직 완료해야 하는 단계입니다.

`create` · `get` · `list` · `update` · `capture` · `void` · `refund` · `retry` · `resume` · `fees` · `status` · `return_url`

### `payment-quotes`

결제 전에 가격이 책정된 구매: 항목, 프로모 코드, 세금.

`create` · `get`

### `refunds`

결제에서 구매자에게 반환된 금액입니다.

`get` · `list`

### `confirmation-tokens`

구매자로부터 수집한 결제 정보에 대한 단기 참조입니다.

`get`

### `setup-intents`

청구하지 않고 구매자의 결제 수단을 저장합니다.

`create` · `get` · `list` · `status` · `return_url`

### `payment-rules`

계정이 자체 결제를 결정하기 위해 작성하는 규칙입니다.

`create` · `get` · `list` · `update` · `replace` · `delete` · `activate` · `deactivate` · `fields`

### `disputes`

전체 증거 기록이 포함된, 계정에 제기된 지불 거절입니다.

`get` · `list` · `update`(증거) · `upload_evidence` · `submit` · `summary`

### `dispute-alerts`

지불 거절보다 먼저 도착하는 발급사 경고입니다.

`get` · `list`

### `resolution-center-cases`

구매자이든 판매자이든 결제에 대한 케이스를 제기하거나 응답합니다.

`create` · `get` · `list` · `reply` · `accept` · `deny` · `appeal` · `withdraw` · `request_info` · `events` · `summary`

## 자금

### `send`

잔액에서 Whop의 사람이나 비즈니스에게 송금합니다.

`whop send <recipient> <amount>`는 `@username`, 이메일 주소, `user_`, `biz_` 또는 `ldgr_` ID, 또는 검색할 이름을 받습니다. CLI가 사용 중인 비즈니스에서, 또는 `--from`으로 다른 비즈니스에서 송금합니다. 다른 앱과 마찬가지로 CLI는 개인 잔액에서 송금할 수 없습니다. 터미널에서는 누가 받을지 보여주고 송금 전에 확인을 요청합니다. 스크립트와 에이전트는 사용자가 확인하면 `--yes`와 함께 실행할 정확한 명령을 받습니다. `--dry-run`은 송금하지 않고 수신자를 보여줍니다.

### `ledgers`

계정 또는 사용자 잔액의 기반이 되는 활동 피드입니다.

`list`(재무 활동) · `report`(잔액 요약, 손익계산서, 잔액 활동) · `breakdown`

### `payouts`

잔액에서 은행이나 지갑으로 송금합니다.

`create` · `get` · `list` · `cancel` · `quotes` · `methods` · `create-method` · `update-method` · `delete-method` · `supported-methods`

### `cards`

잔액에서 지출하는 카드를 발급합니다.

`create` · `get` · `list` · `update` · `transactions` · `get-transaction`

### `cashback-rules`

플랫폼이 후원하는 카드 캐시백을 구성합니다.

`create` · `list` · `update` · `payout`

### `transfers`

Whop 계정과 사용자 간에 자금을 이동합니다.

잔액 이체 또는 클레임 링크용 `create` · `get` · `get-claim-link` · `claim` · `list` · `recipients`

`whop transfers create --type balance --origin_id biz_xxx --destination_id user_xxx --amount 10 --currency usd --idempotency-key <key>`로 잔액에서 송금하세요. 수신자의 ID는 `whop transfers recipients --origin_id biz_xxx --query @username`으로 찾으세요.

`whop transfers get-claim-link <id>`로 `airdrp_` ID 또는 공개 클레임 코드를 사용해 자금이 충전된 클레임 링크를 조회하세요. 계정 ID의 경우 호출자는 자금 제공 계정에 대한 `airdrop_link:basic:read` 권한이 필요합니다. 개인 ID의 경우 계정 소유자로 로그인하세요. 공개 미리보기에는 클레임 코드를 사용하세요. `whop transfers claim <code>`는 공개 클레임 코드로 링크를 사용합니다. 클레임 링크 ID로는 사용 권한이 부여되지 않습니다.

### `deposits`

잔액에 자금을 추가합니다.

`create`

### `swaps`

잔액을 다른 통화로 변환합니다.

`create` · `get` · `quote` · `status`

### `trades`

트레이딩 계정 주소와 Hyperliquid 웹소켓 구독을 읽고 이전 거래 제출을 나열합니다. 이 명령은 주문을 넣거나 자금을 이동하지 않습니다. 실시간 포지션과 미체결 주문은 웹소켓을 통해 Hyperliquid에서 읽으세요.

> [!NOTE]
>
> 트레이딩 계정 액세스는 요청 시 제공됩니다. 액세스하려면 [support@whop.com](mailto:support@whop.com)으로 이메일을 보내세요.

```bash theme={null}
whop accounts get biz_xxx --include_trading true --format json
whop users get me --include_trading true --format json
whop trades list --format json
whop trades get trop_xxx --format json
```

`whop trades list`와 `whop trades get`은 실시간 체결이 아닌 이전 제출 기록을 반환합니다.

## 제휴 프로그램

### `product-affiliates`

추천이 없는 제휴자를 포함하여 상품을 홍보하도록 등록된 사용자입니다.

`list`

## 파트너

### `partner-referral-requests`

비즈니스 또는 파트너 귀속을 요청하고 승인을 관리합니다.

`create` · `get` · `list` · `accept` · `decline` · `cancel`

### `partners`

Whop에 추천한 사용자와 비즈니스, 그리고 이를 통해 얻는 수익입니다.

`create`(등록) · `retrieve <id>`(사용자 ID 또는 `me`) · `get` · `list` · `earnings` · `referred_users` · `leaderboard`

## 인력

### `bounties`

검토된 제출물과 에스크로 보상이 있는 유료 작업입니다.

`create` · `get` · `list` · `update` · `cancel` · `submissions` · `get-submission`

### `bounty-submissions`

시도부터 지급까지, 바운티에 제출된 작업입니다.

`create` · `get` · `list` · `submit` · `delete`(취소)

## 추적

### `people`

신원, 구매, 트래픽 프로필이 포함된 계정의 방문자와 고객입니다.

`get` · `list`

### `events`

어트리뷰션을 위해 추적되는 전환 및 참여 이벤트입니다.

`create` · `list` · `pulse` · `validate_pixel`

## 광고

### `ads`

크리에이티브: 문구, 에셋, 도착 URL.

`create` · `get` · `list` · `update` · `delete` · `duplicate` · `pause` · `unpause`

### `ad-campaigns`

광고 세트의 플랫폼, 목표, 예산입니다.

`create` · `get` · `list` · `update` · `delete` · `duplicate` · `pause` · `unpause` · `retry_payment`

### `ad-groups`

캠페인 내의 오디언스, 일정, 예산입니다.

`create` · `get` · `list` · `update` · `delete` · `duplicate` · `pause` · `unpause`

### `audiences`

광고 그룹을 위한 재사용 가능한 타기팅 목록입니다.

`create` · `list` · `update` · `delete` · `add_people`

## 미디어

### `files`

로컬 파일을 업로드하고 업로드된 파일 정보를 조회합니다.

`create`(`--filepath`는 로컬 파일을 처음부터 끝까지 업로드) · `get` · `list` · `complete`(멀티파트 업로드 완료)

### `media`

잔액에서 청구되는 AI 생성 에셋입니다. 파일을 받는 곳 어디에나 첨부할 수 있습니다.

`generate`(이미지 또는 동영상, `--wait`는 완료될 때까지 대기) · `get`

## 신원

### `external-accounts`

계정 또는 사용자에 연결된 다른 플랫폼의 계정입니다.

`connect` · `create` · `list` · `delete` · `refresh` · `posts` · `lead_forms` · `partners` · `add-partner` · `remove-partner`

### `social-accounts`

외부 계정을 위한 지원 중단된 호환성 엔드포인트입니다.

`connect` · `create` · `list` · `delete` · `refresh` · `posts` · `lead_forms` · `partners` · `add-partner` · `remove-partner`

## 개발자

### `domains`

호스팅된 앱에 할당된 커스텀 도메인입니다.

`get` · `list` · `update` · `delete`

### `api-keys`

계정 또는 앱의 프로그래밍 방식 자격 증명입니다. `permissions` 하위 명령은 권한 카탈로그를 나열합니다.

`permissions`(권한 카탈로그)

### `api-logs`

계정의 API 키로 Whop API에 보낸 요청입니다.

`list`

### `permissions`

자격 증명이 리소스에 대해 할 수 있는 작업입니다.

`check`

### `experiments`

계정의 실험을 생성하고 관리합니다. 소유 비즈니스를 선택하려면 `--account_id`를 전달하세요. 계정 실험은 태그를 받지 않습니다. 실험 생성은 아직 모든 계정에서 사용할 수 있는 것은 아닙니다.

`list` · `create` · `get` · `update` · `exposures` · `activate` · `pause` · `end`

### 피드백 및 질문

```bash theme={null}
whop report-feedback --content "The error message does not explain which permission is missing."
whop ask-question --content "How do trials interact with an existing subscription?" --format json
```

두 명령 모두 Whop 내부 검토를 위해 하나의 의견을 제출하고 접수증을 반환합니다. `ask-question`은 답변되지 않은 질문을 기록합니다. 답변을 반환하거나 지원 대화를 시작하지는 않습니다. `whop login`(브라우저 OAuth)의 사용자 자격 증명을 사용하세요. `--content`에서 시크릿, 개인 데이터, 결제 정보를 제거하세요.

영향을 받는 리소스의 계정을 식별하려면 `--account_id biz_...`를 사용하세요. 두 명령 모두 가능한 경우 기본적으로 활성 계정을 사용합니다. 계정 컨텍스트는 선택 사항입니다.

## 인증

### `auth`

인증을 관리합니다.

`login` · `logout` · 활성 ID에 대한 `status` · `list` · `switch` · `account`, 그리고 최상위 별칭 `whop login`과 `whop logout`

CLI는 머신에 바인딩된 키로 암호화하여 `~/.config/whop/credentials.json`에 자격 증명을 저장합니다. MCP 클라이언트는 이 명령을 실행할 수 없습니다.

## 통합

### `skills`

스킬 파일을 에이전트에 동기화합니다.

`add` · `list`. [에이전트 모드](https://docs.whop.com/ko/cli/agent-mode.md)를 참조하세요.

### `mcp`

CLI를 에이전트의 MCP 서버로 등록합니다.

`add`(`--agent claude-code`는 하나의 에이전트를 대상으로 하고, `--no-global`은 프로젝트에 설치) · `doctor`(서버 시작 및 도구 목록 검증). [에이전트 모드](https://docs.whop.com/ko/cli/agent-mode.md)를 참조하세요.

### `completions`

셸 자동 완성 스크립트를 생성합니다.

`whop completions <bash|fish|nushell|zsh>`


## Related topics

- [Whop CLI](https://docs.whop.com/ko/cli/overview.md)
- [Whop CLI 에이전트 모드](https://docs.whop.com/ko/cli/agent-mode.md)
- [React Native로 Whop 앱 구축하기](https://docs.whop.com/ko/developer/guides/react-native.md)
