> ## 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.

# API 버전

> 날짜가 지정된 API 버전에 요청을 고정하여 API 변경 사항이 연동을 손상시키지 않도록 하세요.

Current API는 날짜로 버전이 관리됩니다. 호환성을 깨는 변경 사항은 사용자가 직접 선택하는 새로운 날짜 버전 안에서만 배포됩니다. 버전을 고정하면 기준으로 삼은 요청 및 응답 형태가 절대 변경되지 않습니다. 공식 SDK는 생성에 사용된 버전을 자동으로 전송합니다.

```bash theme={null}
curl https://api.whop.com/api/v1/variants \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-07-23"
```

| 전송하는 값 | 받는 결과 |
| - | - |
| `Api-Version-Date: 2026-07-23` | 해당 날짜 기준으로 작동하던 API |
| 헤더 없음, API 키에 고정 버전 있음 | API 키에 저장된 API 버전 |
| 헤더 또는 저장된 고정 버전 없음 | 원래의 `2025-01-01` 동작 |
| 알 수 없는 날짜 | 지원되는 버전 목록이 포함된 `400` 오류 |

> [!NOTE]
>
> **`Api-Version-Date`를 전달하지 않고 저장된 API 키 고정 버전도 없다면 안정적인 API 모델이 사용됩니다.** 둘 다 없는 요청은 버전 관리 이전의 동작으로 처리되므로 기존 연동은 변경 없이 계속 작동합니다. 최신 API를 사용하려면 날짜 버전을 고정하세요.

## API 키 버전 고정

API 키는 자체 API 버전 고정 값을 가집니다. API 키로 인증된 요청은 `Api-Version-Date`를 생략하면 해당 고정 버전을 사용합니다. 저장된 고정 버전이 없는 기존 키는 `2025-01-01`을 사용합니다. 새로 생성된 키는 최신 릴리스 버전을 사용합니다.

명시적인 `Api-Version-Date` 헤더는 항상 API 키의 고정 버전보다 우선하므로, 저장된 버전을 변경하기 전에 업그레이드를 테스트할 수 있습니다.

모든 버전은 새 엔드포인트와 선택적 필드를 자동으로 받습니다. 호환성을 깨는 변경 사항은 새로운 날짜 버전을 생성하며, 아래 변경 로그에 나열됩니다.

업그레이드할 때는 대상 월의 항목만이 아니라 현재 고정 버전 이후부터 대상 버전까지의 모든 항목을 검토하세요. 특히 `2026-07-20`에서 9월로 업그레이드하면 `2026-07-23`의 멤버 및 멤버십 마이그레이션을 거치게 됩니다.

## 변경 로그

아래에 나열된 TypeScript SDK 릴리스는 기본적으로 해당 항목의 API 버전을 사용합니다. `apiVersionDate`를 재정의하면 응답 버전은 변경되지만 SDK 타입은 변경되지 않습니다.

**2026-11-17**

레벨은 레벨과 포인트만 유지합니다

