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

# 결제 건전성

> Payment health 대시보드로 분쟁률과 환불률을 추적하고 계정에 적용된 제어 조치를 확인하세요.

**Payment health** 대시보드는 분쟁과 환불이 계정과 결제 제어 조치에 어떤 영향을 미치는지 보여 줍니다. 대시보드의 **Payments** → **Payment health**에서, 또는 [whop.com/dashboard/payments/health](https://whop.com/dashboard/payments/health/)에서 찾을 수 있습니다.

## 분쟁률이란

분쟁(차지백이라고도 함)은 고객이 판매자에게 환불을 요청하는 대신 은행에 결제 취소를 요청할 때 발생합니다. 분쟁률은 전체 결제 중 분쟁으로 이어진 결제의 비율입니다.

어느 비즈니스에서나 분쟁이 몇 건 발생하는 것은 정상입니다. 문제는 비율입니다. 카드 네트워크는 모든 가맹점에 최대 분쟁률을 적용하며, 이들이 중요하게 보는 기준선은 \*\*1.5%\*\*입니다. 각 네트워크의 프로그램과 한도는 [분쟁 모니터링 프로그램](https://docs.whop.com/ko/trust-and-safety/account-health/dispute-monitoring-programs.md)에서 확인할 수 있습니다. 이 기준 아래로 유지하면 양호한 상태입니다. 기준을 넘으면 판매자와 Whop 모두에게 불이익이 따릅니다.

## 두 가지 방식으로 측정하는 분쟁률

대시보드는 분쟁률을 **30d window**와 **By purchase date** 두 가지 모드로 보여 줍니다. 두 모드는 서로 다른 질문에 답합니다.

* **30d window**: 최근 30일 동안 제기된 분쟁 ÷ 최근 30일 동안 받은 결제.
* **By purchase date**: 한 기간의 결제를 기준으로 그중 몇 건이 분쟁으로 이어졌는지 계산합니다. 결제 후 N일 이내에 제기된 분쟁 ÷ 해당 기간에 받은 결제이며, N은 **Disputed within 7 days**, **Disputed within 14 days**, **Disputed within 28 days** 선택기로 정합니다. 대시보드는 각 분쟁을 제기일이 아니라 결제일에 할당합니다.

예를 들어 최근 30일 동안 결제 1,000건을 받았고, 같은 기간에 분쟁 10건이 들어왔다고 가정해 보겠습니다.

최근 30일 결제에 대한 분쟁 3건
이전 결제에 대한 분쟁 7건

**30d window** 비율은 분쟁 10건을 모두 집계합니다: 10 ÷ 1,000 = **1%**. **By purchase date** 비율은 이번 달 결제에 해당하는 3건만 집계합니다: 현재까지 3 ÷ 1,000 = **0.3%**. 이번 달 결제에 대한 분쟁이 더 들어올수록 이 비율은 계속 올라갑니다.

어느 쪽을 지켜봐야 할지는 상황에 따라 다릅니다.

* **매출이 꾸준하다면** 두 비율은 거의 비슷하게 보입니다.
* **빠르게 성장하고 있다면** 고객이 최근 결제에 분쟁을 제기할 시간이 아직 없었기 때문에 30d window 비율이 낮게 보입니다. 대신 구매일 기준 비율을 지켜보세요. 30일 수치가 따라잡기 전에 실제 분쟁률을 보여 줍니다.

> [!NOTE]
>
> 구매일 기준 보기는 전체 분쟁 기간이 지난 결제만 집계합니다. 어제 받은
> 결제는 28일 기간이 아직 지나지 않았으므로 이 보기에서 아직 점수를 매길 수
> 없습니다.

## 상태

각 분쟁률 지표에는 **Healthy**, **At risk**, **Critical** 중 하나의 상태가 부여됩니다. 차트는 각 지표의 정확한 구간을 표시하며, 결제 수단 탭마다 고유한 구간이 있습니다. American Express, Discover, 선구매 후결제(BNPL) 수단은 일반 카드와 다른 기준이 적용됩니다. 모든 기준선은 [분쟁 모니터링 프로그램](https://docs.whop.com/ko/trust-and-safety/account-health/dispute-monitoring-programs.md)에 정리되어 있습니다. 계정에 점수를 매길 만큼 결제나 분쟁이 충분하지 않으면 지표에 **Low data**가 대신 표시됩니다.

## 계정에 적용된 제어 조치

페이지의 **Controls** 섹션에는 현재 계정에 설정된 [결제 제어 조치](https://docs.whop.com/ko/trust-and-safety/account-health/controls.md)가 표시됩니다. 여기에는 리저브, 자동 환불 기준 금액, 보류 지연, 수수료, 파이낸싱 이용 가능 여부가 포함됩니다. 검토는 지속적으로 진행되며, 계정이 회복되면 제어 조치가 자동으로 완화되거나 해제됩니다.

## 환불률

대시보드에는 환불률도 표시됩니다. 환불률은 전체 결제 대비 환불 건의 비율입니다. 분쟁률과 함께 읽으세요. 환불률은 낮은데 분쟁률이 높다면 돈을 돌려받고 싶었던 고객이 판매자에게 오지 않고 은행으로 갔다는 뜻입니다.

## 고객이 분쟁을 제기하는 이유

**Why customers dispute** 카드는 분쟁을 사유별로 나누어 보여 줍니다. 각 사유는 해결 방법을 알려 줍니다.

| 사유 | 고객이 하는 말 | 해결 방법 |
| - | - | - |
| **Fraudulent** | "이 청구 내역을 모르겠어요" | 명확한 청구 설명자를 사용하고 재청구를 미리 고지하세요 |
| **Not received** | "주문한 상품이 도착하지 않았어요" | 배송 추적을 추가하고 정직한 배송 예상일을 안내하세요 |
| **Subscription canceled** | "취소했는데도 청구되었어요" | 취소를 쉽게 하고 신속하게 처리하세요 |
| **Product unacceptable** | "약속받은 것과 달라요" | 스토어프론트가 실제로 제공하는 것과 일치하도록 하세요 |
| **Credit not processed** | "환불해 준다고 했는데 받지 못했어요" | 해야 할 환불을 신속하게 처리하세요 |

> [!TIP]
>
> 한 가지 사유가 차트의 대부분을 차지한다면 거기서부터 시작하세요. 가장 큰
> 부분을 해결하면 분쟁률이 가장 크게 움직입니다.

## 다음 단계

> [card] [분쟁 모니터링 프로그램](https://docs.whop.com/ko/trust-and-safety/account-health/dispute-monitoring-programs.md)
>
> 각 카드 네트워크의 프로그램, 분쟁 집계 방식, 한도.

> [card] [결제 제어 조치](https://docs.whop.com/ko/trust-and-safety/account-health/controls.md)
>
> 계정의 각 제어 조치가 하는 일과 제어 조치가 해제되는 방식.

> [card] [분쟁률 관리](https://docs.whop.com/ko/trust-and-safety/account-health/managing-dispute-rates.md)
>
> 분쟁률을 낮추는 구체적인 단계.
