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

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

# 수수료 마크업 & 보조금

> 하위 계정에 대한 플랫폼 수수료 마크업과 지급 보조금을 구성하고, 예시, 지원되는 한도, 가용 잔액 요구 사항을 확인하세요.

수수료 마크업을 사용하면 플랫폼이 Whop 수수료에 더해 하위 계정이 지불하는 금액을 조정할 수 있습니다. 양수 마크업은 플랫폼의 수익이 됩니다. 음수 지급 마크업은 플랫폼 잔액에서 하위 계정의 출금 수수료를 보조합니다. Whop은 여전히 전체 수수료를 받습니다.

## 마크업 구성

`company:update_child_fees` 권한이 있는 플랫폼의 API 키를 사용하세요. [계정 수수료를 조회](https://docs.whop.com/ko/api-reference/accounts/retrieve-account-fees.md)하여 실제 적용 요율, 기본값, 각 마크업의 조정 가능 여부를 확인하세요.

`PATCH /api/v1/accounts/{account_id}/fees`로 [계정 수수료를 업데이트](https://docs.whop.com/ko/api-reference/accounts/update-account-fees.md)하세요:

| 적용 대상 | URL의 계정 ID | 요청 섹션 |
| - | - | - |
| 사용자 지정 요율이 없는 하위 계정 | 플랫폼 | `child_markups` |
| 하나의 하위 계정 | 해당 하위 계정 | `markups` |

각 마크업에는 `percentage`와 `fixed` 금액이 있습니다. `percentage: 1`은 1%를 의미합니다. `fixed`는 미국 달러로 설정하세요. 지급 마크업은 청구될 때 출금 통화로 변환됩니다.

이 예시는 하나의 하위 계정에 대해 은행 송금 지급 마크업을 1% 빼기 \$0.60으로 설정합니다:

```bash theme={null}
curl --request PATCH \
  --url https://api.whop.com/api/v1/accounts/biz_SUBACCOUNT_ID/fees \
  --header "Authorization: Bearer $WHOP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "markups": {
      "payouts": {
        "bank_wire": { "percentage": 1, "fixed": -0.60 }
      }
    }
  }'
```

플랫폼 기본값의 경우 동일한 `payouts` 객체를 `child_markups` 아래에 넣어 플랫폼의 계정 ID로 보내세요. 수수료 엔드포인트가 반환하는 키를 사용하여 각 지급 수단별로 요율을 설정하세요.

## 결제 수단별 결제 마크업

`payments`는 체크아웃 애플리케이션 수수료 없이 하위 계정이 받는 모든 결제에 대한 마크업입니다. 결제 수단별로 다르게 청구하려면 `payment_methods` 아래에 설정하세요:

| 키 | 결제 수단 |
| - | - |
| `card` | Apple Pay 및 Google Pay를 포함한 카드 |
| `ach` | 미국 은행 계좌 결제 및 미국 은행 이체 |
| `wire` | 국내 및 국제 은행 송금 |

다른 모든 결제 수단은 `payments` 마크업을 사용합니다.

```json theme={null}
{
  "child_markups": {
    "payments": { "percentage": 2, "fixed": 0.30 },
    "payment_methods": {
      "card": { "percentage": 3, "fixed": 0.30 },
      "ach": { "percentage": 1, "fixed": 0 }
    }
  }
}
```

### 지역별 카드 마크업

Whop 자체의 카드 요율은 결제를 처리하는 매입사의 지역에 따라 다릅니다. 지역마다 카드 가격을 다르게 책정하려면 `card_regions`를 설정하세요. 자체 마크업이 없는 지역의 카드 결제는 `payment_methods.card`를 사용합니다.

| 키 | 다음 지역의 매입사가 처리한 카드 결제 |
| - | - |
| `usa` | 미국 |
| `eu` | 유럽 |
| `uk` | 영국 |
| `ca` | 캐나다 |
| `au` | 호주 |

```json theme={null}
{
  "child_markups": {
    "card_regions": {
      "usa": { "percentage": 0.55, "fixed": 0.30 },
      "uk": { "percentage": 0.5, "fixed": 0.20 }
    }
  }
}
```

결제는 다음 순서로 처음 찾은 마크업을 사용합니다:

1. 카드 결제 지역에 대한 하위 계정의 마크업.
2. 결제 수단에 대한 하위 계정의 마크업.
3. 하위 계정의 `payments` 마크업.
4. 카드 결제 지역에 대한 플랫폼 기본값.
5. 결제 수단에 대한 플랫폼 기본값.
6. 플랫폼의 `payments` 기본값.

1단계와 4단계는 카드 결제에만 적용됩니다. 하나의 하위 계정에 설정된 요율은 항상 플랫폼 기본값보다 우선합니다.

## 마크업 변경 또는 삭제

* 생략된 필드는 현재 적용 값을 유지합니다. 퍼센트 전용 마크업의 경우 명시적으로 `fixed: 0`을 설정하세요.
* 해당 계정의 마크업을 비활성화하려면 `percentage: 0`과 `fixed: 0`을 모두 설정하세요. 하위 계정은 여전히 Whop 수수료를 지불합니다.
* 하위 계정 재정의를 제거하고 플랫폼 기본값(없으면 0)으로 복원하려면 `markups: { payouts: { bank_wire: null } }`처럼 요율 전체에 `null`을 보내세요.

## 지급 보조금 작동 방식

마크업은 출금 금액의 퍼센트와 고정 금액을 합산합니다. 결과가 음수이면 플랫폼이 해당 금액을 Whop 수수료에 대해 지불합니다. 보조금은 하위 계정의 총 수수료가 0에 도달하면 중단됩니다. 지급액이 출금 금액을 초과하도록 늘리지는 않습니다.

다음 예시는 $10 출금과 $0.60 Whop 수수료를 사용합니다. \$0.60은 예시 요율이며, 모든 지급 수단의 표준 가격이 아닙니다.

| 퍼센트 | 고정 | 하위 계정 수수료 | 순 지급액 | Whop 수령액 | 플랫폼 잔액 변화 |
| - | - | - | - | - | - |
| 0.4% | \$2.00 | \$2.64 | \$7.36 | \$0.60 | +\$2.04 |
| 1% | −\$0.60 | \$0.10 | \$9.90 | \$0.60 | −\$0.50 |
| −5% | \$0.00 | \$0.10 | \$9.90 | \$0.60 | −\$0.50 |
| 0% | −\$100.00 | \$0.00 | \$10.00 | \$0.60 | −\$0.60 |

## 한도 및 자금 조달

| 규칙 | 동작 |
| - | - |
| 지급 마크업 한도 | 각 구성 요소는 음수일 수 있습니다: −100%에서 100%, 고정 금액은 −$100에서 $100. 실제 보조금은 Whop 수수료를 초과할 수 없습니다. |
| 기타 마크업 한도 | 0%에서 100%, 고정 금액은 $0에서 $100. 지급 외 마크업에서는 음수 값이 거부됩니다. |
| 플랫폼 잔액 | 보조금을 충당할 수 있도록 출금 통화로 충분한 가용 잔액을 유지하세요. 잔액 확인과 차감은 함께 이루어집니다. |
| 잔액 부족 | Whop이 재시도하는 동안 지급은 대기 상태로 유지됩니다. 생성 기한(약 10분) 전에 플랫폼에 자금을 충전하세요. 그렇지 않으면 자금 이동 없이 지급이 실패합니다. |
| 전체 수수료 부담 | `covered_payout_fees`가 해당 지급 수단을 부담하는 경우, 플랫폼이 Whop의 전체 수수료를 지불하며 마크업은 무시됩니다. |

EUR 잔액에서 출금하는 경우 플랫폼은 보조금을 충당하기 위해 EUR가 필요합니다. USD 잔액이 자동으로 이를 충당하지는 않습니다.

지급을 생성하기 전에 [지급 견적](https://docs.whop.com/ko/api-reference/payouts/create-payout-quote.md)을 검토하세요. 견적은 수수료를 보여주지만 플랫폼 자금을 예약하지는 않습니다. 플랫폼의 잔액은 지급이 차감될 때 확인됩니다. 실제 수수료는 지급 수단과 계정의 가격 책정에 따라 다릅니다.


## Related topics

- [Accounts API](https://docs.whop.com/ko/api-reference/accounts/account.md)
- [Fee Markup](https://docs.whop.com/ko/api-reference/legacy/fee-markups/fee-markup.md)
- [Create fee markup](https://docs.whop.com/ko/api-reference/legacy/fee-markups/create-fee-markup.md)