[Retrieve user](https://docs.whop.com/ko/api-reference/users/retrieve-user.md) 및 [Retrieve account](https://docs.whop.com/ko/api-reference/accounts/retrieve-account.md)의 `level`에는 이제 `current`, `points`, `points_by_source`, `resets_at`이 있으며, 계정에는 `account_level`도 있습니다.

다음 필드는 `level`에서 제거됩니다: `levels`, `points_to_next`, `monthly_qualifying_spend`, `monthly_card_spend`, `monthly_ads_spend`, `monthly_trading_volume`. 계정의 `level`에서 `boosted`가 제거됩니다. 계정의 `account_level`이 `current`보다 낮으면 해당 계정은 부스트된 상태입니다.

**2026-11-16-2**

레벨의 `applied_level`은 이제 `current`입니다

[Retrieve user](https://docs.whop.com/ko/api-reference/users/retrieve-user.md) 및 [Retrieve account](https://docs.whop.com/ko/api-reference/accounts/retrieve-account.md)에서 `level.applied_level`의 이름이 `level.current`로 변경됩니다. 값은 변경되지 않습니다: 적용되는 레벨로, `0`부터 `10`까지입니다.

**2026-11-16-1**

추천 사용자 목록은 11월 17일 이후 응답을 중단합니다

`GET /partners/referred_users`는 2026년 11월 17일 이후 응답을 중단합니다. 11월 18일부터 모든 버전이 `410`을 반환합니다. 그때까지 각 응답에는 `Deprecation` 및 `Sunset` 헤더가 포함됩니다. 이 목록에는 대체 항목이 없습니다.

**2026-11-16**

사용자에 대한 기여 요청이 종료되었습니다

파트너는 더 이상 사용자에게 기여 요청을 보낼 수 없습니다. 이는 이 버전뿐만 아니라 모든 API 버전에 적용됩니다.

[Create a partner referral request](https://docs.whop.com/ko/api-reference/partner-referral-requests/create-a-partner-referral-request.md)는 `target_user_id`, `target_username`, `target_email`을 `code`가 `user_referral_requests_retired`인 `400`으로 거부합니다. 비즈니스에 대한 기여를 요청하려면 `account_id` 또는 `account_url`을 전송하세요. 사용자에게 보낸 요청은 더 이상 목록에 표시되거나 조회되지 않으며, [list partner referral requests](https://docs.whop.com/ko/api-reference/partner-referral-requests/list-partner-referral-requests.md)의 `target_user_id` 필터는 요청을 반환하지 않고, 요청의 `user`는 항상 `null`입니다.

**2026-11-14-1**

사용자의 레벨이 공개됩니다

[Retrieve user](https://docs.whop.com/ko/api-reference/users/retrieve-user.md)는 본인뿐만 아니라 계정이 Whop Levels에 속한 모든 사용자에 대해 `level`을 반환합니다. `level.applied_level`은 사용자의 레벨로, `0`부터 `10`까지입니다.

`points`, `points_by_source`, `monthly_*` 금액, `levels` 등 `level`의 다른 필드는 예약된 ID `me`로 본인을 조회하고 잔액 읽기 스코프가 있는 경우가 아니면 `null`입니다. 읽기 전에 `null`인지 확인하세요.

**2026-11-14**

본인의 구매 목록 조회 및 조회

사용자 자격 증명으로 [list payments](https://docs.whop.com/ko/api-reference/payments/list-payments.md)에 `user_id=me`를 사용하면 본인의 결제가 반환됩니다. 여기에는 모든 계정에서의 구매와 판매를 대행하는 계정에서의 결제가 포함됩니다. 구매한 계정의 `account_id`를 추가하면 해당 구매만 나열됩니다. [Retrieve payment](https://docs.whop.com/ko/api-reference/payments/retrieve-payment.md)는 본인이 구매한 결제를 반환합니다.

구매에는 구매자로서 볼 수 있는 정보가 표시됩니다. `amount_after_fees`, `usd_total`, `holds`, `metadata` 같은 계정 측 필드는 null이거나 비어 있습니다. `amount_charged`는 구매자 수수료를 포함하여 청구된 금액을 나타냅니다.

**2026-11-13-1**

팀 멤버는 계정을 객체로 포함합니다

팀 멤버에는 더 이상 최상위 `account_id`가 없습니다. 계정 ID는 `account.id`에서 읽으세요. `account` 객체에는 계정의 `title`, `route`, `logo_url`도 있습니다.

**2026-11-13**

리드 API가 종료되었습니다

`/leads` 엔드포인트는 지원 중단되었으며 더 이상 API 레퍼런스에 나열되지 않습니다. 이 버전 이상에서는 `410`을 반환합니다. 이전 버전은 2026년 11월 20일까지 `Deprecation`, `Sunset` 및 후속 `Link` 헤더와 함께 계속 작동합니다. 그 이후에는 모든 버전이 `410`을 반환합니다.

각 리드는 해당 비즈니스의 멤버이기도 하며, 멤버의 `metadata`에 리드 ID가 `lead_id`로 있습니다. 리드 목록 대신 [List members](https://docs.whop.com/ko/api-reference/members/list-members.md)를 사용하세요. 이메일로 멤버를 추가하려면 [Create member](https://docs.whop.com/ko/api-reference/members/create-member.md)를 사용하세요. 멤버를 읽거나 업데이트하려면 [Retrieve member](https://docs.whop.com/ko/api-reference/members/retrieve-member.md)와 [Update member](https://docs.whop.com/ko/api-reference/members/update-member.md)를 사용하세요.

**2026-11-12**

추천 사용자 목록이 지원 중단되었습니다

`GET /partners/referred_users`는 지원 중단되었으며 더 이상 API 레퍼런스에 나열되지 않습니다. 기존 연동을 위해 모든 응답에 `Deprecation` 헤더와 함께 계속 응답하며, 대체 항목은 없습니다.

**2026-11-11**

반복 청구서에 선불 수수료가 포함됩니다

청구서를 생성하거나 항목을 교체하면 첫 번째 청구서에 반복 변형의 `initial_price`와 `renewal_price`가 청구됩니다. 갱신 청구서에는 `renewal_price`만 청구됩니다. 다른 필드를 편집해도 청구서에 저장된 가격은 유지됩니다.

첫 번째 청구서를 결제하면 변형의 체험 기간 없이 즉시 유료 청구 기간이 시작됩니다. 유한한 결제 횟수에는 해당 청구서가 포함됩니다: $75 선불 수수료와 $40 할부 3회의 경우 $115, $40, \$40이 청구됩니다.

**2026-11-10-1**

갱신되는 Economic Intelligence 오퍼는 `3_days`입니다

TypeScript SDK: [`@whop/sdk@2.8.0`](https://unpkg.com/@whop/sdk@2.8.0/dist/esm/BaseClient.mjs).

[Retrieve account preferences](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-preferences.md)의 `economic_intelligence_offers`에 있는 갱신 오퍼의 키가 이제 `3_days`입니다. 3일마다 갱신됩니다. 활성화하려면 [Update account preferences](https://docs.whop.com/ko/api-reference/accounts/update-account-preferences.md)에 `economic_intelligence_duration_key: "3_days"`를 전송하세요. `weekly` 키는 거부됩니다.

**2026-11-10**

광고 통계는 더 이상 `clicks`를 받지 않습니다

[Create ad stats](https://docs.whop.com/ko/api-reference/ads/create-ad-stats.md)에서 `clicks` 필드가 제거됩니다. 시간별 `clicks`는 Whop 픽셀이 기록한 광고의 페이지 조회수이며, 어떤 버전에서든 전송된 `clicks` 값은 무시됩니다.

**2026-11-07**

채팅 API: 채널, 멤버, 메시지

앱에 채팅을 구축하세요. [채널](https://docs.whop.com/ko/api-reference/channels/list-channels.md)은 다이렉트 메시지, 그룹 채팅, 커뮤니티 채팅, 지원 채팅을 다룹니다. [채널 멤버](https://docs.whop.com/ko/api-reference/channel-members/list-channel-members.md)는 사람을 추가하고 제거합니다. [메시지](https://docs.whop.com/ko/api-reference/messages/list-messages.md)는 전송, 편집, 고정, 반응, 투표가 가능합니다.

이 버전부터 `/messages`의 형태가 변경됩니다. 메시지에는 `user` 대신 `channel_id`와 `author`가, `is_edited`와 `is_pinned` 대신 `edited`와 `pinned`가 있습니다. 업데이트 대신 `POST /messages/{id}/pin` 및 `/unpin`으로 고정하세요. [Delete message](https://docs.whop.com/ko/api-reference/messages/delete-message.md)는 `204`를 반환합니다. 반응과 투표는 `POST /messages/{id}/react`, `/unreact`, `/vote`로 하세요.

**2026-11-06**

`bank_transfer` 원장 라인 유형이 종료되었습니다

Iron 은행 입금은 `line_type`이 `onchain_deposit`인 [원장 활동](https://docs.whop.com/ko/api-reference/ledgers/ledger-activity) 라인이며, `source.sender_address`는 `iron`입니다. 금융 활동 및 금융 보고서의 `line_types` 필터는 더 이상 `bank_transfer`를 받지 않습니다.

**2026-11-05-1**

지급 목록에 Whop Card가 포함됩니다

[List saved payout methods](https://docs.whop.com/ko/api-reference/payouts/list-saved-payout-methods.md)에는 계정의 Whop Card가 포함됩니다. [List payouts](https://docs.whop.com/ko/api-reference/payouts/list-payouts.md)에는 자금을 Whop Card로 옮긴 지급이 포함됩니다. 저장된 지급 수단과 [지급](https://docs.whop.com/ko/api-reference/payouts/payout)의 `payout_method`에는 `type`이 있습니다. `external`은 자금을 Whop 외부로 보냅니다. `whop_card`는 자금을 계정 자체의 Whop Card로 옮깁니다. 사용자가 출금 위치를 선택하는 목록에서는 `whop_card` 수단을 제외하세요.

**2026-11-05**

진행 중인 분쟁 제출은 `generating_response`를 보고합니다

증거가 결제 처리업체에 있고 아직 수락되지 않은 [분쟁](https://docs.whop.com/ko/api-reference/disputes/dispute)은 `under_review` 대신 `generating_response`를 보고합니다. 처리업체가 이를 수락하면 분쟁은 `under_review`로 이동합니다. 처리업체가 거부하면 분쟁은 `needs_response`로 돌아가며, 조회 시 `submission_failure_reason`이 제공됩니다. 두 이동 모두 `dispute.updated`로 전송됩니다.

**2026-11-04-1**

Whop Levels: 적용 레벨은 `applied_level`입니다

[사용자](https://docs.whop.com/ko/api-reference/users/user)와 [계정](https://docs.whop.com/ko/api-reference/accounts/account)의 `level`에서 `current`는 이제 `applied_level`이며, `processing_rate_percentage`는 제거됩니다. 레벨의 표준 카드 처리 비율은 `levels`의 해당 항목에서, 계정 자체의 요율은 [Retrieve account fees](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-fees.md)에서 읽으세요. 계정의 `level`에는 계정 자체 포인트가 도달한 레벨인 `account_level`도 추가됩니다.

**2026-11-04**

광고 인증이 제거되었습니다

Whop은 더 이상 광고 인증을 제공하지 않습니다. [Retrieve account preferences](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-preferences.md) 및 [Update account preferences](https://docs.whop.com/ko/api-reference/accounts/update-account-preferences.md)는 더 이상 `ads_certifications`를 반환하지 않으며, 업데이트에서도 더 이상 받지 않습니다.

**2026-11-03-1**

연결된 계정은 이제 하위 계정입니다

플랫폼 하위 계정은 subaccount라고 부릅니다. [List payments](https://docs.whop.com/ko/api-reference/payments/list-payments.md)와 [List disputes](https://docs.whop.com/ko/api-reference/disputes/list-disputes.md), 그리고 해당 요약 엔드포인트에서 `include_connected_accounts`는 이제 `include_subaccounts`입니다. [Update account preferences](https://docs.whop.com/ko/api-reference/accounts/update-account-preferences.md)에서 `covers_connected_account_negative_balances`는 응답과 업데이트 본문 모두에서 이제 `covers_subaccount_negative_balances`입니다. `connected_accounts` 그룹화를 사용하던 금융 보고서 행은 이제 `subaccounts`를 사용합니다.

**2026-11-03**

지급 요청에 견적이 필요합니다

[Create a payout](https://docs.whop.com/ko/api-reference/payouts/create-payout.md)에 이제 `quote_token`이 필요합니다. 먼저 `POST /payouts/quotes`를 호출한 다음, 견적이 만료되기 전에 동일한 지급 세부 정보와 함께 해당 토큰을 제출하세요. 견적이 없거나 유효하지 않으면 `invalid_payout_quote`와 함께 `400`이 반환됩니다. 불확실한 지급을 재시도할 때는 원래 토큰과 `Idempotency-Key`를 다시 전송하여 견적이 만료된 후에도 기존 지급을 복구할 수 있도록 하세요.

**2026-11-02-1**

초안이 생성된 후에는 청구서의 고객을 변경할 수 없습니다

[Update invoice](https://docs.whop.com/ko/api-reference/invoices/update-invoice.md)에서 초안의 현재 고객과 다른 `member_id`는 `null`을 포함하여 `400`을 반환합니다. 다른 사람에게 청구하려면 먼저 [초안을 무효화](https://docs.whop.com/ko/api-reference/invoices/void-invoice.md)하세요. 그런 다음 [새 청구서를 생성](https://docs.whop.com/ko/api-reference/invoices/create-invoice.md)하세요. 고객 없이 저장된 초안은 여전히 고객을 지정할 수 있습니다.

**2026-11-02**

Snapchat 연결이 제거되었습니다

[Connect an External Account](https://docs.whop.com/ko/api-reference/external-accounts/connect-an-external-account.md)는 `advertise` 스코프를 사용하던 마지막 플랫폼인 `snapchat`을 더 이상 받지 않으므로, `scopes` 필드도 제거되었습니다. `snapchat`이나 `scopes`를 전송하면 `400`이 반환됩니다.

**2026-10-30**

광고 캠페인에서 bid\_type이 제거되었습니다

광고 캠페인은 더 이상 `bid_type`을 받거나 반환하지 않습니다. 각 광고 네트워크가 자체 캠페인 입찰 방식을 선택하며, `desired_cost_per_result`는 모든 네트워크에서 목표값입니다: 광고 입찰 방식을 절대 변경하지 않습니다. `bid_type`을 전송하면 `400`이 반환됩니다.

**2026-10-29-8**

광고 연결이 제거되었습니다

광고는 Whop 자체 페이지와 프로필로 운영되므로 더 이상 광고를 위해 계정을 연결하지 않습니다. [Connect an External Account](https://docs.whop.com/ko/api-reference/external-accounts/connect-an-external-account.md)는 더 이상 `meta_business`를 받지 않으며, `tiktok`은 더 이상 `advertise` 스코프를 받지 않습니다. 둘 중 하나를 전송하면 `400`이 반환됩니다.

**2026-10-29-5**

전환 가치 규칙이 제거되었습니다

전환 가치 규칙이 제거되며, 광고 네트워크는 각 전환의 원래 값을 받습니다. 전환 가치 규칙 목록 조회는 지원 중단되었습니다: 빈 목록을 반환하고, 더 이상 문서화되지 않으며, 응답에 `Deprecation` 헤더가 포함됩니다. 다른 모든 전환 가치 규칙 엔드포인트는 `410`을 반환합니다.

**2026-10-29-4**

오디언스에서 참여 규칙이, 규칙 대상에서 플랫폼이 제거되었습니다

더 이상 소셜 참여로 오디언스를 구축할 수 없습니다. 기존 참여 오디언스는 여전히 `source_type` `engagement`로 나열되지만, 더 이상 `engagement`를 반환하지 않습니다. [Create audience](https://docs.whop.com/ko/api-reference/audiences/create-audience.md)에 `engagement`를 전송하거나 `source_type`으로 `engagement`를 전송하면 `400`이 반환됩니다. 전환 가치 규칙 대상은 더 이상 `platform`을 받거나 반환하지 않습니다. 각 대상은 Whop이 운영하는 모든 네트워크를 다루며, 대상에 `platform`을 전송하면 `400`이 반환됩니다.

**2026-10-29-3**

외부 계정 파트너가 지원 중단되었습니다

파트너십 광고는 더 이상 사용할 수 없습니다. 외부 계정의 파트너 목록 조회는 빈 목록을 반환합니다. 파트너를 추가하거나 제거하면 `400`이 반환됩니다. 이 엔드포인트는 더 이상 문서화되지 않으며, 응답에 `Deprecation` 헤더가 포함됩니다.

**2026-10-29-2**

복제에서 preserve\_engagement가 제거되고, 게시물 및 리드 양식 목록이 지원 중단되었습니다

광고 캠페인, 광고 그룹, 광고를 복제할 때 더 이상 `preserve_engagement`를 받지 않습니다. [Duplicate an Ad Campaign](https://docs.whop.com/ko/api-reference/ad-campaigns/duplicate-an-ad-campaign.md), [Duplicate an Ad Group](https://docs.whop.com/ko/api-reference/ad-groups/duplicate-an-ad-group.md), [Duplicate an Ad](https://docs.whop.com/ko/api-reference/ads/duplicate-an-ad.md)에 이를 전송하면 `400`이 반환됩니다. 외부 계정의 게시물 또는 리드 양식 목록 조회는 지원 중단되었습니다: 둘 다 빈 목록을 반환하고, 더 이상 문서화되지 않으며, 응답에 `Deprecation` 헤더가 포함됩니다.

**2026-10-29-1**

광고에서 post\_id가 제거되고, 타기팅 검색이 지원 중단되었습니다

광고는 더 이상 `post_id`를 반환하지 않습니다. 광고 그룹 타기팅 옵션 검색과 광고 그룹 도달 범위 추정은 지원 중단되었습니다: 둘 다 계속 작동하지만 더 이상 문서화되지 않으며, 응답에 `Deprecation` 헤더가 포함됩니다. 전환 가치 규칙 대상은 `platform`을 생략하여 Whop이 운영하는 모든 네트워크를 다룰 수 있습니다.

**2026-10-29**

광고에서 네트워크별 필드와 인지도 목표가 제거되었습니다

광고 캠페인, 광고 그룹, 광고는 더 이상 `platform`을 반환하지 않으며, [Create an Ad Campaign](https://docs.whop.com/ko/api-reference/ad-campaigns/create-an-ad-campaign.md)은 더 이상 이를 받지 않습니다. 새 캠페인은 `awareness` 목표를 사용할 수 없습니다. 기존 인지도 캠페인은 여전히 이를 반환합니다. 광고는 더 이상 `existing_post_id`, `post_source`, `external_accounts`, `translations`를 받거나 반환하지 않으며, 더 이상 `post_thumbnail_url`을 반환하지 않습니다. [Create an Ad Campaign](https://docs.whop.com/ko/api-reference/ad-campaigns/create-an-ad-campaign.md), [Create ad](https://docs.whop.com/ko/api-reference/ads/create-an-ad.md), [Update ad](https://docs.whop.com/ko/api-reference/ads/update-an-ad.md)에 제거된 필드나 목표로 `awareness`를 전송하면 `400`이 반환됩니다.

**2026-10-28-1**

광고에서 고급 게재 및 크리에이티브 필드가 제거되었습니다

광고 캠페인은 더 이상 `optimization_goal`을 반환하지 않습니다. 광고 그룹은 더 이상 `optimization_goal`, `conversion_location`, `message_apps`, `minimum_daily_spend`, `dynamic_creative`, `placements`, `frequency_cap`, `detailed_targeting`을 받거나 반환하지 않으며, Whop은 캠페인의 `objective`에 따라 게재를 설정합니다. 광고는 더 이상 `messaging_config`, `multi_advertiser_ads`, `lead_form`, `lead_form_id`, `music`을 받거나 반환하지 않습니다. 이 중 하나를 [Create ad group](https://docs.whop.com/ko/api-reference/ad-groups/create-an-ad-group.md), [Update ad group](https://docs.whop.com/ko/api-reference/ad-groups/update-an-ad-group.md), [Create ad](https://docs.whop.com/ko/api-reference/ads/create-an-ad.md), [Update ad](https://docs.whop.com/ko/api-reference/ads/update-an-ad.md)에 전송하면 해당 필드를 명시한 `400`이 반환됩니다.

**2026-10-28**

계정 변형 목록에서 레거시 청구서 변형이 제외됩니다

`account_id`를 사용한 [List variants](https://docs.whop.com/ko/api-reference/variants/list-variants.md)는 레거시 청구서용으로 생성된 변형(이후 청구서가 삭제된 변형 포함)을 제외합니다. 이를 읽으려면 ID로 [변형을 조회](https://docs.whop.com/ko/api-reference/variants/retrieve-variant.md)하세요. 지원 중단된 `GET /plans` 목록도 동일하게 동작합니다.

**2026-10-27-3**

스왑은 지갑 잔액을 초과하는 금액을 거부합니다

[Create swap](https://docs.whop.com/ko/api-reference/swaps/create-swap.md)에서 지갑의 `from_token` 잔액을 초과하는 소수 `amount`는 `400`을 반환합니다. 오류에는 사용 가능한 잔액이 명시됩니다. 이전 버전은 스왑을 시작한 다음 온체인에서 실패합니다. 잔액을 읽을 수 없는 경우 확인을 건너뜁니다. USDT 스왑은 카드 잔액에서도 인출할 수 있으므로 USDT는 확인하지 않습니다.

**2026-10-27-2**

다른 모든 리소스에서 변형을 변형(variant)으로 부릅니다

**멤버십, 멤버, 대기자 명단 항목.** 멤버십과 대기자 명단 항목에서 `plan_id`는 이제 `variant_id`이며, 대기자 명단 항목에 포함된 변형에서 `plan_type`은 이제 `billing_type`입니다. [Invite to a membership](https://docs.whop.com/ko/api-reference/memberships/invite-to-a-membership.md)과 [Create waitlist entry](https://docs.whop.com/ko/api-reference/waitlist-entries/create-waitlist-entry.md)는 `variant_id`를 받고, [Approve all waitlist entries](https://docs.whop.com/ko/api-reference/waitlist-entries/approve-all-waitlist-entries.md)는 `variant_id`를 받고 반환합니다. [List memberships](https://docs.whop.com/ko/api-reference/memberships/list-memberships.md)는 `variant_id`와 `variant_ids`로, [List members](https://docs.whop.com/ko/api-reference/members/list-members.md)는 `variant_ids`로, [List waitlist entries](https://docs.whop.com/ko/api-reference/waitlist-entries/list-waitlist-entries.md)는 `variant_id`로 필터링하며, `plan_id`와 `plan_ids`는 사용하지 않습니다.

**결제, 청구서, 분쟁.** 결제, 분쟁, Resolution Center 케이스에서 `plan_id`는 이제 `variant_id`이며, 해당 `line_items`에서 `plan_id`와 `plan_title`은 이제 `variant_id`와 `variant_title`입니다. 결제 견적 및 청구서 `line_items`에서 `plan_id`는 이제 `variant_id`입니다. [List payments](https://docs.whop.com/ko/api-reference/payments/list-payments.md)는 `plan_ids` 대신 `variant_ids`로 필터링합니다. [Create payment](https://docs.whop.com/ko/api-reference/payments/create-payment.md)와 [Create payment quote](https://docs.whop.com/ko/api-reference/payment-quotes/create-payment-quote.md)는 본문과 `line_items`의 각 항목에서 `plan_id`와 `plan` 대신 `variant_id`와 `variant`를 받습니다. 청구서 생성 및 업데이트는 `items`의 각 항목에서 `plan_id`와 `plan` 대신 `variant_id`와 `variant`를 받습니다. 인라인 `variant`는 `plan_type` 대신 `billing_type`을 받습니다. 이벤트에서 `related.plan`은 이제 `related.variant`입니다.

**체크아웃.** 체크아웃 구성에서 `plan`은 이제 `variant`이며, 그 `plan_type`은 이제 `billing_type`입니다. [Create checkout configuration](https://docs.whop.com/ko/api-reference/checkout-configurations/create-a-checkout-configuration.md)은 `plan_id` 대신 `variant_id`를, `plan` 대신 인라인 `variant`(`billing_type` 포함)를 받으며, [List checkout configurations](https://docs.whop.com/ko/api-reference/checkout-configurations/list-checkout-configurations.md)는 `variant_id`로 필터링합니다. 체크아웃 세션 요청 및 응답은 `items[].plan` 대신 `items[].variant`를 사용합니다.

**프로모션 코드 및 파트너.** [List promo codes](https://docs.whop.com/ko/api-reference/promo-codes/list-promo-codes.md)는 `plan_ids` 대신 `variant_ids`로 필터링하며, [Create promo code](https://docs.whop.com/ko/api-reference/promo-codes/create-promo-code.md)는 `variant_ids`를 받습니다.

**2026-10-27-1**

상품과 변형에서 변형을 변형(variant)으로 부릅니다

상품에서 `default_plan`은 이제 `default_variant`입니다. 변형과 상품에 포함된 변형에서 `plan_type`은 이제 `billing_type`입니다. [Create variant](https://docs.whop.com/ko/api-reference/variants/create-variant.md)는 `billing_type`을 받으며, [List variants](https://docs.whop.com/ko/api-reference/variants/list-variants.md)와 [List products](https://docs.whop.com/ko/api-reference/products/list-products.md)는 `plan_types` 대신 `billing_types`로 필터링합니다.

`/plans` 대신 `/variants`와 `variants` SDK 네임스페이스를 사용하세요. `/plans` 엔드포인트는 모든 버전에서 `Deprecation` 및 후속 `Link` 헤더와 함께 계속 응답합니다. 세금을 미리 보려면 같은 방식으로 지원 중단된 `POST /variants/{id}/calculate_tax` 또는 `POST /plans/{id}/calculate_tax`를 호출하는 대신 [결제 견적](https://docs.whop.com/ko/api-reference/payment-quotes/create-payment-quote.md)을 생성하세요.

변형 ID는 `plan_` 접두사를 유지하며, `plan:*` 권한 스코프와 `plan.*` 웹훅 이벤트 이름은 변경되지 않습니다.

**2026-10-27**

초대 시 대기 중인 팀 멤버를 반환합니다

[Create team member](https://docs.whop.com/ko/api-reference/team-members/create-team-member.md)가 멤버를 추가하는 대신 초대를 보내는 경우, `202` 응답은 이제 대기 중인 팀 멤버입니다. `status`는 `pending`이며 ID는 `ausri_`로 시작합니다. 응답에는 더 이상 `object`나 `invitation_sent`가 포함되지 않습니다.

**2026-10-24**

영수증 기반 청구서

네이티브 Invoices API는 `pay_` ID와 인라인 변형 생성을 포함한 변형 기반 `items`를 사용합니다. 생성 시 초안이 저장됩니다. 초안을 업데이트할 수 있으며, 더 이상 필요 없는 초안은 무효화할 수 있습니다. 청구 대상 고객은 멤버입니다. Whop 사용자에 속하지 않은 이메일은 새 사용자를 생성합니다. `recipient_emails`는 청구 대상 멤버와 별개인 청구서 자체의 전달 주소입니다. 구매자 수수료는 조정 가능한 비율입니다.

**2026-10-15-1**

계정에 더 이상 stablecoin\_rails가 포함되지 않습니다

계정에 더 이상 `stablecoin_rails`가 포함되지 않습니다.

**2026-10-15**

인증 문서 유형은 소문자입니다

[Create verification](https://docs.whop.com/ko/api-reference/verifications/create-verification.md)과 `owners`의 소유자에서 `document_type`은 소문자 값을 받습니다: `passport`, `id_card`, `drivers`, `residence_permit`. [신분 증명 문서](https://docs.whop.com/ko/developer/verification/identity-documents.md) 가이드에 국가별로 허용되는 문서가 나열되어 있습니다.

**2026-10-14-1**

입금 카드 청구가 methods 아래로 이동했습니다

[Create deposit](https://docs.whop.com/ko/api-reference/deposits/create-deposit.md)에서 저장된 결제 수단에 대한 청구가 최상위 `card`에서 `bank` 및 `crypto` 옆의 `methods.card`로 이동했습니다. 필드는 변경되지 않았으며, `payment_method_id`가 전달되지 않으면 여전히 `null`입니다. 이전 버전에 고정된 호출자는 최상위 `card`를 유지합니다.

**2026-10-14**

결제 수단 도메인이 지원 중단되고 도메인으로 대체됩니다

결제 수단 도메인 엔드포인트는 지원 중단되었으며 더 이상 API 레퍼런스에 나열되지 않습니다. 대신 [도메인](https://docs.whop.com/ko/api-reference/domains/domain) API의 `apple_pay` 기능으로 Apple Pay 도메인을 추가, 확인, 제거하세요:

* `GET /payment_method_domains`: `apple_pay=any`를 사용한 `GET /domains`, 또는 인증된 도메인의 경우 `apple_pay=ready`. `hostname` 대신 `domain`으로 호스트 이름을 필터링하세요.
* `GET /payment_method_domains/{id}`: `GET /domains/{id}`.
* `POST /payment_method_domains`: `domain`, `account_id`, `apple_pay: {}`를 사용한 `POST /domains`. 계정에 이미 도메인이 있다면 `apple_pay: {}`를 사용한 `PATCH /domains/{id}`.
* `POST /payment_method_domains/{id}/verify`: `POST /domains/{id}/check`.
* `DELETE /payment_method_domains/{id}`: `apple_pay: null`을 사용한 `PATCH /domains/{id}`. `DELETE /domains/{id}`는 해당 도메인의 모든 웹사이트를 포함하여 도메인 전체를 제거합니다.
* `status: verified`는 `apple_pay.state: ready`입니다. `status: pending`은 Whop이 도메인을 등록하는 동안에는 `apple_pay.state: pending`이고, 연결 파일을 호스팅하고 도메인을 확인할 때까지는 `action_required`입니다.

등록은 백그라운드에서 실행되므로 도메인을 생성하거나 확인하면 `pending`이 반환됩니다. `apple_pay.state`가 `ready` 또는 `action_required`가 될 때까지 도메인을 조회하세요.

`/payment_method_domains` 엔드포인트는 모든 버전에서 `Deprecation` 및 후속 `Link` 헤더와 함께 계속 응답합니다. 도메인은 ID를 유지하므로 `/domains/{id}`는 결제 수단 도메인이 반환한 ID를 받습니다. 도메인 API에는 `company:manage_checkout` 대신 `domain:read` 및 `domain:manage` 권한이 필요합니다.

**2026-10-13-1**

네이티브 리뷰

TypeScript SDK: [`@whop/sdk@2.5.0`](https://unpkg.com/@whop/sdk@2.5.0/dist/esm/BaseClient.mjs).

리뷰는 이제 네이티브 리소스를 사용합니다.

* 리뷰 목록 조회 및 조회는 게시된 리뷰만 반환합니다. 대기 중이거나 제거된 리뷰를 조회하면 `404`가 반환됩니다.
* 조회된 리뷰는 `company` 대신 `account`를 반환합니다.
* 리뷰 목록 조회는 `account_id` 또는 `product_id`로 필터링하고, `order`와 `direction`으로 정렬하며, 기본적으로 페이지당 20개의 리뷰를 반환합니다. 필터 없이 사용하면 사용자는 자신이 작성한 리뷰를, 계정 또는 앱 API 키는 해당 계정의 리뷰를 나열합니다.
* `company_id`는 더 이상 허용되지 않습니다. `account_id`를 사용하세요.
* `DELETE /reviews/{id}`는 로그인한 사용자가 작성한 리뷰를 삭제하며 `review:delete` 스코프가 필요합니다.

**2026-10-13**

계정에 더 이상 업종 그룹이 없으며, 계정 분류는 읽기 전용입니다

계정에 더 이상 `industry_group`이 포함되지 않으며, `PATCH /accounts/{id}`는 더 이상 이를 받지 않습니다. `business_type`과 `industry_type`이 계정을 분류합니다.

계정 분류는 읽기 전용입니다. Whop이 `business_type`과 `industry_type`을 설정하며, `PATCH /accounts/{id}`는 더 이상 이를 받지 않습니다.

**2026-10-09-2**

앱에 더 이상 이전 호스팅 URL이 나열되지 않습니다

TypeScript SDK: [`@whop/sdk@2.4.0`](https://unpkg.com/@whop/sdk@2.4.0/dist/esm/BaseClient.mjs).

앱에 더 이상 `previous_hosted_urls`가 포함되지 않습니다. 앱의 주소는 앱을 제공하는 도메인입니다: `GET /domains`로 나열하거나 앱의 `domains`를 읽으세요.

**2026-10-09-1**

이체 프로필, 금액, 생성 유형

이체는 `name`과 `logo_url`이 포함된 `origin` 및 `destination` 프로필을 반환합니다. `amount`와 `fee` 금액 객체에는 수신자 입금액과 모든 이체 수수료가 포함됩니다. 응답에는 사용 가능한 실패 타임스탬프와 추적 URL도 포함됩니다. 알 수 없는 과거 금액 및 전환 시간은 `null`입니다.

계정 필터 없이 `GET /transfers`는 호출자가 권한을 가진 계정과 개인 지갑 전체의 이체를 나열합니다. 계정 범위 자격 증명은 해당 계정으로 계속 제한됩니다.

`POST /transfers`에는 `balance` 또는 `claim_link` 중 하나인 `type`이 필요합니다. 이것이 없는 요청은 `400`을 반환합니다. `ledger` 유형의 이름은 `balance`로 변경되고, `wallet_send`는 제거됩니다. 이전 버전은 `ledger`와 `wallet_send`를 받으며, `type`이 생략되면 `balance` 이체를 생성합니다.

**2026-10-09**

결제 영수증 PDF 생성하기

결제에 더 이상 `pdf_url`이 포함되지 않습니다. 결제 영수증을 PDF로 받으려면 `POST /payments/{id}/generate_pdf`를 호출하세요. 파일을 다운로드할 `url`과 해당 링크가 만료되는 `expires_at`을 반환합니다.

**2026-10-08**

대기 중인 자금이 규정 준수 검토를 기다리고 있을 수 있습니다

TypeScript SDK: [`@whop/sdk@2.3.0`](https://unpkg.com/@whop/sdk@2.3.0/dist/esm/BaseClient.mjs).

계정의 `payment_controls.undated_pending_reason`은 `compliance_review`일 수 있습니다. 이는 판매자가 이미 제출한 인증이 검토 중이므로, 검토가 완료될 때까지 대기 중인 자금이 대기 상태로 유지된다는 의미입니다. 이전 버전에 고정된 호출자는 이 상태에서 `null`을 봅니다.

**2026-10-07-2**

Economic Intelligence를 매주 갱신할 수 있습니다

`economic_intelligence_offers`에는 끌 때까지 매주 갱신되는 `weekly` 오퍼가 포함됩니다. 각 오퍼에는 `auto_renew`가 있으며, `weekly`가 권장 오퍼입니다. 활성화하려면 `PATCH /accounts/{account_id}/preferences`에 `economic_intelligence_duration_key: "weekly"`를 전송하세요.

`economic_intelligence_offers`는 계정이 지금 선택할 수 있는 항목만 나열합니다. Economic Intelligence가 켜져 있는 동안에도 더 이상 `null`이 아닙니다: 약정 기간 중에는 업그레이드로서 `weekly`만 나열하고, `weekly`가 갱신 중일 때는 비어 있습니다. 이전 버전은 Economic Intelligence가 켜져 있는 동안 `null`을 유지하고, `weekly`를 제외하며, `1_day`를 권장합니다.

**2026-10-07-1**

저장된 카드 결제는 기본적으로 구매자가 있는 것으로 간주됩니다

`return_url`이 있는 저장된 결제 수단 청구(`member_id` 및 `payment_method_id`)는 이제 구매자가 있는 것으로 간주합니다. 이는 `off_session`을 생략한 경우에 적용됩니다. 카드 발급사가 구매자에게 인증을 요청하면 결제는 `next_action`과 함께 `requires_action` 상태가 됩니다. 자체 일정에 따른 갱신처럼 구매자 없이 카드를 청구하는 경우 `off_session: true`를 전달하세요.

**2026-10-07**

청구서 결제 수신자에게 더 이상 Whop 계정이 필요하지 않습니다

`recipient`로 지급 수단을 생성하면 발신자의 원장에 연결된 기본이 아닌 수신자 지급 계정이 생성됩니다. Whop 사용자, Whop 계정, 수신자 원장은 생성되지 않습니다. 수신자 응답에는 `first_name`, `last_name`, `country`가 포함됩니다. 더 이상 `user_id`는 포함되지 않습니다. 이전 API 버전은 Whop 사용자가 없을 때 수신자 세부 정보를 생략합니다. 이전 버전은 기존 수신자의 사용자 ID를 유지합니다.

**2026-10-06-2**

앱 빌드는 더 이상 AI 프롬프트를 받지 않습니다

앱 빌드를 생성할 때 더 이상 `ai_prompt_id`를 받지 않습니다.

**2026-10-06-1**

지표의 시계열에 자체 경로가 생겼습니다

지표의 시계열은 `GET /stats/time_series/{metric}`에서 조회하세요. `GET /stats/{metric}`도 여전히 이를 제공하며 `Deprecation` 헤더에 후속 경로를 명시합니다.

**2026-10-06**

소셜 계정은 외부 계정입니다

소셜 계정은 이제 외부 계정입니다. `/external_accounts`와 `externalAccounts` SDK 네임스페이스를 사용하세요. 이전 `/social_accounts` 엔드포인트는 모든 버전에서 `Deprecation` 및 후속 `Link` 헤더와 함께 계속 응답합니다. 외부 계정 ID는 `sacc_` 접두사를 유지하며, `social_account:*` 권한 스코프는 변경되지 않습니다.

광고는 요청과 응답 모두에서 계정을 `social_accounts` 대신 `external_accounts`로 명명합니다. 오디언스 참여 규칙은 계정을 `social_account_id` 대신 `external_account_id`로 명명합니다. `/external_accounts`에서 Instagram 계정을 소유한 페이지는 `parent_social_account` 대신 `parent_external_account`입니다. 고정된 API 버전이 없는 광고 웹훅은 `external_accounts`를 받습니다.

**2026-10-05-1**

사용자에 더 이상 소셜 계정이 포함되지 않습니다

사용자는 더 이상 `social_accounts`를 반환하지 않습니다.

**2026-10-05**

설정 인텐트는 백그라운드에서 저장됩니다

설정 인텐트를 생성하면 이제 `processing` 상태로 반환되며 결제 수단은 백그라운드에서 저장됩니다. 결제 생성은 이미 이 방식으로 작동합니다. 결과를 확인하려면 설정 인텐트를 폴링하거나 `client_secret`을 `handleNextAction`에 전달하세요. 최종적으로 저장되거나, 거부되거나, 구매자의 단계를 기다리게 됩니다. 이전 버전은 요청 중에 계속 저장합니다.

**2026-09-29**

예방된 분쟁은 prevented를 보고합니다

TypeScript SDK: [`@whop/sdk@2.1.0`](https://unpkg.com/@whop/sdk@2.1.0/dist/esm/BaseClient.mjs), [`@whop/sdk@2.2.0`](https://unpkg.com/@whop/sdk@2.2.0/dist/esm/BaseClient.mjs).

판정 전에 고객이 환불받은 분쟁은 이제 `closed` 대신 `status: prevented`입니다. 환불은 카드 네트워크(Visa RDR) 또는 이전 환불에서 이루어졌습니다.

**2026-09-28**

Economic Intelligence 실행에 자체 상태가 생겼습니다

Whop AI가 수행 중인 추천은 `status: running`입니다. 실행이 끝나면 `executed`가 되며, 추천을 수행하지 못하고 끝난 경우 `incomplete`가 됩니다. 이전 버전은 실행 중인 추천을 `ready`로, 미완료 추천을 `superseded`로 표시합니다.

추천은 `run_started_at`, `run_ended_at`, `run_by_user_id`, `result_url`, `acknowledged_at`도 반환합니다. 추천을 직접 실행하려면 `PATCH /economic_intelligence/{id}`에 `status: running`을 전송한 다음, `status: executed`(선택적 `result_url` 포함) 또는 `status: incomplete`를 전송하세요. 실행 완료된 실행을 확인한 것으로 표시하려면 `status: acknowledged`를 전송하세요. 추천은 `executed` 상태로 유지되며 `acknowledged_at`을 기록합니다.

**2026-09-25**

Economic Intelligence 기간은 키로 선택합니다

Economic Intelligence를 켜려면 `PATCH /accounts/{account_id}/preferences`에 `economic_intelligence_duration_days` 대신 `economic_intelligence_duration_key`를 전송하세요. `economic_intelligence_offers`에 있는 항목의 `key`를 사용하세요.

`economic_intelligence_offers`의 각 항목에는 `duration_days` 대신 `key`, `duration`, `duration_unit`이 있습니다. 기간은 `hours` 또는 `days` 단위로 계산할 수 있습니다.

**2026-09-24-1**

광고 문구에 언어 태그가 지정되며, Meta 광고를 다른 언어로 운영할 수 있습니다

광고의 `primary_texts`, `headlines`, `descriptions`는 요청과 응답에서 `{ language, text }` 객체의 배열입니다. 번역이 없는 광고에서는 `language`를 생략하세요. API는 일반 문자열을 거부하므로 대신 `[{ "text": "…" }]`를 전송하세요.

Meta 광고는 다른 언어로도 운영할 수 있습니다. `translations: { source_language, automatic_languages }`를 광고 자체 문구의 언어와 Meta가 자동으로 번역할 언어로 설정하세요. 그러면 해당 광고의 모든 문구와 `creatives` 항목은 `language`를 명시합니다. 광고 자체의 문구와 크리에이티브는 `source_language`를 사용하며, 직접 작성하는 각 언어에는 `primary_texts`와 `headlines` 항목, 그리고 선택적으로 `descriptions`와 `creatives` 항목이 있습니다. `translations: null`은 다른 언어를 끕니다.

이전 API 버전은 번역이 있는 광고를 업데이트할 수 없습니다. 이 버전을 명시한 400을 받습니다.

**2026-09-24**

Economic Intelligence는 선택한 기간 동안 켜집니다

Economic Intelligence를 켜려면 `PATCH /accounts/{account_id}/preferences`에 `economic_intelligence_duration_days`를 전송하세요. 각 기간의 수수료가 나열된 `economic_intelligence_offers`에서 기간을 선택하세요. Economic Intelligence는 `economic_intelligence_ends_at`까지 변경하거나 끌 수 없으며, 그때 자동으로 꺼집니다.

`economic_intelligence`는 읽기 전용입니다. 이를 전송하면 `400` 오류가 반환됩니다.

**2026-09-23**

권한 확인에 거래 액세스가 표시됩니다

TypeScript SDK: [`@whop/sdk@2.0.0`](https://unpkg.com/@whop/sdk@2.0.0/dist/esm/BaseClient.mjs).

`GET /permissions`는 계정의 권한 작업을 나열하거나 확인할 때 `crypto_wallet:trade`와 `crypto_wallet:trade:read`를 포함합니다.

**2026-09-22-4**

Economic Intelligence 작업 설명

Economic Intelligence 추천은 `expected_tool_calls`를 `tool_name`과 `description`이 있는 객체의 정렬된 배열로 반환합니다. 설명은 계획된 작업과 영향을 받는 리소스를 식별합니다. 이전 추천의 설명은 `null`입니다.

**2026-09-22-3**

파트너 추천 링크는 하나의 요청 유형을 사용합니다

파트너 추천 요청은 보상 유무와 관계없이 링크에 `request_type: "link"`를 사용합니다. 링크를 생성하거나 필터링할 때 `link`를 사용하세요. 승인된 직원만 보상을 구성할 수 있습니다.

**2026-09-22-2**

계정 보상에 파트너 보상 진행 상황이 표시됩니다

Retrieve Account는 `rewards`에 파트너 보상 마일스톤을 반환합니다. 각 마일스톤에는 해당 계정의 자격 진행 상황과 지급 상태가 포함됩니다. 일치하는 보상이 없거나 호출자에게 잔액 또는 통계 읽기 액세스가 없으면 이 필드는 빈 배열입니다.

레거시 온보딩 보상 형식은 종료됩니다. 이전 API 버전은 계정 응답에서 `rewards`를 생략합니다.

**2026-09-22-1**

설정 인텐트가 네이티브 리소스가 됩니다

네이티브 Payments API가 이제 `POST /setup_intents`, `GET /setup_intents`, `GET /setup_intents/{id}`를 제공합니다. Setup Intent 객체는 다른 모든 네이티브 리소스와 같은 형태를 갖습니다.

* 관련 레코드는 포함된 객체 대신 외래 키 ID입니다: `account_id`(이전 `company`), `member_id`(이전 `member`), `payment_method_id`(이전 `payment_method`), `checkout_configuration_id`(이전 `checkout_configuration`). 구매자는 `user` 요약(`id`, `username`, `name`, `profile_picture`)입니다.
* `error_message`는 Retrieve setup status가 반환하는 것과 동일한 `{ code, message }` 블록인 `last_setup_error`로 이동합니다. 무언가 실패하기 전까지 `null`로 유지되며, 설정이 성공하면 제거됩니다.
* `return_url`, `payment_method_type`, `updated_at`이 새로 추가됩니다. `created_at`과 `updated_at`은 ISO 8601 타임스탬프입니다.
* Payment 객체가 이미 포함하고 있는 표시용 수단인 `payment_instrument`가 Setup Intent에도 있으므로, 저장된 카드를 두 번째 요청 없이 렌더링할 수 있습니다. 두 리소스 모두에서 `card`에 `exp_month`와 `exp_year`가 추가됩니다. `card.brand`는 `null`일 수 있습니다: 저장소에 네트워크가 기록되지 않은 저장된 카드는 `card` 객체 전체를 잃는 대신 마지막 네 자리와 만료일을 유지합니다.
* 설정 인텐트를 생성하면 `201 Created`(이전 `200`)로 응답하고, `Idempotency-Key`를 준수하며, `confirmation_token` 또는 `payment_method_id` 중 정확히 하나가 필요합니다. 다른 계정의 확인 토큰은 `404`입니다.
* `client_secret`은 생성 및 조회 시 반환되며, 이 API를 통해 생성된 설정에 대해서만 반환됩니다. 설정에 대해 작업할 수 있는 호출자가 필요합니다: 계정의 `payment:charge` 자격 증명 또는 구매자 자신의 토큰. 목록 행은 항상 `null`입니다.
* 이 버전 이상으로 고정된 `setup_intent.requires_action`, `setup_intent.succeeded`, `setup_intent.canceled` 웹훅은 이 동일한 Setup Intent 객체를 `data`로 전달합니다. 이전 버전으로 고정된 웹훅과 고정되지 않은 웹훅은 이전 페이로드를 유지합니다.
* `GET /setup_intents`는 표준 `{ data, page_info }` 봉투와 커서 페이지네이션으로 나열합니다. `account_id`는 선택 사항입니다: 계정 API 키는 자체 계정을, 사용자 토큰은 읽을 수 있는 모든 계정을 나열합니다. `status`는 새 필터이며, 유효하지 않은 값은 `400`입니다. `created_before`와 `created_after`는 이전과 같이 작동합니다.

**2026-09-22**

광고 결제 재시도는 계정 엔드포인트를 사용합니다

`POST /ad_campaigns/{id}/retry_payment`는 `410 Gone`을 반환합니다. 모든 캠페인에 대한 결제 재시도를 한 번 대기열에 추가하려면 계정의 `biz_` ID로 `POST /accounts/{id}/retry_ads_payment`를 사용하세요. 재시도가 접수되었다고 해서 결제 성공이 확인되는 것은 아닙니다. 결과는 캠페인의 `delivery_status`와 `issues`를 확인하세요.

**2026-09-15**

세 가지 3D Secure 정책

TypeScript SDK: [`@whop/sdk@1.1.5`](https://unpkg.com/@whop/sdk@1.1.5/dist/esm/BaseClient.mjs).

계정, 변형, 체크아웃 구성, 체크아웃 세션은 세 가지 3D Secure 선택 사항을 제공합니다:

* `mandate_challenge`는 지원되는 온세션 카드 결제를 처리하기 전에 챌린지를 요청합니다.
* `mandate_if_required`는 결제 처리업체가 요구하는 경우에만 챌린지를 의무화합니다.
* `frictionless_if_required`는 일반 무마찰 3DS 흐름을 사용합니다.

\$1,000 이상의 결제는 최소 `mandate_if_required`를 사용합니다. 위험 및 인증 복구 요구 사항이 설정을 재정의할 수 있습니다. 명시적인 필수 챌린지는 플랫폼에서 활성화될 때까지 거부됩니다.

이전 API 버전은 기존 값을 유지합니다: 새로운 `mandate_challenge` 선택은 조건부로 유지되고, 기존 필수 설정은 보존되며, `frictionless`는 `frictionless`로 유지됩니다. 이전 버전의 계정은 무마찰을 `null`로 나타냅니다.

**2026-09-13**

거래 이체에 별도의 금융 보고서 카테고리가 있습니다

금융 보고서 행은 `trading_account_deposit`, `trading_account_withdrawal` 및 해당 `_offset` 항목을 다른 온체인 이체와 구분합니다. 금액과 잔액은 변경되지 않습니다.

이전 버전은 기존 카테고리를 유지합니다: 계정 입금은 `topup`, 계정 출금은 `onchain_withdrawal`. 전역 보고서는 해당하는 `onchain_deposit`, `onchain_withdrawal`, `_offset` 카테고리를 사용합니다. 일치하는 행은 이체 금액을 누락하지 않고 합산됩니다.

**2026-09-11-1**

화이트 라벨 판매자를 위해 Triple Whale 상태 이름이 변경되었습니다

계정 설정의 `ads_triple_whale_integration.status`는 `requires_shopify_store` 대신 `requires_shop_domain`을 보고합니다. 이제 연동에서 `shop_domain`을 명시적으로 설정할 수 있으므로, 연결된 Shopify 스토어가 더 이상 이를 제공하는 유일한 방법이 아닙니다.

**2026-09-11**

비즈니스 카테고리는 하나의 테이블에서 가져옵니다

TypeScript SDK: [`@whop/sdk@1.1.4`](https://unpkg.com/@whop/sdk@1.1.4/dist/esm/BaseClient.mjs).

계정의 `business_type`, `industry_group`, `industry_type`은 고정된 열거형 대신 Whop의 비즈니스 카테고리 테이블에서 가져온 문자열입니다. 새 카테고리는 새 API 버전 없이 표시됩니다. [비즈니스 유형 및 업종 용어집](https://docs.whop.com/ko/api-reference/accounts/business-types.md)에 현재 값이 나열되어 있습니다.

* `coaching_and_courses`는 이제 `education`, `physical_product`는 이제 `ecommerce`, `marketplace`는 이제 `platform`입니다.
* 업종 그룹과 유형은 8개의 비즈니스 유형 아래로 재구성되었습니다. `PATCH /accounts/{id}`는 용어집 슬러그만 받습니다. 알 수 없는 값은 `400`을 반환합니다.

이전 버전에 고정된 호출자는 여전히 이전 비즈니스 유형 이름을 받으며, 이 버전 이전에 존재하지 않았던 업종 값은 `null`로 반환됩니다.

**2026-09-09-1**

계정 소유 실험

실험을 생성하려면 `biz_` 접두사가 붙은 소유 `account_id`가 필요합니다. 실험은 선택적 리소스 참조와 계정에 로컬인 플래그 키도 받습니다. 목록 조회는 하나의 계정에 대한 실험을 반환하며, 읽거나 관리하려면 계정 권한이 필요합니다. 계정 실험은 팀 태그를 지원하지 않으며 보고 공급자를 프로비저닝하지 않습니다.

평가는 `subject[account_id]`, `subject[anonymous_id]`, `subject[user_id]`를 통해 대상을 식별합니다. 이전 버전의 호출자는 기존 평가 식별 매개변수를 유지합니다. 타기팅 `properties`는 JSON 쿼리 값으로 전달하세요. 기존 중첩 속성 쿼리 키도 계속 지원됩니다. 노출은 선택적 자격 증명을 받으며 이벤트에 해당 신원을 기록합니다.

**2026-09-09**

대기 중인 자금에 대한 명명된 Whop 출금 보류

TypeScript SDK: [`@whop/sdk@1.1.3`](https://unpkg.com/@whop/sdk@1.1.3/dist/esm/BaseClient.mjs).

Whop이 출금을 차단한 경우 계정의 `payment_controls.undated_pending_reason`은 `withdrawals_disabled`일 수 있으며, 이 경우 해당 대기 중인 자금은 사용 가능 상태가 될 수 없습니다.

`kyc_incomplete`, `pending_information_request`, 그리고 아직 정산 중인 자금에 대한 `null`은 변경되지 않습니다.

**2026-09-06**

참여 오디언스 소스

`POST /audiences`는 타입이 지정된 `engagement` 정의를 통해 동영상, 리드 양식, Instagram 프로필, Facebook 페이지와의 참여를 지원합니다.

* 명시적인 `source_type` 값은 필수 소스 필드가 있는지, 충돌하는 소스 필드가 없는지 검증합니다.
* 오디언스 응답에는 `engagement`가 포함되며, `source_type`은 `engagement`일 수 있습니다. 참여 오디언스는 유사 오디언스 소스로도 사용할 수 있습니다.
* `GET /social_accounts/{id}/posts`에는 플랫폼 식별자를 수동으로 찾지 않고도 동영상을 선택할 수 있도록 `video_id`와 `caption`이 포함됩니다.

**2026-09-04**

실험을 종료하려면 결과가 필요합니다

`POST /experiments/{id}/end`는 요청 본문에 `findings`가 필요합니다. 이는 무엇을 배웠는지, 실험이 왜 그렇게 끝났는지에 대한 짧은 설명입니다.

이전 버전에 고정된 호출자는 여전히 이를 생략할 수 있습니다. `400` 대신 이들을 대신하여 자리 표시자 결과 값이 기록됩니다.

**2026-09-02-2**

입금 대상은 계정 ID입니다

TypeScript SDK: [`@whop/sdk@1.1.1`](https://unpkg.com/@whop/sdk@1.1.1/dist/esm/BaseClient.mjs), [`@whop/sdk@1.1.2`](https://unpkg.com/@whop/sdk@1.1.2/dist/esm/BaseClient.mjs).

`POST /deposits`는 `destination` 계정 ID 문자열(`biz_…` 또는 `user_…`)만 받습니다.

* 원시 지갑 주소는 더 이상 허용되지 않습니다. 계정에 자금을 넣고 `methods.crypto`에서 주소를 읽으세요.
* `destination`의 객체 형식(`{ account_id }` / `{ address, network }`)이 제거됩니다. 계정 ID만 전송하세요.
* 최상위 `network` 재정의가 제거됩니다. 이는 응답을 변경한 적이 없습니다: 모든 입금은 이미 지원되는 모든 네트워크의 주소를 반환하므로 `methods.crypto`에서 원하는 것을 선택하세요.
* 요청과 응답 모두에서 `metadata`가 제거됩니다. 이 값은 그대로 반환될 뿐 저장되지 않았으므로 이후 입금을 대조하는 데 사용할 수 없었습니다.
* 이제 모든 대상이 계정을 지정하므로 응답의 `account_id`는 더 이상 null이 아닙니다.

이전 버전에 고정된 호출자는 객체 형식과 제거된 입력을 계속 전송하며, 응답에는 여전히 `metadata`가 포함됩니다(전송한 값이 아닌 빈 객체로). 지갑 주소는 모든 버전에서 거부됩니다: 계정을 식별한 적이 없으므로 계속 제공할 이전 형태가 없습니다. `payment_method_id`와 함께 전송된 `metadata`는 카드 청구에 첨부되므로 모든 버전에서 유지됩니다.

**2026-09-02-1**

결제가 네이티브 리소스가 됩니다

TypeScript SDK: [`@whop/sdk@1.1.0`](https://unpkg.com/@whop/sdk@1.1.0/dist/esm/BaseClient.mjs).

`POST /payments`, `GET /payments`, `GET /payments/{id}`는 이제 네이티브 Payments API에서 제공되며, Payment 객체는 다른 모든 네이티브 리소스와 같은 형태를 갖습니다.

* 관련 레코드는 포함된 객체 대신 외래 키 ID입니다: `account_id`(이전 `company`), `plan_id`, `product_id`, `membership_id`, `member_id`, `promo_code_id`, `shipment_id`, `payment_method_id`. 구매자는 `user` 요약(`id`, `username`, `name`, `profile_picture`)입니다.
* 금액은 단순 숫자 대신 금액 객체(`{ amount, currency, decimals, display_decimals }`)입니다: `total`, `subtotal`, `tax_amount`, `refunded_amount`, `tax_refunded_amount`, `amount_after_fees`, `usd_total`. `settlement_amount`, `settlement_currency`, `settlement_exchange_rate`는 `total`과 `currency`에 통합됩니다. `refunded_amount`와 `tax_refunded_amount`는 각 환불이 발행될 때 적용된 환율로 정산된 그대로 표시되며, `tax_refunded_amount`는 이제 조회뿐만 아니라 목록 응답에도 있습니다.
* 분쟁, 환불, Resolution Center 케이스는 더 이상 포함되지 않습니다. `?payment_id=`와 함께 각자의 엔드포인트에서 나열하세요. 포함된 금융 거래와 애플리케이션 수수료는 네이티브 형태로 이전되지 않습니다.
* `last_payment_attempt` / `next_payment_attempt`는 `last_payment_attempt_at` / `next_payment_attempt_at`입니다. 카드 정보는 `payment_instrument`에 있습니다.
* 결제를 생성할 때 `account_id`(이전 `company_id`)를 받고, `201 Created`로 응답하며, `Idempotency-Key`를 준수하고, 승인 보류를 걸기 위한 `capture: false`를 받습니다.
* 네이티브 결제 읽기는 계정 범위입니다: 자격 증명은 계정의 결제를 읽을 수 있어야 합니다(팀 멤버의 토큰 또는 계정의 API 키). 고정된 프록시 버전에서 본인 결제를 읽기 위해 허용되는 구매자 자신의 사용자 토큰은 아직 네이티브로 지원되지 않으므로, 구매자는 고정된 버전에서 계속 작동합니다.
* `GET /payments/{id}/fees` 행은 금액 객체가 포함된 `{ type, origin, label, description, amount, settlement_amount, collected_at }`입니다(이전 `name`/`amount`/`currency`/`type`).
* `GET /refunds`와 `GET /refunds/{id}`는 네이티브 Refund를 반환합니다: 포함된 결제 대신 `payment_id`와 `account_id`, 결제 정산 통화로 된 금액 객체 `amount`, 처리업체 통화로 된 `original_amount`. `company_id` 필터는 `account_id`이며, `company_id`를 전송하면 400입니다.
* `POST /payments/{id}/refund`, `POST /payments/{id}/retry`, `POST /payments/{id}/void`도 네이티브이며, 동일한 Payment 객체를 반환합니다. 환불은 여전히 선택적 `partial_amount`를 받습니다.
* `GET /payments`는 표준 `{ data, page_info }` 봉투와 커서 페이지네이션으로 나열합니다. 필터는 프록시의 복수 배열 대신 단수 동등 매개변수(`status`, `billing_reason`, `currency`, `plan_id`, `product_id`, `membership_id`, `member_id`, `user_id`, `account_id`)입니다. 프록시와 마찬가지로 `billing_reason=subscription_cycle`은 `subscription_update`로 기록된 갱신도 일치시킵니다. 금액이 0인 결제가 포함되므로 프록시의 `include_free`는 없어졌습니다. 유효하지 않은 `status`는 필터링되지 않은 페이지가 아닌 `400`이며, 프록시 전용 필터(`substatuses`, `updated_before`/`updated_after`, `checkout_configuration_ids`, 복수 배열)도 마찬가지입니다. `query` 구매자 검색은 이전과 같이 작동합니다. `created_before`/`created_after` 기간은 결제 생성 시간만 대상으로 합니다. 프록시는 결제 시간이 있는 경우 결제 시간으로 필터링했습니다. 목록 행에서 `settlement_time_at`은 null이므로, 이를 확인하려면 결제를 조회하세요.

**2026-09-02**

레거시 광고 보고서 엔드포인트가 종료되었습니다

레거시 `GET /ad_reports` 엔드포인트는 네이티브 [Stats](https://docs.whop.com/ko/api-reference/stats/stats) 지표와 광고 엔터티 엔드포인트로 대체되어 지원 중단되었습니다. 이 버전에서는 더 이상 제공되지 않습니다.

* `GET /ad_reports`는 `error.type`이 `gone`인 `410 Gone`을 반환합니다. 시간에 따른 `spend`, `impressions`, `clicks`는 `whop:adcamp_xxx:*` 같은 `source` 경로로 범위를 지정하여 `GET /stats/time_series/ad_delivery`를 사용하세요. 기여 전환은 `GET /stats/time_series/events`를 사용하세요.
* 기간별 엔터티 성과는 엔터티 엔드포인트에 있습니다. `GET /ad_campaigns`, `GET /ad_groups`, `GET /ads`는 `stats_from`과 `stats_to`를 받고 각 행에 `spend`, `results`, `return_on_ad_spend`를 반환합니다.
* 레거시 엔드포인트의 모든 응답은 버전에 관계없이 이제 `Deprecation` 및 `Link: <…/stats/ad_delivery>; rel="successor-version"` 헤더를 포함합니다. 이전 버전에 고정된 요청과 버전이 없는 요청은 `Sunset` 헤더가 모든 버전에서 응답이 중단되는 날짜를 알릴 때까지 변경 없이 계속 작동합니다.

**2026-08-31**

금융 보고서 타임스탬프 범위

`GET /financial_reports`와 `GET /financial_reports/breakdown`은 이제 보고서 기간에 `from` 및 `to` ISO 8601 타임스탬프를 사용합니다.

* `from_date`와 `to_date`의 이름이 `from`과 `to`로 변경됩니다.
* 날짜만 있는 값은 더 이상 허용되지 않습니다. 두 타임스탬프 모두에 시간과 오프셋을 포함하세요.

**2026-08-25-2**

명시적 앱 인증 필터링

`GET /apps`는 이제 공개 웹사이트 목록에서 `verified`가 없는 것을 `verified=false`로 처리하는 대신 선택적 동등 필터로 사용합니다.

* 두 인증 상태 모두에서 공개적으로 검색 가능한 웹사이트 블루프린트를 반환하려면 `verified`를 생략하세요.
* Whop 인증 블루프린트는 `verified=true`로, 커뮤니티 블루프린트는 `verified=false`로 설정하세요.
* `recommended=true`는 인증 상태와 관계없이 추천 앱을 필터링합니다.

**2026-08-25-1**

레거시 출금 엔드포인트가 종료되었습니다

레거시 `/withdrawals` 엔드포인트는 네이티브 [Payouts](https://docs.whop.com/ko/api-reference/payouts/payout) API로 대체되어 지원 중단되었으며 이 버전에서는 더 이상 제공되지 않습니다.

* `GET /withdrawals`와 `POST /withdrawals`는 `error.type`이 `gone`인 `410 Gone`을 반환합니다. 대신 `GET /payouts`와 `POST /payouts`를 사용하세요. 지급 ID는 동일한 `wdrl_` ID이므로 기존 식별자는 계속 확인됩니다.
* `GET /withdrawals/{id}`는 이 버전에서도 계속 응답합니다. 새 작업에는 `GET /payouts/{id}`를 사용하세요.
* 레거시 엔드포인트의 모든 응답은 버전에 관계없이 이제 `Deprecation` 및 `Link: <…/payouts>; rel="successor-version"` 헤더를 포함합니다. `Sunset` 헤더가 모든 버전에서 응답이 중단되는 날짜를 알릴 것입니다. 그때까지 이전 버전에 고정된 요청과 버전이 없는 요청은 변경 없이 계속 작동합니다.

**2026-08-25**

광고 게시물 ID

광고의 `post_id`는 이제 광고 제작 방식에 관계없이 광고 네트워크가 제공하는 게시물을 지정합니다.

* `post_id`는 광고에 대한 네트워크의 게시물을 반환합니다. 이는 업로드된 크리에이티브에 대해 Meta가 생성한 게시물이거나 홍보 중인 게시물입니다. 이전에는 업로드된 크리에이티브로 만든 모든 광고에서 `null`이었습니다.
* 광고가 가리키는 게시물은 응답과 생성/업데이트 본문 모두에서 `existing_post_id`로 이동했습니다. `post_source`와 `post_thumbnail_url`은 해당 필드를 설명합니다.

**2026-08-21-1**

네이티브 Files API

TypeScript SDK: [`@whop/sdk@1.0.14`](https://unpkg.com/@whop/sdk@1.0.14/dist/esm/BaseClient.mjs).

`POST /files`와 `GET /files/{id}`는 재설계된 파일 객체와 함께 네이티브로 제공되며, 멀티파트 업로드는 새로운 `POST /files/{id}/complete`를 통해 완료됩니다.

* 파일 응답은 표준 봉투를 포함합니다: `object`, `visibility`, ISO 8601 `created_at`. `size`와 `url` 필드는 업로드가 `ready`가 될 때까지 `null`입니다.
* `GET /files/{id}`는 본인이 생성한 파일만 확인하며, 다른 호출자는 404를 받습니다.

**2026-08-21**

지급 상태 v2

TypeScript SDK: [`@whop/sdk@1.0.13`](https://unpkg.com/@whop/sdk@1.0.13/dist/esm/BaseClient.mjs).

지급 객체의 수명 주기 용어가 재구성되고 금액 필드는 소수 문자열이 됩니다.

* `status`는 여덟 가지 값을 가집니다: `requested`, `in_review`, `processing`, `completed`, `reversed`, `canceled`, `failed`, `denied`. 공급자가 되돌린 정산된 지급은 `reversed`로 표시되며, 반환 코드와 `funds_returned_at`은 `failure`에 있습니다.
* 새 `status_detail` 필드는 상태 값 아래의 가장 세부적인 기계 단계를 나타냅니다. 그 값은 버전 증가 없이 늘어날 수 있으며, `status`가 버전 관리되는 계약입니다.
* `amount`, `fee_amount`, `net_amount`, `markup_fee`, `destination_amount`는 소수 문자열입니다. `exchange_rate`는 숫자로 유지됩니다.
* 지급은 `wdrl_` ID로 생성됩니다: `POST /payouts`가 반환하는 ID는 `GET /payouts`가 나열하는 ID이며, 지급의 전환 요청은 `payout_request_id`로 유지됩니다. 이 버전 이전에 생성된 전환 요청은 계속 `cofr_` ID로 응답합니다.
* 멱등성 키는 `Idempotency-Key` 헤더로만 전송되며, `idempotency_key` 본문 필드는 거부됩니다.

이전 버전에 고정된 요청은 이전 용어, 부동 소수점 금액, 본문 필드 멱등성 키를 유지합니다. 웹훅 페이로드도 같은 방식으로 구독의 `api_version_date`를 따릅니다: `2026-08-21` 이상으로 고정된 구독은 새 지급 형태를 받고, 이전 또는 고정되지 않은 구독은 이전 형태를 유지합니다.

**2026-08-14**

웹훅 봉투 account\_id

웹훅 봉투의 `company_id` 필드 이름이 `account_id`로 변경됩니다.

* `2026-08-14` 이상으로 고정된 웹훅 전달은 봉투에 `account_id`를 포함합니다.
* 이전 버전에 고정된 웹훅과 `api_version_date` 고정이 없는 웹훅은 `company_id`를 유지합니다.

**2026-08-13**

이체 중 잔액 내역

TypeScript SDK: [`@whop/sdk@1.0.11`](https://unpkg.com/@whop/sdk@1.0.11/dist/esm/BaseClient.mjs).

계정 및 개인 잔액 내역은 이제 `pending`과 함께 `in_transit`을 표시합니다.

* 정산 대기 중인 총액을 표시하려면 `pending`과 `in_transit`을 더하세요.
* 이전 버전에 고정된 호출자는 계속 `pending`에서 합산 금액을 받습니다.

**2026-08-12**

웹훅 API 버전 입력이 제거되었습니다

`POST /webhooks`와 `PATCH /webhooks/{id}`의 `api_version` 입력이 제거됩니다.

* 새 웹훅은 항상 `v1` 이벤트와 페이로드를 사용합니다. `api_version`을 전달하는 요청은 `400`으로 거부됩니다.
* 대신 `api_version_date`로 웹훅의 페이로드 형태를 고정하세요.
* 기존 `v2` 및 `v5` 웹훅은 계속 전달됩니다. 더 이상 이 버전으로 웹훅을 생성하거나 전환할 수 없습니다.

**2026-08-10**

네이티브 분쟁 알림 엔드포인트

분쟁 알림은 이제 네이티브 REST 리소스이며 레거시 프록시와 함께 이중으로 제공됩니다.

* `GET /dispute_alerts`는 커서 페이지네이션으로 계정의 알림을 나열하며, `account_id`, `payment_id`, `type`, 생성 기간으로 필터링합니다.
* `type`은 `alert_type`을 대체하며 카드 발급사가 보내는 두 가지 유형을 지정합니다: `early_fraud_warning`(Visa TC40 / Mastercard SAFE 사기 보고서)과 `dispute_alert`(분쟁 전 통지).
* `fee_charged`는 `charge_for_alert`를 대체하며 Whop이 실제로 계정에 청구했는지를 보고합니다. 조기 사기 경고는 절대 청구되지 않습니다.
* `actionable`은 결제를 환불하여 여전히 지불 거절을 방지할 수 있는지를 보고합니다.
* `payment` 및 `dispute` 객체는 `payment_id` 및 `account_id` 태그로 대체됩니다. 타임스탬프는 ISO 8601이며, 발급사가 보고서를 제출한 시점은 `reported_at`입니다.

**2026-08-05-1**

스왑에서의 법정 화폐 환전

법정 화폐 쌍 스왑(두 법정 화폐를 사용한 `POST /swaps`)은 이제 자유 형식 환전을 지원하며, `amount`는 암호화폐 스왑 의미와 일치합니다.

* `amount`는 중간 시장 환율로 환전할 `from_token`의 금액입니다. 마이너스 잔액이 필요하지 않습니다.
* 마이너스 `to_token` 잔액의 부분 상환 금액 지정은 새로운 `to_amount` 필드(`to_token` 단위, 부채 금액으로 제한)로 이동했습니다. `amount`와 `to_amount`는 상호 배타적입니다.
* 둘 다 생략하면 여전히 마이너스 `to_token` 잔액 전체를 상환합니다.
* 이전 버전에 고정된 호출자는 이전 동작을 유지합니다: 법정 화폐 `amount`는 `to_token` 상환 금액으로 처리됩니다.

**2026-08-05**

평면화된 인증 요구 사항

인증의 `requested_information`은 이제 평면 목록입니다: 항목당 하나의 요구 사항, 답변당 하나의 쓰기.

* 각 항목은 `requirement`에 필요한 것을 지정합니다: `bank_statement` 같은 문서 또는 `ssn` 같은 필드 키이며, 사용자에게 표시할 `label`이 있습니다.
* `file` 항목은 `file`(직접 업로드 ID)로 답변하세요. `text`, `date`, `phone`, `select` 항목은 `value`로, `address` 항목은 `address`로 답변하세요. 응답의 어떤 내용도 그대로 반환되지 않습니다.
* `multiple`로 표시된 항목은 하나의 답변에서 여러 파일을 슬롯 순서대로 받으며, 양면 문서의 경우 앞면이 먼저입니다.
* `options`가 나열된 항목도 `value`를 받습니다. `select` 항목의 경우 옵션은 허용되는 답변입니다. 신분 증명 문서의 경우 옵션은 허용되는 ID 유형입니다.
* 해당되지 않는 키는 생략되며, 거부된 제출에는 안정적인 `code`와 `reason`이 포함된 구조화된 `errors`가 있습니다.
* 중첩된 `requested_files`/`category` 양식 형태는 이 버전에서 제거되었습니다. 이전 버전에 고정된 호출자는 이를 유지하며, 답변은 자동으로 변환됩니다.

**2026-08-03**

네이티브 프로모션 코드 엔드포인트

프로모션 코드는 이제 완전한 최상위 REST 리소스이며 레거시 프록시와 함께 이중으로 제공됩니다.

* `GET /promo_codes`는 계정의 프로모션 코드를 나열하며 `company_id` 대신 `account_id`를 사용합니다.
* `POST /promo_codes`는 프로모션 코드를 생성합니다. `GET` 및 `DELETE /promo_codes/{id}`는 이를 조회하고 보관합니다.
* `POST /promo_codes/{id}/activate` 및 `POST /promo_codes/{id}/deactivate`는 레거시 `PATCH` 상태 쓰기를 대체합니다.
* 목록 응답은 커서 페이지네이션을 사용하며 상태, 상품, 변형, 타임스탬프, 정렬 필터를 지원합니다.
* 이전 버전에 고정된 호출자는 레거시 프록시 계약을 변경 없이 유지합니다.

**2026-07-31**

더 풍부한 상위 계정

계정 응답은 이제 연결된 계정에 대해 더 풍부한 상위 계정 관계를 제공합니다.

* `parent_account`는 `parent_account_id`를 대체합니다.
* 상위 계정에는 `id`, `title`, `route`, `logo_url`이 포함됩니다.

**2026-07-29-1**

지원되는 지급 수단

지원되는 지급 수단에 이제 자체 페이지네이션 엔드포인트가 있습니다.

* `GET /payouts/supported_methods`는 계정 또는 사용자가 추가할 수 있는 지급 수단을 나열합니다.
* 지원되는 수단은 `object: "supported_payout_method"`를 사용하며, 해당 `podst_` ID는 `supported_payout_method_id`로 전달됩니다.
* 저장된 지급 수단은 `supported_payout_method`를 제공합니다. 지급은 `payout_method.supported_payout_method`를 제공합니다.
* 지급 계정의 국가가 아닌 다른 국가의 지원 수단을 나열하려면 `country`를 사용하세요.
* `GET /payouts/methods`는 더 이상 `include_available`을 받거나 `available_destinations`를 반환하지 않습니다.
* 이전 버전에 고정된 호출자는 `destination_id`, `payout_destination`, `payout_token`을 유지합니다.

**2026-07-29**

네이티브 카드 거래, 지급 수단 도착 예상 시간

카드 거래는 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.

* `GET /card_transactions`는 계정의 카드 거래를 나열하고, `GET /card_transactions/{id}`는 `citx_` ID로 하나를 조회합니다. 목록은 한 번의 요청으로 특정 거래를 가져오기 위한 `transaction_ids` 필터도 받습니다.
* 카드 거래는 계정 범위입니다: 소유자는 `account_id`로 선택되며, 기본값은 자격 증명이 속한 계정입니다.
* `transaction_ids`, `card_id`, `cardholder_id`, `status`, `created_after`, `created_before`로 필터링합니다. 타임스탬프 필터는 ISO 8601입니다.
* 응답에 `cardholder_id`가 새로 추가됩니다: 카드가 할당된 사용자입니다.

지급 수단은 이제 금액과 무관한 수수료 및 전달 조건을 포함하며, 견적은 더 이상 도착 예상 시간을 중복하지 않습니다.

* 각 지급 수단은 `amount` 없이도 `fee_structure`(비율, 고정 금액, 통화)와 `estimated_arrival`(속도별 타임스탬프)을 반환합니다.
* 견적의 `standard` 및 `instant` 객체에는 더 이상 `estimated_arrival`이 포함되지 않습니다. 수단의 최상위 `estimated_arrival` 필드에서 읽으세요.

**2026-07-27**

네이티브 Resolution Center 엔드포인트

Resolution Center 케이스는 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.

* `status`, `escalated`, `outcome`, `refund`, `reason`, `available_actions`는 케이스 상태와 허용된 작업을 제공합니다.
* 이벤트는 페이지네이션된 `GET /resolution_center_cases/{id}/events`에서 사용할 수 있습니다. 요약은 `GET /resolution_center_cases/summary`에서 사용할 수 있습니다.
* 쓰기는 `message`와 `attachments`를 사용합니다. `due_date`의 이름이 `response_due_at`으로 변경됩니다. 목록 조회에 더 이상 `account_id`가 필요하지 않습니다.

**2026-07-26**

네이티브 배송 엔드포인트

배송은 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.

* `GET /shipments`는 배송을 나열합니다. `GET /shipments/{id}`는 배송 ID 또는 결제 ID로 조회합니다.
* `POST /shipments`는 배송을 생성하고, `PATCH /shipments/{id}`는 운송장 번호를 업데이트합니다.
* 응답은 `carrier`, `tracking_url`, `order_id`, `payment_id`와 함께 `account_id`와 `tracking_number`를 사용합니다.
* 이 날짜 이전에 고정된 호출자는 레거시 프록시 계약을 변경 없이 유지합니다.

**2026-07-25**

네이티브 분쟁 엔드포인트

분쟁은 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.

* `PATCH /disputes/{id}`는 증거를 편집하고, `POST /disputes/{id}/submit`은 이를 제출합니다. 증거는 `evidence` 아래에 중첩됩니다.
* `GET /disputes/summary`는 `status`와 `currency`로 그룹화된 합계를 제공합니다. 목록과 조회는 동일한 필드를 반환합니다.
* 응답은 `account_id`, `product_id`, `plan_id`와 함께 `payment` 옆에 `buyer`를 사용합니다. 목록 조회에 더 이상 `account_id`가 필요하지 않습니다.
* `status`와 `reason`은 정규화된 열거형이며, `needs_response_by`, `rdr`, `editable`은 새 필드로 대체됩니다.
* 이 날짜 이전에 고정된 호출자는 레거시 프록시 계약을 변경 없이 유지합니다.

**2026-07-23**

멤버 및 멤버십

멤버와 멤버십은 이제 계정 중심 멤버십 모델과 재설계된 수명 주기 작업을 갖춘 네이티브 리소스를 사용합니다.

* 멤버십 응답은 중첩된 호환성 `plan` 및 `product` 객체 대신 호환성 필드 `plan_id`와 `product_id`를 반환합니다.
* 멤버십 목록 조회는 호출자가 읽을 수 있는 모든 것(본인 및 관리하는 계정의 것)을 반환하며, `account_id`/`user_id`는 모드를 전환하거나 오류를 발생시키는 대신 해당 목록을 좁힙니다.
* 취소를 예약하려면 `cancel_at_period_end`를 설정하세요. `cancel` 작업은 즉시 액세스를 종료합니다.
* `extend` 작업은 `add_free_days`를 대체합니다.

**2026-07-22**

REST 응답 및 타임스탬프 일관성

Current API는 이제 일관된 삭제 응답, 타임스탬프 입력, Account 명명을 사용합니다.

* 상품, 변형, 체크아웃 구성, 광고, 광고 그룹, 광고 캠페인, 소셜 계정, 바운티 제출물의 삭제 엔드포인트는 단순 boolean 대신 `{ id, deleted: true }`를 반환합니다.
* 상품, 변형, 체크아웃 구성, 이체, 금융 보고서의 타임스탬프 필터는 epoch 초를 받지 않고 ISO 8601만 받습니다.
* 상품 응답은 `company` 대신 `account`를 반환합니다.

**2026-07-20**

파트너 비즈니스 지급 비율

파트너 비즈니스는 이제 모든 수입원에 대해 별도의 지급 비율을 제공합니다.

* `payout_percentage`는 `payout_percentages`로 대체됩니다.
* 중첩된 객체에는 `sales`, `ad_spend`, `transfer`, `card_interchange` 비율이 포함됩니다.

**2026-07-18**

상품 및 체크아웃 구성

상품과 체크아웃 구성은 이제 일관되게 Account 모델을 사용합니다.

* 상품 요청 매개변수는 `company_id` 대신 `account_id`를 사용합니다.
* 체크아웃 구성 요청은 최상위와 호환성 필드 `plan`이 포함하는 인라인 변형 객체 안에서 `account_id`를 사용합니다.
* 체크아웃 구성 응답은 `company_id` 대신 `account_id`를 반환합니다.

**2026-07-08-1**

체크아웃 구성 타임스탬프

체크아웃 구성 타임스탬프는 이제 API의 나머지 부분과 동일한 형식을 사용합니다.

* `created_at`과 `updated_at`은 Unix epoch 정수 대신 ISO 8601 문자열입니다.

**2026-07-08**

사용자 잔액

사용자 잔액은 이제 완전하고 구조화된 잔액 요약을 제공합니다.

* 평면 `total_usd` 및 `balances` 필드는 중첩된 `balance` 객체로 대체됩니다.
* 요약은 현금, 암호화폐, 진행 중인 재무 입금, 사용자가 소유한 계정의 잔액을 구분합니다.

**2026-07-01**

비즈니스 추천 수익 리소스

비즈니스 추천 수익은 이제 수익을 발생시킨 다형성 리소스를 식별합니다.

* `receipt`는 `resource`로 대체됩니다.
* `access_pass`는 `product`로 대체됩니다.
* 영수증 기반 수익은 영수증 결제 세부 정보와 함께 `resource.object: "receipt"`를 반환합니다.
* `resource` 필드는 향후 버전에서 영수증 전용 필드를 재사용하지 않고 추가 수익 리소스를 지원할 수 있습니다.

**2026-06-20**

비즈니스 추천 리소스

비즈니스 추천 거래량과 수익은 이제 대조 그룹으로 보고됩니다.

* `processing_volume`, `total_earnings`, `pending_payout`, `completed_payout`은 중첩된 `volume_usd` 및 `earnings_usd` 객체로 대체됩니다.
* 수익은 `base_amount`/`amount`의 이름을 `transaction_amount_usd`/`commission_amount_usd`로 변경하고 `payout_percentage`를 분수로 표현합니다.

**2026-06-09**

변형 리소스(당시 이름은 Plans)

당시 Plans라는 이름이었던 변형은 이제 일관되게 Account 모델을 사용합니다.

* 요청 매개변수와 요청 본문은 `company_id` 대신 `account_id`를 사용합니다.
* 변형 응답은 `company` 대신 `account`를 반환합니다.

**2026-06-08**

사용자 리소스

사용자 액세스 요청은 이제 일관되게 Account 모델을 사용합니다.

* 요청 매개변수와 요청 본문은 `company_id` 대신 `account_id`를 사용합니다.
* 응답 형태는 변경되지 않습니다.

**2025-01-01**

원래 버전

날짜 버전 관리가 도입되기 전의 원래 Current API 동작입니다.

요청에 `Api-Version-Date`가 없으면 이 버전이 사용되므로 기존 연동이 계속 작동합니다.


## Related topics

- [Whop API 개요](https://docs.whop.com/ko/api-reference/overview.md)
- [Products API](https://docs.whop.com/ko/api-reference/products/product.md)
- [Verifications API](https://docs.whop.com/ko/api-reference/verifications/verification.md)
