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

# Accounts API

> Account는 자체 프로필, 지갑, 계정 범위 설정을 가질 수 있는 Whop의 개인 또는 비즈니스를 나타냅니다.

통합에서 지원하는 고객, 크리에이터, 판매자, 셀러 또는 연결된 비즈니스에 계정을 사용하세요.

Accounts API를 사용하여 계정을 생성하고, 자격 증명으로 볼 수 있는 계정을 나열하고, 계정을 조회하거나 업데이트하고, 플랫폼에서 관리하는 하위 계정을 정지하거나 삭제하고, 현재 API 키와 연결된 계정을 조회할 수 있습니다.

`business_type`, `industry_group`, `industry_type` 필드는 계정을 분류합니다. 유효한 모든 값은 [비즈니스 유형 및 업종 용어집](#business-types-and-industries)을 참조하세요.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [List Accounts](https://docs.whop.com/ko/api-reference/accounts/list-accounts.md) | GET `/accounts` |
| [Retrieve Account](https://docs.whop.com/ko/api-reference/accounts/retrieve-account.md) | GET `/accounts/{id}` |
| [Retrieve Account Customer Tracking](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-customer-tracking.md) | GET `/accounts/{account_id}/customer_tracking` |
| [Retrieve Account Fees](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-fees.md) | GET `/accounts/{account_id}/fees` |
| [List Financing Providers](https://docs.whop.com/ko/api-reference/accounts/list-financing-providers.md) | GET `/accounts/{account_id}/financing_providers` |
| [Retrieve Account Preferences](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-preferences.md) | GET `/accounts/{account_id}/preferences` |
| [List Account Reserves](https://docs.whop.com/ko/api-reference/accounts/list-account-reserves.md) | GET `/accounts/{account_id}/reserves` |
| [Create Account](https://docs.whop.com/ko/api-reference/accounts/create-account.md) | POST `/accounts` |
| [Form Company](https://docs.whop.com/ko/api-reference/accounts/form-company.md) | POST `/accounts/{id}/form_company` |
| [Retry Failed Ads Payments](https://docs.whop.com/ko/api-reference/accounts/retry-failed-ads-payments.md) | POST `/accounts/{id}/retry_ads_payment` |
| [Suspend a Subaccount](https://docs.whop.com/ko/api-reference/accounts/suspend-a-subaccount.md) | POST `/accounts/{id}/suspend` |
| [Transfer Account Ownership](https://docs.whop.com/ko/api-reference/accounts/transfer-account-ownership.md) | POST `/accounts/{id}/transfer_ownership` |
| [Update Account](https://docs.whop.com/ko/api-reference/accounts/update-account.md) | PATCH `/accounts/{id}` |
| [Update Account Fees](https://docs.whop.com/ko/api-reference/accounts/update-account-fees.md) | PATCH `/accounts/{account_id}/fees` |
| [Update Account Preferences](https://docs.whop.com/ko/api-reference/accounts/update-account-preferences.md) | PATCH `/accounts/{account_id}/preferences` |
| [Delete a Subaccount](https://docs.whop.com/ko/api-reference/accounts/delete-a-subaccount.md) | DELETE `/accounts/{id}` |

## 수수료 마크업

수수료 마크업을 사용하면 플랫폼이 하위 계정에 요금을 추가하거나 지급 수수료를 보조할 수 있습니다. 계정 수수료 문서를 통해 관리하세요. 플랫폼 계정에서 기본값을 설정하거나 하위 계정에서 개별 수수료를 재정의할 수 있습니다. 예시, 한도, 자금 요구 사항은 [수수료 마크업 및 보조금](https://docs.whop.com/ko/developer/platforms/fee-markups.md)을 참조하세요.

### 수수료 엔드포인트

| 작업 | 엔드포인트 | SDK 메서드 |
| - | - | - |
| [계정 수수료 조회](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-fees.md) | `GET /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.retrieve(accountId)` |
| [계정 수수료 업데이트](https://docs.whop.com/ko/api-reference/accounts/update-account-fees.md) | `PATCH /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.update(accountId, changes)` |

마크업을 구성하려면 `company:update_child_fees` 권한이 있는 플랫폼 계정의 API 키를 사용하세요. 반환되는 각 마크업에는 `adjustable`과 `unadjustable_reason`이 포함되어 있어 통합에서 편집 가능 여부를 판단할 수 있습니다.

### 수수료 읽기

```typescript theme={null}
const fees = await client.accounts.fees.retrieve("biz_connected_account");
```

`markups` 섹션에는 하위 계정의 실제 적용 요율이 포함됩니다. 플랫폼 계정의 `child_markups` 섹션에는 하위 계정에 대한 기본값이 포함됩니다.

마크업의 `source`는 해당 수준에서 구성된 경우 `custom`이고, 상속된 요율이나 0으로 넘어가는 경우 `default`입니다. `default` 필드는 사용자 정의 마크업을 지웠을 때 적용될 요율을 보여 줍니다. 반환되는 고정 금액은 Money 객체를 사용하며, 업데이트 시에는 `fixed`를 미국 달러 단위의 숫자로 받습니다.

### 플랫폼 기본값 설정

플랫폼 계정에서 `child_markups`를 업데이트하세요. 이 예시는 고정 요금 없이 2%의 결제 마크업을 설정합니다:

```typescript theme={null}
await client.accounts.fees.update("biz_platform_id", {
	child_markups: { payments: { percentage: 2, fixed: 0 } },
});
```

`percentage: 2`는 2%를 의미합니다. 기본값은 해당 수수료에 대한 재정의가 없는 하위 계정에 적용됩니다. 결제 마크업은 체크아웃 애플리케이션 수수료가 설정되지 않은 경우에 적용됩니다.

### 하위 계정 재정의 설정

하위 계정에서 `markups`를 업데이트하세요. 이 예시는 상속된 결제 마크업을 1% + \$0.25로 대체합니다:

```typescript theme={null}
await client.accounts.fees.update("biz_connected_account", {
	markups: { payments: { percentage: 1, fixed: 0.25 } },
});
```

전송한 키만 변경됩니다. 다른 거래 유형에는 `transfers`, `crypto_swaps`, 레일별 키를 사용하는 `deposits`, 또는 지급 방법별 키를 사용하는 `payouts`를 사용하세요. 지원되는 키와 요청 스키마는 [업데이트 엔드포인트](https://docs.whop.com/ko/api-reference/accounts/update-account-fees.md)를 참조하세요.

### 마크업 지우기

마크업을 지우려면 `null`을 전송하세요. 하위 계정의 재정의를 지우면 플랫폼 기본값이 복원되며, 기본값이 구성되지 않은 경우 0이 됩니다:

```typescript theme={null}
await client.accounts.fees.update("biz_connected_account", {
	markups: { payments: null },
});
```

플랫폼 기본값을 지우려면 플랫폼 계정에 `child_markups: { payments: null }`을 전송하세요. 명시적인 `{ percentage: 0, fixed: 0 }`은 구성된 요율로 유지됩니다. 상속을 복원하려면 `null`을 사용하세요.

## 법률 문서

계정은 법률 문서를 PDF 파일로 게시합니다: `terms_of_service`, `privacy_policy`, `return_policy`, `cancellation_policy`, `shipping_policy`, `eula`. 각 문서는 [File](https://docs.whop.com/ko/api-reference/files/file)로 반환되며, [업로드한](https://docs.whop.com/ko/developer/guides/upload-files.md) 파일의 `id`를 사용하여 [Update Account](https://docs.whop.com/ko/api-reference/accounts/update-account.md)로 설정합니다.

새 분쟁은 기본적으로 이 문서들에서 정책 증거를 가져옵니다. 취소 정책 슬롯은 `cancellation_policy`, 그다음 `terms_of_service`, 그다음 `return_policy` 순으로 사용합니다. 환불 정책 슬롯은 `return_policy`, 그다음 `terms_of_service` 순으로 사용합니다. 아무것도 설정되지 않은 경우 두 슬롯 모두 Whop의 플랫폼 정책으로 대체되며, `shipping_policy`는 실물 상품 분쟁에 함께 포함됩니다. 여기서 한 번 설정하고, 특정 분쟁에 다른 버전의 정책이 필요한 경우에만 [Upload Dispute Evidence](https://docs.whop.com/ko/api-reference/disputes/upload-dispute-evidence.md)를 사용하세요.

```typescript TypeScript theme={null}
import { readFile } from "node:fs/promises";

const file = await client.files.create({ filename: "terms-of-service.pdf" });
await fetch(file.upload_url!, {
	method: "PUT",
	headers: file.upload_headers as Record<string, string>,
	body: await readFile("./terms-of-service.pdf"),
});

await client.accounts.update({
	id: "biz_xxxxxxxxxxxxx",
	terms_of_service: { id: file.id },
});
```

```python Python theme={null}
import requests

file = client.files.create(filename="terms-of-service.pdf")
with open("./terms-of-service.pdf", "rb") as contents:
    requests.put(file.upload_url, headers=file.upload_headers or {}, data=contents)

client.accounts.update(
    "biz_xxxxxxxxxxxxx",
    terms_of_service={"id": file.id},
)
```

문서를 제거하려면 `null`을 전송하세요. PDF 파일만 허용됩니다.

## 속성

**id** `string` *required*

`biz_` 접두사가 붙은 계정 ID.

**ads\_spend\_usd** `number | null` *required*

계정의 누적 청구된 광고 지출(USD). 계정에 대해 `stats:read` 권한이 있는 호출자에 대해 `list`에서만 계산되며, 그 외에는 `null`입니다.

**balances** `object[]` *required*

계정 보유 자산(각각 USD 가치 포함). `total_usd`가 `null`이면 비어 있습니다.

> [accordion] 속성
>
> **balance** `string` *required*
>
> 보유한 총 금액(기본 단위, 십진수 문자열).
>
> **breakdown** `object` *required*
>
> 사용 가능, 대기 중, 예비 금액으로 나눈 잔액(기본 단위 십진수 문자열)과 대기 중 금액이 정산될 것으로 예상되는 날짜.
>
> > [accordion] 속성
> >
> > **available** `string` *required*
> >
> > 지금 사용, 송금 또는 인출할 수 있는 금액(기본 단위, 십진수 문자열).
> >
> > **finishing\_settlement** `string` *required*
> >
> > 이미 정산되어 계정의 암호화폐 지갑 또는 Whop Card로 이동하기를 기다리는 `pending`의 일부로, 이동 후 `available`이 됩니다. 이동은 보통 1시간 이내에 시작되며, 진행되는 동안에는 해당 금액이 대신 `in_transit`에 보고됩니다. 계정의 유지 최소 잔액을 보충하기 위해서만 이동한 금액은 포함되지 않습니다. 기본 단위, 십진수 문자열.
> >
> > **in\_transit** `string` *required*
> >
> > 카드 충전과 같이 계정 자체의 목적지 간에 이동 중인 금액. 기본 단위, 십진수 문자열.
> >
> > **pending** `string` *required*
> >
> > 아직 정산 중인 최근 결제의 금액(기본 단위, 십진수 문자열).
> >
> > **pending\_settlements** `object[]` *required*
> >
> > 대기 중 금액이 정산될 것으로 예상되는 시기로, 하루에 하나의 항목이 가장 이른 날짜부터 나열됩니다. `finishing_settlement`를 포함하여 예정된 정산일이 없는 금액은 제외되므로, 이 항목들과 `finishing_settlement`의 합은 `pending`보다 작을 수는 있지만 클 수는 없습니다.
> >
> > > [accordion] 속성
> > >
> > > **amount** `string` *required*
> > >
> > > 해당 날짜에 예상되는 금액(기본 단위, 십진수 문자열).
> > >
> > > **date** `string` *required*
> > >
> > > 이 금액의 정산이 완료될 것으로 예상되는 날짜(ISO 8601 날짜).
> >
> > **reserve** `string` *required*
> >
> > 보류된 금액(기본 단위, 십진수 문자열). 보류 사유와 해제 시점은 계정의 예비금을 조회하여 확인하세요.
>
> **icon\_url** `string | null` *required*
>
> 보유 자산 아이콘 URL.
>
> **name** `string` *required*
>
> 보유 자산의 표시 이름
>
> **price\_usd** `number | null` *required*
>
> 단위당 USD 가격. 환율을 사용할 수 없는 경우 `null`입니다.
>
> **symbol** `string` *required*
>
> `USDT`, `cbBTC`, `EUR`과 같은 보유 자산 표시 기호.
>
> **value\_usd** `string | null` *required*
>
> 보유 자산의 USD 가치. 환율을 사용할 수 없는 경우 `null`입니다.

**banner\_image\_url** `string | null` *required*

계정 배너 이미지 URL.

**business\_address** `object | null` *required*

세금 계산에 사용되는 계정의 사업장 주소로, `line1`, `line2`, `city`, `state`, `postal_code`, `country`를 포함합니다. 주소가 설정되지 않은 경우 `null`입니다.

**business\_name** `string | null` *required*

세금 주소와 함께 사용되는 계정의 법적 사업자명.

**business\_type** `string | null` *required*

계정의 상위 수준 비즈니스 카테고리. 유효한 값은 [비즈니스 유형 및 업종 용어집](https://docs.whop.com/ko/api-reference/accounts/account#business-types-and-industries-glossary)을 참조하세요.

**can\_transfer\_pending\_balance\_to\_children** `boolean` *required*

이 플랫폼 계정에서 하위 계정으로 대기 중 자금을 이체할 수 있는지 여부.

**cancellation\_policy** `object | null` *required*

계정의 취소 정책 문서. 게시하지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `file_` 접두사가 붙은 파일 ID.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점(ISO 8601 타임스탬프).
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름.
>
> **height** `integer | null` *required*
>
> 이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> `complete`에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 사전 서명된 URL. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 사전 서명된 URL.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트). 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT과 함께 전송할 헤더. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 업로드 수명 주기에서 파일의 현재 위치.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 사전 서명된 URL. 생성 시에만, 그리고 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 URL. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL로 제공됩니다. `private` 파일은 만료되는 서명된 URL로 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 동영상 너비(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.

**capabilities** `object | null` *required*

이 계정에 활성화된 결제 레일로, 각각 `active`, `inactive` 또는 `pending`(온보딩 또는 검토 진행 중)입니다. `company:balance:read` 범위가 있는 호출자에 대해 `retrieve`와 `me`에서만 계산되며, 그 외에는 `null`입니다.

> [accordion] 속성
>
> **accept\_bank\_payments** `string` *required*
>
> 은행 결제 수납: 자동 이체, 계좌 이체 및 현지 은행 레일
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **accept\_bnpl\_payments** `string` *required*
>
> 선구매 후결제(BNPL) 수납. 승인이 필요합니다
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **accept\_card\_payments** `string` *required*
>
> Apple Pay와 Google Pay를 포함한 카드 수납
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **bank\_deposit** `string` *required*
>
> 계정의 가상 은행 계좌로의 은행 송금 또는 ACH 입금
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **card\_deposit** `string` *required*
>
> 저장된 결제 수단에 청구하여 잔액 충전
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **card\_issuing** `string` *required*
>
> Whop 카드 발급. 카드 신청 승인이 필요합니다
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **crypto\_deposit** `string` *required*
>
> 계정의 암호화폐 지갑으로의 온체인 입금
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **crypto\_payout** `string` *required*
>
> 암호화폐 지갑으로의 온체인 지급
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **instant\_payout** `string` *required*
>
> 적격 지급 목적지로의 즉시 지급
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **run\_ads** `string` *required*
>
> Whop Ads를 통한 광고 캠페인 시작. 계정의 신원 또는 비즈니스가 인증될 때까지, 요청된 광고 서비스 계약이 계정의 서명을 기다리는 동안, 그리고 계정이 Whop Ads에서 정지된 동안에는 `inactive`입니다.
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **standard\_payout** `string` *required*
>
> 외부 지급 목적지로의 일반 지급
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`
>
> **transfer** `string` *required*
>
> 다른 계정으로의 이체
>
> 사용 가능한 옵션: `active`, `inactive`, `pending`

**cards** `object | null` *required*

계정의 Whop Cards 신청 세부 정보. `company:balance:read` 범위가 있는 호출자에 대해 `list`, `retrieve`, `me`에서 반환되며, 그 외에는 `null`이고 계정에 카드 신청이나 차단 신청 검토가 없는 경우에도 `null`입니다.

> [accordion] 속성
>
> **decline\_reason** `string | null` *required*
>
> 카드 발급사가 신청을 거절한 사유. 미국 내 인증된 개인 또는 비즈니스의 경우 `unsupported_state`가 `unsupported_region`을 대체합니다. `compliance`는 제재, 정치적 주요 인물 및 부정적 미디어 검사를 포함합니다. `other`는 이 목록에 없는 사유를 포함합니다. `status`가 `denied`가 아니거나 발급사가 신청을 거절하지 않은 경우 `null`입니다.
>
> 사용 가능한 옵션: `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> 카드 신청이 비즈니스(`business`, KYB)를 인증하는지 개인(`individual`, 소비자 신원)을 인증하는지 여부. 신청이 아직 인증에 연결되지 않은 경우 `null`입니다.
>
> 사용 가능한 옵션: `individual`, `business`
>
> **status** `string` *required*
>
> 카드 신청의 현재 상태. `approved`는 카드를 발급할 수 있음을 의미합니다. `needs_verification`은 신청자가 아직 신원 인증을 완료하지 않았음을 의미하고, `needs_information`은 인증을 완료했지만 수정 가능한 사유로 서류가 거부되어 다시 제출해야 함을 의미합니다. `pending`과 `manual_review`는 진행 중입니다. `denied`, `locked`, `canceled`는 최종 상태입니다.
>
> 사용 가능한 옵션: `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

**collect\_vat\_id** `boolean` *required*

체크아웃에서 구매자가 선택적으로 입력할 수 있는 VAT/세금 ID 필드를 표시할지 여부. 구매에 VAT ID가 필요하지는 않습니다.

**company\_formation** `object` *required*

[Form Company](https://docs.whop.com/ko/api-reference/accounts/form-company.md)를 통해 관리되는 계정의 회사 설립 상태. 설립 체크아웃이 결제될 때까지 `status`는 `draft`이며, 이후에는 다운로드 가능한 문서와 처리 대기 중인 서명을 포함한 신고 진행 상황을 나타냅니다. 설립 상태를 일시적으로 사용할 수 없는 경우 비어 있습니다.

> [accordion] 속성
>
> **documents** `object[]`
>
> 정관(Articles of Organization) 및 EIN 확인서와 같이 다운로드 가능한 설립 문서. `status`가 `draft`를 벗어나면 존재합니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > `file_` 접두사가 붙은 문서 ID.
> >
> > **name** `string` *required*
> >
> > `Articles of Organization`과 같이 사람이 읽을 수 있는 문서 이름.
> >
> > **type** `string` *required*
> >
> > 문서 카테고리: `articles_of_organization`, `operating_agreement`, `ein_letter`, `signed_ss4`, `signed_form8821`, 또는 회사를 대신하여 받은 우편물의 경우 `mail`.
> >
> > **url** `string` *required*
> >
> > 문서를 다운로드할 CDN URL.
>
> **ein\_registered** `boolean`
>
> IRS가 회사의 EIN을 발급했는지 여부. `status`가 `draft`를 벗어나면 존재합니다.
>
> **legal\_name** `string | null`
>
> 법인 형태 접미사를 포함한 등록 회사명(예: `Acme, LLC`). `status`가 `draft`를 벗어나면 존재합니다.
>
> **signatures** `object`
>
> 아직 설립자의 서명을 기다리고 있는 IRS 양식으로, 각각 호스팅된 서명 URL이 포함됩니다. `status`가 `draft`를 벗어나면 존재하며, 서명할 항목이 없으면 비어 있습니다.
>
> > [accordion] 속성
> >
> > **form8821** `object`
> >
> > 세금 정보 승인서인 IRS Form 8821의 서명 상태. 양식에 아직 설립자의 조치가 필요한 동안에만 존재합니다.
> >
> > > [accordion] 속성
> > >
> > > **expires\_at** `string`
> > >
> > > 서명 URL이 만료되는 시점(ISO 8601 타임스탬프). 서명 URL이 포함된 경우에만 존재합니다.
> > >
> > > **status** `string` *required*
> > >
> > > 설립자를 위한 서명 세션이 준비되면 `pending`, 서명 상태를 확인할 수 없으면 `unknown`입니다.
> > >
> > > 사용 가능한 옵션: `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > 설립자가 양식을 작성하는 호스팅된 서명 URL. `status`가 `pending`이고 호출자에게 `incorporation:write`가 있는 동안 존재합니다. 웹훅에서는 생략됩니다.
> >
> > **ss4** `object`
> >
> > EIN 신청서인 IRS Form SS-4의 서명 상태. 양식에 아직 설립자의 조치가 필요한 동안에만 존재합니다.
> >
> > > [accordion] 속성
> > >
> > > **expires\_at** `string`
> > >
> > > 서명 URL이 만료되는 시점(ISO 8601 타임스탬프). 서명 URL이 포함된 경우에만 존재합니다.
> > >
> > > **status** `string` *required*
> > >
> > > 설립자를 위한 서명 세션이 준비되면 `pending`, 서명 상태를 확인할 수 없으면 `unknown`입니다.
> > >
> > > 사용 가능한 옵션: `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > 설립자가 양식을 작성하는 호스팅된 서명 URL. `status`가 `pending`이고 호출자에게 `incorporation:write`가 있는 동안 존재합니다. 웹훅에서는 생략됩니다.
>
> **state\_registered** `boolean`
>
> 주(州) 설립 신고가 완료되었는지 여부. `status`가 `draft`를 벗어나면 존재합니다.
>
> **status** `string`
>
> 사용 가능한 옵션: `draft`, `processing`, `filed`, `rejected`, `completed`

**country** `string | null` *required*

계정이 위치한 국가.

**created\_at** `string` *required*

계정이 생성된 시점(ISO 8601 타임스탬프).

**customers\_l30d** `integer | null` *required*

지난 30일 동안 계정에서 결제 완료 영수증이 있는 고유 고객 수로, 몇 시간마다 갱신됩니다. 계정에 대해 `stats:read` 권한이 있는 호출자에 대해 `retrieve`에서만 계산되며, 그 외에는 `null`이고 집계를 사용할 수 없는 경우에도 `null`입니다.

**description** `string | null` *required*

계정 홍보 설명.

**direct\_reports\_count** `integer`

상위 관리자 없이 비즈니스에 직접 보고하는 팀원 수. 단일 계정 조회 시 존재합니다.

**dispute\_fighter\_enabled** `boolean` *required*

Whop이 이 계정의 분쟁 증거를 수집하고 제출하는지 여부. 활성화하면 계정이 승소한 분쟁에 부과되는 성공 수수료에 동의하게 됩니다.

**economic\_intelligence** `boolean` *required*

계정에서 Economic Intelligence가 켜져 있는지 여부. 약정 기간이 끝나면 자동으로 꺼집니다. 꺼져 있는 동안에는 계정이 실험을 활성화하거나 추천을 실행할 수 없습니다.

**email** `string | null` *required*

계정 소유자 이메일 주소.

**eula** `object | null` *required*

계정의 최종 사용자 라이선스 계약 문서. 게시하지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `file_` 접두사가 붙은 파일 ID.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점(ISO 8601 타임스탬프).
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름.
>
> **height** `integer | null` *required*
>
> 이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> `complete`에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 사전 서명된 URL. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 사전 서명된 URL.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트). 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT과 함께 전송할 헤더. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 업로드 수명 주기에서 파일의 현재 위치.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 사전 서명된 URL. 생성 시에만, 그리고 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 URL. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL로 제공됩니다. `private` 파일은 만료되는 서명된 URL로 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 동영상 너비(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.

**external\_id** `string | null` *required*

상위 플랫폼이 이 하위 계정에 부여한 자체 식별자로, 플랫폼의 하위 계정 간에 고유합니다. 설정되지 않은 경우 `null`입니다.

**financing** `object | null` *required*

계정의 가장 최근 금융 신청. `company:balance:read` 범위가 있는 호출자에 대해 `retrieve`와 `me`에서만 계산되며, 그 외에는 `null`이고 계정이 금융을 신청한 적이 없는 경우에도 `null`입니다.

> [accordion] 속성
>
> **application\_id** `string` *required*
>
> inrq\_로 시작하는 계정의 가장 최근 금융 신청 ID. 요구 사항과 검토 피드백을 확인하려면 이를 조회하세요.
>
> **status** `string` *required*
>
> 가장 최근 금융 신청의 검토 상태: `requires_collection`(추가 정보 요청 이후를 포함하여 판매자를 기다리는 중), `awaiting_review`, `approved`, `denied`, `completed`. 금융 결제 수단의 활성화 여부는 `capabilities.accept_bnpl_payments`입니다.
>
> 사용 가능한 옵션: `requires_collection`, `awaiting_review`, `completed`, `approved`, `denied`

**funds\_release\_at** `string | null` *required*

정지된 계정이 자체 지급 방법으로 잔액을 지급할 수 있는 시점(ISO 8601 타임스탬프). 분쟁으로 인해 늦춰질 수 있습니다. `retrieve`, `me`, `suspend`에서 계산되며, 그 외에는 `null`이고 `status`가 `suspended`가 아니거나 정지로 인해 잔액이 보류된 경우에도 `null`입니다.

**home\_preferences** `string[]` *required*

공개 계정 홈페이지 환경설정.

사용 가능한 옵션: `hide_member_count`, `hide_members_card`

**industry\_type** `string | null` *required*

계정의 구체적인 업종. 유효한 값은 [비즈니스 유형 및 업종 용어집](https://docs.whop.com/ko/api-reference/accounts/account#business-types-and-industries-glossary)을 참조하세요.

**invoice\_prefix** `string | null` *required*

계정 인보이스에 사용되는 접두사.

**level** `object | null` *required*

계정 `owner`의 Whop Levels 진행 상황으로, 소유자가 소유한 모든 계정에 걸쳐 집계되므로 모든 계정에 동일한 레벨이 표시됩니다. `company:basic:read` 범위가 있는 호출자에 대해 `retrieve`와 `me`에서만 계산되며, 그 외에는 `null`이고 계정이 Whop Levels에 참여하지 않은 경우에도 `null`입니다.

> [accordion] 속성
>
> **account\_level** `integer` *required*
>
> 이 계정 자체의 포인트만으로 산정한 레벨로, `0`부터 `10`까지입니다. 소유자의 다른 계정이 레벨을 끌어올리면 `current`가 더 높습니다.
>
> **current** `integer` *required*
>
> 적용되는 레벨: 소유자가 이번 달 또는 그 이전 5개월 동안 도달한 최고 레벨로, `0`부터 `10`까지입니다.
>
> **points** `integer` *required*
>
> 소유자가 소유한 모든 계정에서 이번 달에 획득한 포인트와 소유자의 파트너 포인트를 합산하여 내림한 값. 월 순합계가 0 미만인 계정은 0으로 계산됩니다.
>
> **points\_by\_source** `object` *required*
>
> 이번 달 포인트를 획득처별로 나눈 값. 각 획득처는 환불을 차감한 순액이므로 음수일 수 있습니다.
>
> > [accordion] 속성
> >
> > **ads** `integer` *required*
> >
> > 환불을 차감한 결제된 Whop Ads 청구액에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
> >
> > **cards** `integer` *required*
> >
> > 환불을 차감한 확정된 Whop Card 지출에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
> >
> > **partners** `integer` *required*
> >
> > 소유자가 파트너로서 추천한 계정에서 얻은 포인트: 해당 계정이 3포인트를 얻을 때마다 1포인트, 0 방향으로 반올림.
> >
> > **trading** `integer` *required*
> >
> > Whop을 통해 체결된 무기한 선물 거래량에서 얻은 포인트: 거래 1달러당 1포인트, 0 방향으로 반올림.
>
> **resets\_at** `string` *required*
>
> 이번 달 포인트가 0으로 초기화되는 시점(ISO 8601 타임스탬프).

**logo\_url** `string | null` *required*

계정 로고 이미지 URL.

**metadata** `object` *required*

계정 생성 시 제공된 임의의 키/값 메타데이터.

**onboarding\_type** `string | null` *required*

계정이 완료한 온보딩 유형.

사용 가능한 옵션: `platform`, `seller`

**opengraph\_image\_url** `string | null` *required*

계정 Open Graph 이미지 URL.

**opengraph\_image\_variant** `string | null` *required*

계정 Open Graph 이미지 변형.

사용 가능한 옵션: `white`, `black`, `orange`

**orchestration\_enabled** `boolean` *required*

이 계정에 결제 오케스트레이션이 활성화되어 있는지 여부.

**other\_business\_description** `string | null` *required*

business\_type이 `other`인 경우의 비즈니스 유형 세부 정보.

**other\_industry\_description** `string | null` *required*

industry\_type이 `other`인 경우의 업종 세부 정보.

**owner** `object` *required*

계정을 소유한 단일 사용자로, 이 사용자의 이메일이 위의 `email`입니다. 팀원의 `owner` 역할과는 다르며, 해당 역할은 여러 명이 가질 수 있습니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `user_` 접두사가 붙은 사용자 ID.
>
> **name** `string | null` *required*
>
> 표시 이름.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름.

**parent\_account** `object | null` *required*

하위 계정의 상위 계정. 독립 계정의 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `biz_` 접두사가 붙은 계정 ID.
>
> **fees** `object`
>
> 이 상위 계정이 조회 대상 하위 계정에 부과하는 마크업 요율로, 수수료 유형별 키(예: `crypto_deposit_markup`)를 사용하며 각각 `percentage_fee`와 `fixed_fee_usd`를 포함합니다. 하위 계정 자체의 재정의가 플랫폼 기본값보다 우선하여 결정됩니다.
>
> **logo\_url** `string | null` *required*
>
> 계정 로고 이미지 URL.
>
> **route** `string` *required*
>
> 계정 공개 경로 식별자.
>
> **title** `string` *required*
>
> 계정 표시 이름.

**partner** `object | null`

계정의 활성 1차 파트너. 조회 응답에 존재하며, 계정에 귀속된 활성 1차 파트너가 없는 경우 null입니다. 다른 응답에서는 생략됩니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `user_` 접두사가 붙은 사용자 ID.
>
> **email** `string | null` *required*
>
> 파트너 연락용 이메일 주소. 파트너가 자신의 이메일 주소를 추가하지 않은 경우 Null입니다.
>
> **name** `string | null` *required*
>
> 표시 이름.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **referring\_account** `object | null` *required*
>
> 추천이 파트너의 팀에 속한 경우, 파트너가 이 계정을 대신 추천한 비즈니스. 개인 추천의 경우 `null`입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > `biz_` 접두사가 붙은 계정 ID.
> >
> > **title** `string` *required*
> >
> > 계정 표시 이름.
>
> **username** `string` *required*
>
> 공개 사용자 이름.
>
> **whop\_partner\_verified\_at** `string | null` *required*
>
> 사용자가 인증된 Whop Partner가 된 시점(ISO 8601 타임스탬프). 인증되지 않은 경우 Null입니다.

**payment\_controls** `object | null` *required*

계정에 현재 적용된 결제 건전성 제어. `company:balance:read` 범위가 있는 호출자에 대해 `retrieve`와 `me`에서만 계산되며, 그 외에는 `null`입니다.

> [accordion] 속성
>
> **dispute\_alert\_auto\_refund** `object` *required*
>
> 차지백 전 분쟁 알림에 대한 자동 환불 설정.
>
> > [accordion] 속성
> >
> > **locked** `boolean` *required*
> >
> > 계정 소유자가 이 임계값을 변경하지 못하도록 막혀 있는지 여부.
> >
> > **threshold\_usd** `number | null` *required*
> >
> > 자동으로 환불되는 최대 분쟁 알림 금액(USD). 자동 환불이 비활성화된 경우 `null`입니다.
>
> **dispute\_alert\_fee\_usd** `number | null` *required*
>
> 분쟁 알림당 부과되는 수수료(USD). 사용할 수 없는 경우 `null`입니다.
>
> **enforce\_3ds** `boolean` *required*
>
> 체크아웃의 모든 카드 결제에 3-D Secure가 강제되는지 여부. 설정된 동안 계정은 이를 우회할 수 없습니다.
>
> **financing\_disabled** `boolean` *required*
>
> 결제 건전성 제어가 금융을 명시적으로 비활성화하는지 여부. 이는 `capabilities.accept_bnpl_payments`의 금융 승인과는 별개입니다.
>
> **high\_risk\_processing\_fee\_percentage** `number` *required*
>
> 고위험 처리에 대한 추가 처리 수수료율.
>
> **payment\_method\_warnings** `object[]` *required*
>
> 분쟁률 한도에 가까워지고 있다는 경고를 받은 결제 수단. 각 항목에는 `payment_method`, `measure`(`disputes`, `disputes_and_tc40s` 또는 `fraud_disputes`), ISO 8601 타임스탬프인 `warned_at`, 그리고 `0.01`이 1%인 분수로 표현된 `rate`, `warning_rate`, `target_rate`가 포함됩니다. 경고를 받은 수단이 없으면 비어 있습니다. 경고를 받은 수단이 약 4주 후에도 목표 비율을 초과하면 일시 중지되고 `restricted_payment_methods`에 표시됩니다.
>
> **pending\_auto\_topup\_fee\_percentage** `number` *required*
>
> 아직 정산되지 않은 대기 중 잔액을 계정의 카드 잔액 충전을 위해 선지급할 때 부과되는 수수료율로, `2`는 2%를 의미합니다. 계정이 면제된 경우 `0`입니다.
>
> **pending\_balance\_delay\_days** `integer` *required*
>
> 결제가 사용 가능해지기 전에 대기 상태로 유지되는 추가 일수.
>
> **reserve** `object` *required*
>
> 들어오는 결제 금액에 현재 적용된 예비금.
>
> > [accordion] 속성
> >
> > **hold\_period\_days** `integer` *required*
> >
> > 예비 자금이 해제되기 전까지 보류되는 일수.
> >
> > **percentage** `number | null` *required*
> >
> > 들어오는 결제 금액 중 예비금으로 보류되는 비율. 예비금이 적용되지 않은 경우 `null`입니다.
>
> **resolution\_center\_auto\_refund** `object` *required*
>
> 해결 센터 사례에 대한 자동 환불 설정.
>
> > [accordion] 속성
> >
> > **card\_threshold\_usd** `number | null` *required*
> >
> > 자동으로 환불되는 카드 결제 해결 센터 사례의 최대 금액(USD). 카드에 대한 자동 환불이 비활성화된 경우 `null`입니다.
> >
> > **financing\_threshold\_usd** `number | null` *required*
> >
> > 자동으로 환불되는 금융 결제 해결 센터 사례의 최대 금액(USD). 금융에 대한 자동 환불이 비활성화된 경우 `null`입니다.
> >
> > **locked** `boolean` *required*
> >
> > 계정 소유자가 이 임계값들을 변경하지 못하도록 막혀 있는지 여부.
> >
> > **paypal\_threshold\_usd** `number | null` *required*
> >
> > 자동으로 환불되는 PayPal 결제 해결 센터 사례의 최대 금액(USD). PayPal에 대한 자동 환불이 비활성화된 경우 `null`입니다.
>
> **restricted\_payment\_methods** `string[]` *required*
>
> 이 계정의 체크아웃에서 차단된 카드 브랜드. 차단된 브랜드가 없으면 비어 있습니다. 계정이 직접 다시 활성화할 수 없습니다.
>
> 사용 가능한 옵션: `card_visa`, `card_mastercard`, `card_american_express`, `card_discover_global_network`, `addi`, `affirm`, `afterpay_clearpay`, `alma`, `billie`, `capchase_pay`, `claritypay`, `flex_pay`, `klarna`, `kriya`, `kueski`, `mondu`, `oney`, `scalapay`, `sequra`, `sezzle`, `splitit`, `sunbit`, `tabby`, `tamara`, `zip`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `oney_3x`, `oney_4x`, `klarna_pay_now`, `us_bank_account`, `sepa_debit`, `bacs_debit`, `au_becs_debit`, `acss_debit`, `pay_by_bank`, `payto`, `paypal`, `cashapp`, `venmo`, `amazon_pay`, `link`, `wechat_pay`
>
> **undated\_pending\_reason** `string | null` *required*
>
> 정산일이 없는 대기 중 자금이 아직 이동하지 않는 이유. `kyc_incomplete`, `pending_information_request`, `update_payout_profile`은 판매자가 조치할 수 있는 항목입니다. `compliance_review`는 판매자가 이미 제출한 인증을 검토 중이므로 검토가 완료될 때까지 이 자금이 대기 상태로 유지됨을 의미합니다. `withdrawals_disabled`는 Whop이 인출을 차단하여 이 자금이 사용 가능해질 수 없음을 의미합니다. 표시할 사유가 없는 경우 `null`입니다 — 아직 정산 중이거나 여기에 명시되지 않은 사유로 보류된 경우입니다.
>
> 사용 가능한 옵션: `kyc_incomplete`, `pending_information_request`, `update_payout_profile`, `compliance_review`, `withdrawals_disabled`
>
> **withdrawal\_schedule** `object` *required*
>
> 계정 잔액이 자동으로 인출되는 방식.
>
> > [accordion] 속성
> >
> > **day** `integer | null` *required*
> >
> > 자동 인출이 실행되는 날: `weekly`의 경우 0-6(일요일-토요일), `monthly`의 경우 1-31. `manual`과 `daily`의 경우 `null`입니다.
> >
> > **frequency** `string` *required*
> >
> > 계정 잔액이 자동으로 인출되는 빈도.
> >
> > 사용 가능한 옵션: `manual`, `daily`, `weekly`, `monthly`
> >
> > **next\_payout\_date** `string | null` *required*
> >
> > 자동 인출이 다음으로 예정된 날짜(ISO 8601 날짜). 단일한 다음 날짜가 적용되지 않는 `manual`과 `daily`의 경우 `null`입니다.

**payment\_method\_configuration** `object | null` *required*

체크아웃에서 계정의 기본 결제 수단. 변형 또는 체크아웃 구성 자체의 `payment_method_configuration`이 우선합니다. 계정이 Whop의 플랫폼 기본값을 사용하는 경우 `null`입니다.

> [accordion] 속성
>
> **disabled** `string[]` *required*
>
> 기본값이 제공하더라도 이 체크아웃에서 제외하는 결제 수단.
>
> **enabled** `string[]` *required*
>
> 기본값이 제공하는 것 외에 이 체크아웃에서 추가로 제공하는 결제 수단.
>
> **include\_platform\_defaults** `boolean` *required*
>
> Whop의 기본 세트를 시작점으로 사용할지 여부. `false`이면 `enabled`만 제공됩니다.

**platform\_credits** `object[]` *required*

잔액 캐시에서 읽은 통화별 Whop 발행 플랫폼 크레딧. 크레딧은 Whop Ads와 같은 적격 Whop 상품에만 사용할 수 있고, 인출할 수 없으며, `balances` 또는 `total_usd`에 포함되지 않습니다. 계정에 크레딧이 없거나 `total_usd`가 `null`이면 비어 있습니다.

> [accordion] 속성
>
> **amount** `string` *required*
>
> 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
>
> **currency** `string` *required*
>
> 소문자로 된 세 글자 ISO 4217 통화 코드.
>
> **decimals** `integer` *required*
>
> 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
>
> **display\_decimals** `integer` *required*
>
> 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.

**privacy\_policy** `object | null` *required*

계정의 개인정보 처리방침 문서. 게시하지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `file_` 접두사가 붙은 파일 ID.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점(ISO 8601 타임스탬프).
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름.
>
> **height** `integer | null` *required*
>
> 이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> `complete`에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 사전 서명된 URL. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 사전 서명된 URL.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트). 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT과 함께 전송할 헤더. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 업로드 수명 주기에서 파일의 현재 위치.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 사전 서명된 URL. 생성 시에만, 그리고 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 URL. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL로 제공됩니다. `private` 파일은 만료되는 서명된 URL로 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 동영상 너비(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.

**product\_tax\_code** `object | null` *required*

계정 상품에 기본으로 적용되는 세금 분류 코드로, `id`, `name`, `product_type`을 포함합니다. 기본값이 설정되지 않은 경우 `null`입니다.

**recommended\_actions** `object[] | null` *required*

사용 중단됨: 대신 `GET /economic_intelligence?account_id=\{account_id}` 엔드포인트를 사용하세요.

> [accordion] 속성
>
> **action** `string` *required*
>
> 추천 항목. 새 값이 추가될 수 있으므로 알 수 없는 작업을 적절히 처리하세요
>
> 사용 가능한 옵션: `theme_business`, `create_product`, `create_plan`, `verify_identity`, `connect_affiliate_program`, `create_promotion`, `migrate_from_stripe`, `accept_first_payment`, `launch_first_ad`, `launch_draft_campaign`, `increase_ad_budget`, `refresh_ad_creatives`, `fix_ad_billing`, `exclude_customers_from_ads`, `retarget_abandoned_checkouts`, `fix_funnel_dropoff`, `invite_team_member`, `enable_tax_collection`, `create_card`, `apply_for_financing`
>
> **blocked\_capabilities** `string[]` *required*
>
> 이 작업으로 잠금 해제되는 기능. 없으면 비어 있습니다
>
> **cta** `string` *required*
>
> 행동 유도 버튼이 연결되는 URL
>
> **cta\_label** `string` *required*
>
> 버튼 레이블
>
> **description** `string` *required*
>
> 보조 문구. 없으면 비어 있습니다
>
> **icon\_url** `string | null` *required*
>
> 일러스트레이션 아이콘 URL 또는 `null`
>
> **impact\_score** `integer | null` *required*
>
> 0-100 사이의 예상 영향도. 순위가 매겨지지 않은 경우 `null`
>
> **reasoning** `string | null` *required*
>
> 이 작업이 추천된 이유 또는 `null`
>
> **status** `string` *required*
>
> 항상 선택 사항 — 절대 차단하지 않음
>
> 사용 가능한 옵션: `optional`
>
> **title** `string` *required*
>
> 추천 항목의 제목

**require\_2fa** `boolean` *required*

승인된 사용자가 2단계 인증을 활성화해야 하는지 여부.

**required\_actions** `object[] | null` *required*

지급 및 카드 사용과 같은 기능의 차단을 해제하기 위해 계정 소유자가 수행해야 하는 작업으로, 표시 우선순위에 따라 정렬됩니다. `company:balance:read` 범위가 있는 호출자에 대해 `retrieve`와 `me`에서만 계산되며, 그 외에는 `null`입니다.

> [accordion] 속성
>
> **action** `string` *required*
>
> 보유자가 해야 할 작업. 새 값이 추가될 수 있으므로 알 수 없는 작업을 적절히 처리하세요
>
> 사용 가능한 옵션: `deposit_funds`, `review_held_payments`, `submit_information_request`, `update_automatic_withdrawal_method`, `reauthorize_payout_methods`, `update_payout_method`, `update_payout_profile`, `card_usage_review`, `verify_identity`, `scale_account_setup`, `sign_formation_documents`, `configure_tax_remitter`, `add_vat_registration`, `confirm_tax_details`, `accept_payout_terms`, `enable_two_factor_authentication`, `respond_to_abuse_report`
>
> **blocked\_capabilities** `string[]` *required*
>
> 이 작업이 해결될 때까지 제한되는 기능
>
> **cta** `string | null` *required*
>
> 행동 유도 버튼이 연결되는 URL. 버튼이 없는 경우 null
>
> **cta\_label** `string` *required*
>
> 버튼 레이블. 버튼이 없는 경우 비어 있음
>
> **description** `string` *required*
>
> 보조 문구. 없으면 비어 있습니다
>
> **icon\_url** `string | null` *required*
>
> 작업의 일러스트레이션 아이콘 URL. 없는 경우 null
>
> **status** `string` *required*
>
> required(지금 조치 필요) 또는 pending(검토 중)
>
> 사용 가능한 옵션: `required`, `pending`
>
> **title** `string` *required*
>
> 작업의 제목

**return\_policy** `object | null` *required*

계정의 반품 정책 문서. 게시하지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `file_` 접두사가 붙은 파일 ID.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점(ISO 8601 타임스탬프).
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름.
>
> **height** `integer | null` *required*
>
> 이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> `complete`에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 사전 서명된 URL. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 사전 서명된 URL.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트). 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT과 함께 전송할 헤더. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 업로드 수명 주기에서 파일의 현재 위치.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 사전 서명된 URL. 생성 시에만, 그리고 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 URL. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL로 제공됩니다. `private` 파일은 만료되는 서명된 URL로 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 동영상 너비(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.

**rewards** `object[]`

이 계정의 활성 추천 링크를 통해 연결된 비즈니스 보상으로, 계정별 진행 상황과 원장 상태를 포함합니다. 조회 응답에 존재하며, 잔액 및 통계 읽기 권한이 모두 없으면 비어 있습니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `prwd_` 접두사가 붙은 보상 정의 ID. 진행 상황과 상태는 해당 계정에 적용됩니다.
>
> **qualification\_amount** `object` *required*
>
> 이 보상을 받는 데 필요한 적격 USD 거래량.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
>
> **qualification\_progress** `object` *required*
>
> 귀속 이후 이 계정이 보상 활동에 대해 누적한 적격 USD 거래량으로, 이행 규칙을 사용하여 계산됩니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
>
> **qualification\_type** `string` *required*
>
> 이 계정이 보상을 받을 자격을 얻는 활동.
>
> 사용 가능한 옵션: `sales`, `ad_spend`
>
> **reward\_amount** `object` *required*
>
> 이 보상에 대해 적립되는 USD 금액. 이행이 시작되면 저장된 지급 금액을 사용합니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
>
> **status** `string` *required*
>
> 이 계정의 보상 상태. 적립(Credited)에는 게시된 원장 항목이 필요하며, 처리 중(processing)에는 이행을 기다리는 충족된 요구 사항이 포함됩니다. 취소 중(reversing)과 취소됨(reversed)은 이후의 보상 취소를 반영합니다.
>
> 사용 가능한 옵션: `in_progress`, `processing`, `credited`, `reversing`, `reversed`, `unavailable`

**route** `string` *required*

계정 공개 경로 식별자.

**send\_customer\_emails** `boolean` *required*

Whop이 이 계정을 대신하여 고객에게 거래 이메일을 보내는지 여부.

**shipping\_policy** `object | null` *required*

계정의 배송 정책 문서. 게시하지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `file_` 접두사가 붙은 파일 ID.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점(ISO 8601 타임스탬프).
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름.
>
> **height** `integer | null` *required*
>
> 이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> `complete`에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 사전 서명된 URL. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 사전 서명된 URL.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트). 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT과 함께 전송할 헤더. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 업로드 수명 주기에서 파일의 현재 위치.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 사전 서명된 URL. 생성 시에만, 그리고 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 URL. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL로 제공됩니다. `private` 파일은 만료되는 서명된 URL로 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 동영상 너비(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.

**show\_joined\_whops** `boolean` *required*

계정이 다른 계정의 가입한 whop에 표시되는지 여부.

**show\_reviews\_dtc** `boolean` *required*

소비자 직접 판매 상품 페이지에 리뷰가 표시되는지 여부.

**show\_user\_directory** `boolean` *required*

계정이 사용자 디렉터리에 사용자를 표시하는지 여부.

**social\_links** `object[]` *required*

계정 소셜 링크.

> [accordion] 속성
>
> **id** `string` *required*
>
> 소셜 링크의 ID
>
> **title** `string | null` *required*
>
> 소셜 링크의 선택적 표시 제목
>
> **url** `string` *required*
>
> 소셜 링크 URL
>
> **website** `string` *required*
>
> 이 링크의 소셜 플랫폼
>
> 사용 가능한 옵션: `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`, `custom`

**status** `string | null` *required*

계정이 Whop에서 운영될 수 있는지 여부: `active` 또는 `suspended`. `list`, `retrieve`, `me`, `suspend`에서 계산되며, 그 외에는 `null`입니다.

**status\_reason** `string | null` *required*

계정이 정지된 이유로, `Suspended - Fraudulent activity`와 같은 레이블입니다. 기록된 사유가 없으면 `Suspended`입니다. `retrieve`, `me`, `suspend`에서 계산됩니다. 그 외에는 `null`이며, `status`가 `suspended`가 아닌 경우에도 `null`입니다.

**store\_page\_config** `object` *required*

계정 스토어 페이지 표시 구성.

> [accordion] 속성
>
> **accent\_color** `string | null` *required*
>
> 계정 스토어 페이지에 사용되는 강조 색상.
>
> 사용 가능한 옵션: `ruby`, `tomato`, `red`, `crimson`, `pink`, `plum`, `purple`, `violet`, `iris`, `cyan`, `teal`, `jade`, `green`, `grass`, `brown`, `blue`, `orange`, `indigo`, `sky`, `mint`, `yellow`, `amber`, `lime`, `lemon`, `magenta`, `gold`, `bronze`, `gray`
>
> **layout** `string | null` *required*
>
> 계정 스토어 페이지에 사용되는 레이아웃.
>
> 사용 가능한 옵션: `featured`, `compact`
>
> **profile\_variant** `string | null` *required*
>
> 계정 스토어 페이지에 사용되는 프로필 표시 방식.
>
> 사용 가능한 옵션: `personal`, `business`
>
> **whop\_affiliate\_link** `boolean` *required*
>
> 계정 스토어 페이지에 Whop 제휴 링크가 표시되는지 여부.

**target\_audience** `string | null` *required*

이 계정의 대상 고객층.

**tax\_collection\_enabled\_states** `string[]` *required*

계정이 세금을 징수하는 미국 주 코드(50개 주와 `DC`): Whop이 납부하는 경우(`tax_remitted_by` `whop`) 전체 세트, 계정이 직접 납부하는 경우(`self`) 구성된 일부, 둘 다 아닌 경우 비어 있습니다. 업데이트 시 전체 목록을 전송하여 대체하세요(`self`인 경우에만 허용).

**tax\_identifiers** `object[]` *required*

계정 세금/VAT 등록. 설정된 항목이 없으면 비어 있습니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 세금 식별자 ID.
>
> **tax\_id\_type** `string` *required*
>
> 세금 ID 유형.
>
> 사용 가능한 옵션: `ad_nrt`, `ao_tin`, `ar_cuit`, `al_tin`, `am_tin`, `aw_tin`, `au_abn`, `au_arn`, `eu_vat`, `az_tin`, `bs_tin`, `bh_vat`, `bd_bin`, `bb_tin`, `by_tin`, `bj_ifu`, `bo_tin`, `ba_tin`, `br_cnpj`, `br_cpf`, `bg_uic`, `bf_ifu`, `kh_tin`, `cm_niu`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cv_nif`, `cl_tin`, `cn_tin`, `co_nit`, `cd_nif`, `cr_tin`, `hr_oib`, `do_rcn`, `ec_ruc`, `eg_tin`, `sv_nit`, `et_tin`, `eu_oss_vat`, `ge_vat`, `gh_tin`, `de_stn`, `gb_vat`, `gn_nif`, `hk_br`, `hu_tin`, `is_vat`, `in_gst`, `id_npwp`, `il_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `kz_bin`, `ke_pin`, `kg_tin`, `la_tin`, `li_uid`, `li_vat`, `my_frp`, `my_itn`, `my_sst`, `mr_nif`, `mx_rfc`, `md_vat`, `me_pib`, `ma_vat`, `np_pan`, `nz_gst`, `ng_tin`, `mk_vat`, `no_vat`, `no_voec`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `ro_tin`, `ru_inn`, `ru_kpp`, `sa_vat`, `sn_ninea`, `rs_pib`, `sg_gst`, `sg_uen`, `si_tin`, `za_vat`, `kr_brn`, `es_cif`, `ch_uid`, `ch_vat`, `tw_vat`, `tj_tin`, `tz_vat`, `th_vat`, `tr_tin`, `ug_tin`, `ua_vat`, `ae_trn`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `zm_tin`, `zw_tin`, `sr_fin`, `xi_vat`
>
> **tax\_id\_value** `string` *required*
>
> 세금 ID 값(예: `DE123456789`). [세금 ID 가이드](https://docs.whop.com/ko/developer/guides/tax-ids.md)를 참조하세요.

**tax\_remitted\_by** `string | null` *required*

계정의 세금을 계산하고 납부하는 주체. `whop`은 Whop이 계산하고 납부함을 의미합니다. `self`는 Whop이 계산하고 계정이 징수 및 납부함을 의미합니다. `none`은 둘 다 아니며 계정이 책임짐을 의미합니다. 새 비즈니스는 `whop`으로 시작하고, 새 연결 계정은 `none`으로 시작합니다. `null`은 계정에 아직 설정이 없음을 의미합니다.

사용 가능한 옵션: `whop`, `self`, `none`

**tax\_type** `string | null` *required*

계정 가격에 세금이 적용되는 방식: `inclusive`(표시 가격에 세금 포함) 또는 `exclusive`(세금 별도 추가). 설정되지 않은 경우 기본값은 `exclusive`이며, 계정에 결제 연결이 없는 경우에만 `null`입니다.

사용 가능한 옵션: `inclusive`, `exclusive`

**terms\_of\_service** `object | null` *required*

계정의 서비스 약관 문서. 게시하지 않은 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `file_` 접두사가 붙은 파일 ID.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점(ISO 8601 타임스탬프).
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름.
>
> **height** `integer | null` *required*
>
> 이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> `complete`에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 사전 서명된 URL. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 사전 서명된 URL.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트). 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT과 함께 전송할 헤더. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 업로드 수명 주기에서 파일의 현재 위치.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 사전 서명된 URL. 생성 시에만, 그리고 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 URL. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL로 제공됩니다. `private` 파일은 만료되는 서명된 URL로 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 동영상 너비(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.

**three\_ds\_level** `string | null` *required*

지원되는 온세션 카드 결제에 대한 3D Secure 동작. `mandate_challenge`는 결제 처리 전에 3DS 챌린지를 요구합니다. `mandate_if_required`는 결제 처리업체가 요구하는 경우에만 챌린지를 의무화합니다. `frictionless_if_required`는 일반적인 프릭션리스 3DS 흐름을 사용합니다. `mandate_challenge`가 선택되지 않은 한 \$1,000 이상의 결제는 `mandate_if_required`를 사용합니다. 위험 및 인증 복구 요구 사항이 이 환경설정보다 우선할 수 있습니다. `null`은 표준 체크아웃 흐름을 사용합니다.

사용 가능한 옵션: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

**title** `string` *required*

계정 표시 이름.

**total\_earned\_usd** `number | null` *required*

USD로 환산한 계정 누적 판매액. `stats:read` 범위가 있는 호출자에 대해 `retrieve`와 `me`에서만 계산되며, 그 외에는 `null`입니다.

**total\_usd** `string | null` *required*

환율이 알려진 잔액 전체의 총 USD 가치. 단일 계정 조회(`retrieve` 및 `me`)에서만 계산되며, 목록 응답, 쓰기, 잔액 읽기 권한이 없는 경우 또는 잔액 소스를 사용할 수 없는 경우 `null`입니다.

**trading** `trading_account | null` *required*

트레이딩 계정 주소, 증거금 및 미결제 포지션의 스냅샷, WebSocket 구독. 단일 계정 조회에서 `include_trading=true`로 활성화하세요. 그 외에는 `null`이며, 트레이딩 권한이 없거나 Ethereum 지갑이 없는 경우에도 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 이 트레이딩 계정을 지원하는 Whop 지갑 ID로, `cwal_` 접두사가 붙습니다.
>
> **account\_id** `string | null` *required*
>
> 이 트레이딩 계정을 소유한 계정으로, `biz_` 접두사가 붙습니다. 사용자가 소유한 경우 `null`입니다.
>
> **hyperliquid** `object | null` *required*
>
> Hyperliquid 전용 상태. `provider`가 `hyperliquid`인 경우 존재하며, 그 외에는 `null`입니다.
>
> > [accordion] 속성
> >
> > **address** `string` *required*
> >
> > Hyperliquid 계정을 보유한 소문자 지갑 주소.
> >
> > **depositable** `string | null` *required*
> >
> > `deposit` 거래로 이 계정에 옮길 수 있는 Plasma 상 Whop 지갑의 USDT0(십진수 문자열). 체인을 읽을 수 없는 경우 `null`입니다.
> >
> > **margin\_summary** `object | null` *required*
> >
> > 메인 거래소와 `xyz` 마켓 전반의 계정 가치 및 증거금으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 `null`입니다. 실시간 업데이트에는 `websocket_subscriptions`를 사용하세요.
> >
> > > [accordion] 속성
> > >
> > > **account\_value** `object` *required*
> > >
> > > 미실현 손익을 포함한 총 계정 가치(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > 미결제 포지션 전반에 할당된 증거금(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > 미결제 포지션의 합산 명목 가치(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > 포지션을 청산하지 않고 지금 인출할 수 있는 USD.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > 메인 거래소와 `xyz` 마켓 전반의 미결제 무기한 선물 포지션으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 `null`입니다. 실시간 업데이트에는 `websocket_subscriptions`를 사용하세요.
> >
> > > [accordion] 속성
> > >
> > > **id** `string` *required*
> > >
> > > `trdpos_` 접두사가 붙은 트레이딩 포지션 ID. 하나의 트레이딩 계정 내에서 마켓별로 고정됩니다.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > 평균 진입 가격(USD). 제공자가 생략한 경우 `null`입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Hyperliquid 무기한 선물 세부 정보. Hyperliquid 포지션에 존재하며, 그 외에는 `null`입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > 여러 기간에 걸쳐 포지션에 지불된 펀딩(USD).
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > 계정 기록 전체에서 이 마켓에 지불된 펀딩(USD). 사용할 수 없는 경우 `null`입니다.
> > > > >
> > > > > > [accordion] 속성
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > 포지션 크기가 마지막으로 변경된 이후 지불된 펀딩(USD). 사용할 수 없는 경우 `null`입니다.
> > > > >
> > > > > > [accordion] 속성
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > 포지션이 열린 이후 지불된 펀딩(USD). 사용할 수 없는 경우 `null`입니다.
> > > > >
> > > > > > [accordion] 속성
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > 포지션의 증거금 모드와 배수.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross`는 포지션 간에 증거금을 공유합니다. `isolated`는 증거금을 이 포지션으로 제한합니다.
> > > > >
> > > > > 사용 가능한 옵션: `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > 포지션 증거금에 적용되는 배수(예: 10배의 경우 `10`).
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > 예상 청산 가격(USD). Hyperliquid가 보고하지 않는 경우 `null`입니다.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > 포지션에 할당된 증거금(USD).
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > 십진수 비율 문자열로 표현한 자기자본이익률(예: 10%의 경우 `0.1`).
> > >
> > > **market** `string` *required*
> > >
> > > 제공자의 마켓 기호(예: `ETH`).
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > 현재 포지션 가치(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **side** `string` *required*
> > >
> > > 사용 가능한 옵션: `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > 십진수 문자열로 표현한 절대 포지션 크기.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > 미실현 손익(USD). 손실인 경우 음수입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > 실시간 계정 업데이트를 위한 구독. `websocket_url`에 연결한 후 각 `message`를 변경 없이 전송하세요.
> >
> > > [accordion] 속성
> > >
> > > **channel** `string` *required*
> > >
> > > 이 구독이 여는 실시간 업데이트 스트림.
> > >
> > > 사용 가능한 옵션: `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > Hyperliquid WebSocket을 통해 변경 없이 전송할 JSON 구독 메시지.
> >
> > **websocket\_url** `string` *required*
> >
> > 실시간 업데이트를 위해 직접 연결할 Hyperliquid WebSocket URL.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> 포지션과 주문을 보유하는 거래 장소.
>
> 사용 가능한 옵션: `hyperliquid`
>
> **spot** `object | null` *required*
>
> 진입 가격과 손익이 포함된 Whop 지갑의 현물 보유 자산. 읽을 수 없는 경우 `null`입니다.
>
> > [accordion] 속성
> >
> > **holdings** `object[]` *required*
> >
> > 지갑이 아직 보유하고 있는 각 현물 자산과 평균 진입 가격 및 손익. 취득 원가는 가장 오래된 단위를 먼저 판매한 것으로 계산하며, Whop 외부에서 들어온 자산도 포함합니다.
> >
> > > [accordion] 속성
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > 아직 보유 중인 단위당 평균 지불 가격(USD)으로, 가장 오래된 단위를 먼저 판매한 것으로 계산합니다. 알 수 없는 경우 `null`입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > 아직 보유 중인 단위에 대해 지불한 USD 금액.
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **market** `string` *required*
> > >
> > > `GET /trades/markets`의 현물 마켓 `id`(예: `BTC`, `XAUT` 또는 `AAPL`과 같은 토큰화된 주식의 티커).
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > 매도를 통해 이미 확정된 손익(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > 아직 보유 중인 단위의 가치에서 `cost_basis`를 뺀 값(USD).
> > >
> > > > [accordion] 속성
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > 주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > 소문자로 된 세 글자 ISO 4217 통화 코드.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > 금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > 표시할 소수 자릿수. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `cost_basis` 대비 `unrealized_pnl`의 백분율로, `2`는 2% 상승을 의미합니다. 알 수 없는 경우 `null`입니다.
>
> **user\_id** `string | null` *required*
>
> 이 트레이딩 계정을 소유한 사용자로, `user_` 접두사가 붙습니다. 계정이 소유한 경우 `null`입니다.

**use\_logo\_as\_opengraph\_image\_fallback** `boolean` *required*

계정이 로고를 대체 Open Graph 이미지로 사용하는지 여부.

**verification** `object` *required*

`individual`(KYC) 및 `business`(KYB) 프로필에 대한 계정 신원 인증 상태. 각각 생성될 때까지 `null`이며, 그 외에는 `not_started`, `pending`, `manual_review`, `approved` 또는 `rejected` 중 하나의 `status`입니다.

**volume\_l30d\_usd** `number | null` *required*

지난 30일 동안 계정을 통한 거래량(결제 완료 영수증 기준 GMV)으로, USD로 환산됩니다. 계정에 대해 `stats:read` 권한이 있는 호출자에 대해 `list`에서만 계산되며, 그 외에는 `null`입니다.

**volume\_usd** `number | null` *required*

계정을 통한 누적 거래량 — 판매액과 받은 이체액의 합 — 으로, USD로 환산됩니다. 계정에 대해 `stats:read` 권한이 있는 호출자에 대해 `list`에서만 계산되며, 그 외에는 `null`입니다.

**wallet** `object | null` *required*

계정의 기본 암호화폐 지갑. 프로비저닝된 지갑이 없으면 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `wallet_` 접두사가 붙은 지갑 ID.
>
> **address** `string` *required*
>
> 지갑의 온체인 주소
>
> **network** `string` *required*
>
> 지갑이 존재하는 블록체인 네트워크
>
> 사용 가능한 옵션: `solana`, `ethereum`, `bitcoin`

**website** `string | null` *required*

계정의 비즈니스 웹사이트 URL. 제공되지 않은 경우 `null`입니다. 설정하면 `social_links`에 `website` 항목도 추가됩니다.

**whop\_partner\_enabled\_at** `string | null`

계정이 Whop Partner 모드를 켠 시점(ISO 8601 타임스탬프). 단일 계정 조회 및 업데이트 응답에 존재하며, 업데이트 시 `whop_partner_enabled: true`를 전송하여 계정이 Whop Partner 모드를 켤 때까지 `null`입니다.

```json Account theme={null}
{
	"id": "biz_xxxxxxxxxxxxx",
	"trading": {
		"id": "cwal_xxxxxxxxxxxxx",
		"object": "trading_account",
		"account_id": "biz_xxxxxxxxxxxxx",
		"user_id": null,
		"provider": "hyperliquid",
		"hyperliquid": {
			"address": "0x1234567890abcdef1234567890abcdef12345678",
			"websocket_url": "wss://api.hyperliquid.xyz/ws",
			"websocket_subscriptions": [
				{
					"channel": "clearinghouse_state",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"clearinghouseState\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "open_orders",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"openOrders\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "order_updates",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"orderUpdates\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_fills",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userFills\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_events",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userEvents\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				}
			],
			"depositable": "1250.50",
			"margin_summary": {
				"account_value": {
					"currency": "usd",
					"amount": "1520.50",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_position_notional": {
					"currency": "usd",
					"amount": "4350.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_margin_used": {
					"currency": "usd",
					"amount": "435.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"withdrawable": {
					"currency": "usd",
					"amount": "500.00",
					"decimals": 2,
					"display_decimals": 2
				}
			},
			"positions": [
				{
					"id": "trdpos_0123456789abcdef",
					"object": "trading_position",
					"market": "ETH",
					"side": "short",
					"size": "1.5",
					"entry_price": {
						"currency": "usd",
						"amount": "3000.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"position_value": {
						"currency": "usd",
						"amount": "4350.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "150.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"hyperliquid": {
						"leverage": {
							"type": "cross",
							"value": 10
						},
						"liquidation_price": {
							"currency": "usd",
							"amount": "4912.40",
							"decimals": 2,
							"display_decimals": 2
						},
						"margin_used": {
							"currency": "usd",
							"amount": "435.00",
							"decimals": 2,
							"display_decimals": 2
						},
						"return_on_equity": "0.33",
						"cumulative_funding": {
							"all_time": {
								"currency": "usd",
								"amount": "1.20",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_open": {
								"currency": "usd",
								"amount": "0.40",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_change": {
								"currency": "usd",
								"amount": "0.10",
								"decimals": 2,
								"display_decimals": 2
							}
						}
					}
				}
			]
		},
		"spot": {
			"holdings": [
				{
					"market": "BTC",
					"average_entry_price": {
						"currency": "usd",
						"amount": "79841.12345678",
						"decimals": 8,
						"display_decimals": 8
					},
					"cost_basis": {
						"currency": "usd",
						"amount": "400.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "38.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl_percentage": 9.5625,
					"realized_pnl": {
						"currency": "usd",
						"amount": "3.25",
						"decimals": 2,
						"display_decimals": 2
					}
				}
			]
		}
	},
	"balances": [
		{
			"balance": "1250.5",
			"breakdown": {
				"available": "1200.50",
				"in_transit": "0",
				"pending": "50.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "50.00",
						"date": "2026-08-01"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": "https://cdn.whop.com/tokens/usdt.png",
			"name": "Tether USD",
			"price_usd": 1,
			"symbol": "USDT",
			"value_usd": "1250.50"
		},
		{
			"balance": "45.00",
			"breakdown": {
				"available": "40.00",
				"in_transit": "0",
				"pending": "5.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "3.00",
						"date": "2026-08-01"
					},
					{
						"amount": "2.00",
						"date": "2026-08-04"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": null,
			"name": "EUR",
			"price_usd": 1.11,
			"symbol": "EUR",
			"value_usd": "50.00"
		}
	],
	"platform_credits": [
		{
			"amount": "25.00",
			"currency": "usd",
			"decimals": 2,
			"display_decimals": 2
		}
	],
	"banner_image_url": "https://cdn.whop.com/banner.png",
	"business_type": "ecommerce",
	"can_transfer_pending_balance_to_children": false,
	"cancellation_policy": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"description": "Petal Post delivers fresh bouquets.",
	"economic_intelligence": false,
	"email": "hello@petalpost.example",
	"eula": null,
	"external_id": null,
	"home_preferences": ["hide_member_count"],
	"industry_type": "flower_delivery_gig",
	"invoice_prefix": "PETAL",
	"company_formation": {
		"status": "filed",
		"legal_name": "Petal Post, LLC",
		"state_registered": true,
		"ein_registered": false,
		"signatures": {
			"ss4": {
				"status": "pending",
				"url": "https://esign.doola.com/session/sess_1a2b3c",
				"expires_at": "2026-08-01T00:00:00Z"
			}
		},
		"documents": [
			{
				"id": "file_petalpost123",
				"name": "Articles of Organization",
				"type": "articles_of_organization",
				"url": "https://img.whop.com/documents/articles-of-organization.pdf"
			}
		]
	},
	"logo_url": "https://cdn.whop.com/logo.png",
	"metadata": {
		"external_merchant_id": "merchant_123"
	},
	"onboarding_type": "seller",
	"opengraph_image_url": "https://cdn.whop.com/og.png",
	"opengraph_image_variant": "black",
	"other_business_description": "Local flower delivery",
	"other_industry_description": "Same-day floral gifts",
	"owner": {
		"id": "user_xxxxxxxxxxxx",
		"username": "petalpost",
		"name": "Ada Flores",
		"profile_picture": {
			"url": "https://cdn.whop.com/user.png"
		}
	},
	"parent_account": {
		"id": "biz_platform123",
		"title": "Petal Platform",
		"route": "petal-platform",
		"logo_url": "https://cdn.whop.com/petal-platform-logo.png"
	},
	"privacy_policy": null,
	"require_2fa": true,
	"dispute_fighter_enabled": false,
	"orchestration_enabled": true,
	"collect_vat_id": false,
	"capabilities": {
		"accept_card_payments": "active",
		"accept_bank_payments": "active",
		"accept_bnpl_payments": "inactive",
		"standard_payout": "inactive",
		"instant_payout": "inactive",
		"crypto_payout": "inactive",
		"transfer": "inactive",
		"bank_deposit": "active",
		"crypto_deposit": "active",
		"card_deposit": "active",
		"card_issuing": "inactive",
		"run_ads": "active"
	},
	"payment_controls": {
		"dispute_alert_auto_refund": {
			"threshold_usd": 250,
			"locked": false
		},
		"resolution_center_auto_refund": {
			"card_threshold_usd": null,
			"financing_threshold_usd": null,
			"paypal_threshold_usd": null,
			"locked": false
		},
		"dispute_alert_fee_usd": 29,
		"high_risk_processing_fee_percentage": 0,
		"pending_auto_topup_fee_percentage": 2,
		"pending_balance_delay_days": 0,
		"financing_disabled": false,
		"enforce_3ds": false,
		"restricted_payment_methods": [],
		"payment_method_warnings": [],
		"reserve": {
			"percentage": null,
			"hold_period_days": 90
		},
		"withdrawal_schedule": {
			"frequency": "monthly",
			"day": 1,
			"next_payout_date": "2026-09-01"
		},
		"undated_pending_reason": null
	},
	"cards": {
		"kind": "business",
		"status": "approved",
		"decline_reason": null
	},
	"financing": null,
	"required_actions": [
		{
			"action": "verify_identity",
			"status": "required",
			"title": "Identity verification required",
			"description": "Complete verification before your total earnings exceed $5k to continue accepting payments.",
			"cta_label": "Verify now",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/balance/?verify=true",
			"icon_url": null,
			"blocked_capabilities": [
				"accept_card_payments",
				"accept_bank_payments",
				"standard_payout",
				"instant_payout",
				"crypto_payout",
				"transfer",
				"bank_deposit",
				"card_issuing"
			]
		}
	],
	"recommended_actions": [
		{
			"action": "migrate_from_stripe",
			"status": "optional",
			"title": "Migrate your business from Stripe.",
			"description": "",
			"cta_label": "Get started",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/settings/stripe-migrations/",
			"icon_url": "https://whop.com/illustrations/orange/crane.svg",
			"blocked_capabilities": [],
			"reasoning": null,
			"impact_score": null
		},
		{
			"action": "accept_first_payment",
			"status": "optional",
			"title": "Accept your first payment.",
			"description": "",
			"cta_label": "Create payment link",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/links/checkout/create/",
			"icon_url": "https://whop.com/illustrations/orange/card.svg",
			"blocked_capabilities": [],
			"reasoning": null,
			"impact_score": null
		},
		{
			"action": "apply_for_financing",
			"status": "optional",
			"title": "Offer financing at checkout",
			"description": "Let customers pay over time with buy now, pay later.",
			"cta_label": "Apply",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/settings/payments/",
			"icon_url": "https://whop.com/illustrations/orange/piggy-bank.svg",
			"blocked_capabilities": ["accept_bnpl_payments"],
			"reasoning": null,
			"impact_score": null
		}
	],
	"return_policy": null,
	"route": "petal-post",
	"shipping_policy": null,
	"website": "https://petalpost.example",
	"send_customer_emails": true,
	"payment_method_configuration": {
		"enabled": ["klarna"],
		"disabled": ["crypto"],
		"include_platform_defaults": true
	},
	"show_joined_whops": false,
	"show_reviews_dtc": true,
	"show_user_directory": false,
	"status": "active",
	"status_reason": null,
	"funds_release_at": null,
	"terms_of_service": null,
	"three_ds_level": "mandate_challenge",
	"total_earned_usd": 3450,
	"ads_spend_usd": 180.25,
	"volume_usd": 4250.5,
	"volume_l30d_usd": 1200,
	"customers_l30d": 24,
	"level": {
		"current": 1,
		"points": 41000,
		"points_by_source": {
			"cards": 40000,
			"ads": 0,
			"trading": 1000,
			"partners": 0
		},
		"resets_at": "2026-11-01T04:00:00.000Z",
		"account_level": 0
	},
	"social_links": [
		{
			"id": "social_petalpost123",
			"title": "Petal Post",
			"url": "https://petalpost.example",
			"website": "website"
		}
	],
	"store_page_config": {
		"accent_color": "red",
		"layout": "compact",
		"profile_variant": "business",
		"whop_affiliate_link": true
	},
	"target_audience": "Customers sending flowers locally",
	"tax_collection_enabled_states": ["CA", "NY"],
	"tax_remitted_by": "whop",
	"tax_type": "exclusive",
	"product_tax_code": {
		"id": "ptc_CzLNn2Z058xEC1",
		"name": "Digital Group Chat",
		"product_type": "digital"
	},
	"business_address": {
		"line1": "123 Garden Way",
		"line2": null,
		"city": "Austin",
		"state": "TX",
		"postal_code": "78701",
		"country": "US"
	},
	"business_name": "Petal Post, LLC",
	"tax_identifiers": [
		{
			"id": "taxid_petalpost123",
			"tax_id_type": "us_ein",
			"tax_id_value": "12-3456789"
		}
	],
	"title": "Petal Post",
	"total_usd": "1300.50",
	"use_logo_as_opengraph_image_fallback": true,
	"verification": {
		"business": null,
		"individual": {
			"status": "approved"
		}
	},
	"wallet": {
		"id": "wallet_petalpost123",
		"address": "So11111111111111111111111111111111111111112",
		"network": "solana"
	}
}
```

## 비즈니스 유형 및 업종

세 가지 필드가 계정을 분류합니다: `business_type`, `industry_group`, `industry_type`. 전체 분류 체계는 별도 페이지에 있습니다:

> [card] [비즈니스 유형 및 업종](https://docs.whop.com/ko/api-reference/accounts/business-types.md)


## Related topics

- [External Accounts API](https://docs.whop.com/ko/api-reference/external-accounts/external-account.md)
- [List Accounts](https://docs.whop.com/ko/api-reference/accounts/list-accounts.md)
- [Update Account](https://docs.whop.com/ko/api-reference/accounts/update-account.md)
