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

# Resolution Center Cases API

> Resolution Center Case는 원치 않는 갱신, 도착하지 않은 상품, 알 수 없는 청구 등 구매에 문제가 있을 때 구매자가 여는 케이스입니다.

이는 차지백 이전 단계로, 구매자와 판매자가 직접 해결하며, 해결하지 못하면 Whop이 케이스를 결정합니다.

Resolution Center Cases API는 양측 모두에서 사용할 수 있습니다. 구매자는 케이스를 열고, 답변하고, 이의를 제기하거나, 철회할 수 있으며, 판매자는 케이스를 수락(결제 환불)하거나, 거부하거나, 구매자에게 추가 정보를 요청할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [분쟁 조정 센터 케이스 목록 조회](https://docs.whop.com/ko/api-reference/resolution-center-cases/list-resolution-center-cases.md) | GET `/resolution_center_cases` |
| [분쟁 조정 센터 케이스 조회](https://docs.whop.com/ko/api-reference/resolution-center-cases/retrieve-resolution-center-case.md) | GET `/resolution_center_cases/{id}` |
| [분쟁 조정 센터 케이스 이벤트 목록 조회](https://docs.whop.com/ko/api-reference/resolution-center-cases/list-resolution-center-case-events.md) | GET `/resolution_center_cases/{id}/events` |
| [분쟁 조정 센터 케이스 요약 조회](https://docs.whop.com/ko/api-reference/resolution-center-cases/retrieve-resolution-center-case-summary.md) | GET `/resolution_center_cases/summary` |
| [고객으로서 케이스 열기](https://docs.whop.com/ko/api-reference/resolution-center-cases/open-a-case-as-the-customer.md) | POST `/resolution_center_cases` |
| [케이스 수락](https://docs.whop.com/ko/api-reference/resolution-center-cases/accept-a-case.md) | POST `/resolution_center_cases/{id}/accept` |
| [케이스 이의 제기](https://docs.whop.com/ko/api-reference/resolution-center-cases/appeal-a-case.md) | POST `/resolution_center_cases/{id}/appeal` |
| [케이스 거부](https://docs.whop.com/ko/api-reference/resolution-center-cases/deny-a-case.md) | POST `/resolution_center_cases/{id}/deny` |
| [케이스에 답변](https://docs.whop.com/ko/api-reference/resolution-center-cases/reply-to-a-case.md) | POST `/resolution_center_cases/{id}/reply` |
| [고객에게 정보 요청](https://docs.whop.com/ko/api-reference/resolution-center-cases/request-information-from-the-customer.md) | POST `/resolution_center_cases/{id}/request_info` |
| [케이스 철회](https://docs.whop.com/ko/api-reference/resolution-center-cases/withdraw-a-case.md) | POST `/resolution_center_cases/{id}/withdraw` |

## 속성

**id** `string` *required*

`reso_` 접두사가 붙은 분쟁 조정 센터 케이스 ID입니다.

**account** `object | null` *required*

케이스가 제기된 대상 계정입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `biz_` 접두사가 붙은 계정 ID입니다.
>
> **title** `string` *required*
>
> 계정 표시 이름입니다.

**amount** `number` *required*

문제가 된 금액으로, `currency`의 기본 단위입니다.

**available\_actions** `string[]` *required*

현재 이 케이스에 대해 수행할 수 있는 작업으로, 해당 작업을 수행하는 엔드포인트 이름으로 표시됩니다. 호출하는 자격 증명을 기준으로 결정되므로, 같은 케이스를 조회하더라도 판매자와 고객은 각자의 옵션을 보게 됩니다.

사용 가능한 옵션: `accept`, `deny`, `request_info`, `reply`, `appeal`, `withdraw`

**buyer** `object` *required*

케이스를 연 고객입니다.

> [accordion] 속성
>
> **email** `string | null` *required*
>
> 고객의 이메일 주소입니다. `member:email:read` 스코프가 필요하며, 없으면
> `null`입니다.
>
> **member\_id** `string | null` *required*
>
> 계정에서 고객의 회원 레코드로, `mem_` 접두사가 붙습니다.
>
> **name** `string | null` *required*
>
> 고객의 표시 이름입니다.
>
> **user\_id** `string | null` *required*
>
> 고객의 사용자 ID로, `user_` 접두사가 붙습니다.
>
> **username** `string | null` *required*
>
> 고객의 Whop 사용자 이름입니다.

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

케이스가 열린 시각으로, ISO 8601 타임스탬프입니다.

**currency** `string | null` *required*

금액의 세 글자 ISO 통화 코드입니다.

**customer\_appealed** `boolean` *required*

고객이 이 케이스의 결정에 이의를 제기했는지 여부입니다.

**escalated** `boolean` *required*

Whop이 관여하고 있는지 여부입니다. 즉 Whop이 케이스를 검토 중이거나, 검토 중에
요청한 사항에 대해 `status`가 지정한 측의 응답을 기다리고 있는 상태입니다.

**line\_items** `object[]` *required*

분쟁 대상 결제로 청구된 모든 항목으로, 구매 순서대로 나열됩니다. `product_id`와 `variant_id`는 이 중 첫 번째 항목을 가리키며, 장바구니의 이후 항목은 여기에만 나타납니다. 항목이 기록되기 전에 이루어진 결제는 해당 변형이 암시하는 단일 항목을 나열합니다. 결제가 변형에 연결되어 있지 않으면 비어 있습니다.

> [accordion] 속성
>
> **id** `string | null` *required*
>
> `li_` 접두사가 붙은 항목 ID입니다. 결제가 항목 스냅샷 이전의 것이어서 항목을
> 결제의 변형에서 읽어 오는 경우 null입니다.
>
> **label** `string | null` *required*
>
> 결제 화면에 표시된 항목 이름입니다(상품 제목, 없으면 변형
> 제목).
>
> **product\_id** `string | null` *required*
>
> 변형이 속한 상품으로, `prod_` 접두사가 붙습니다. 항목 스냅샷 이전의 결제에서는
> 변형의 상품으로 대체되므로, 상위 객체의 `product_id`가 null인 경우에도
> 설정될 수 있습니다. 상품이 없는 변형의 경우
> null입니다.
>
> **product\_title** `string | null` *required*
>
> 상품의 현재 제목이며, 항목에 상품이 없으면 `null`입니다.
>
> **quantity** `number` *required*
>
> 구매한 수량입니다.
>
> **sku** `string | null` *required*
>
> 변형의 재고 관리 단위(SKU)로, 판매자가 설정한 자유 텍스트입니다(예:
> `TSHIRT-LARGE-BLUE`). 청구 사유 SKU 접미사가 활성화된 계정은 청구가 발생한
> 이유가 덧붙은 값을 받습니다. 첫 구독 청구는 `-S`, 갱신은 `-R`, 일회성 구매는
> `-C`, 결제 자체의 메타데이터에 `upsell: true`가 있으면 `-U`, 청구된 금액이 없으면 `-F`입니다.
> 그 외의 청구 사유에는 접미사 없는 SKU가 사용됩니다. 변형에 SKU가 없거나
> 삭제된 경우 `null`입니다.
>
> **subtotal** `object | null` *required*
>
> 할인, 세금, 수수료 적용 전 이 항목 전체 수량에 대해 기록된 금액으로, 구매 통화 기준입니다. 기록된 항목 금액이 없으면 `null`을 반환합니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **variant\_id** `string | null` *required*
>
> 구매한 변형으로, `plan_` 접두사가 붙습니다. 이후 변형이 삭제된 경우
> null입니다.
>
> **variant\_title** `string | null` *required*
>
> 변형의 현재 제목이며, 변형이 삭제되었거나 제목이 없으면 `null`입니다.

**outcome** `string | null` *required*

클레임에서 이긴 측입니다. 케이스가 종료될 때까지 `null`입니다. 실제로 자금이 이동했는지는 `refund`를 확인하세요.

사용 가능한 옵션: `customer_won`, `merchant_won`, `withdrawn`

**payment** `object` *required*

케이스가 열린 대상 결제입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `pay_` 접두사가 붙은 결제 ID입니다.
>
> **card\_brand** `string | null` *required*
>
> 고객이 카드로 결제한 경우의 카드 브랜드입니다.
>
> **card\_last4** `string | null` *required*
>
> 고객이 카드로 결제한 경우 카드의 마지막 네 자리입니다.
>
> **created\_at** `string` *required*
>
> 결제가 이루어진 시각으로, ISO 8601 타임스탬프입니다.
>
> **payment\_method\_type** `string | null` *required*
>
> 고객의 결제 방식으로, 예를 들어 `card` 또는 `paypal`입니다.

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

결제 대상 상품으로, `prod_` 접두사가 붙습니다.

**reason** `string` *required*

고객이 주장하는 문제입니다. `/disputes`와 동일한 용어를 사용하므로, 나중에 차지백으로 전환된 케이스도 같은 불만 사유를 보고합니다.

사용 가능한 옵션: `fraudulent`, `product_not_received`, `not_as_described`, `product_unacceptable`, `subscription_canceled`

**refund** `string | null` *required*

자금이 이동했는지, 그리고 누구의 잔액에서 이동했는지를 나타냅니다. `none`, `merchant`, `platform`(Whop이 고객에게 환불하고 판매자는 자금을 유지함) 중 하나입니다. `outcome`과는 독립적이므로, 판매자가 이긴 케이스에도 플랫폼 환불이 있을 수 있습니다. 케이스가 열려 있는 동안과, 이 값이 기록되기 이전에 종료된 오래된 케이스에서는 `null`입니다.

사용 가능한 옵션: `none`, `merchant`, `platform`

**response\_due\_at** `string | null` *required*

다음 응답 기한으로, ISO 8601 타임스탬프입니다.

**status** `string` *required*

케이스가 누구를 기다리고 있는지를 나타냅니다. `awaiting_merchant`와 `awaiting_customer`는 응답해야 하는 측을 나타내고, `under_review`는 Whop이 결정 중임을, `closed`는 해결되었음을 의미합니다. 어떻게 해결되었는지는 `outcome`을 확인하세요.

사용 가능한 옵션: `awaiting_merchant`, `awaiting_customer`, `under_review`, `closed`

**updated\_at** `string` *required*

케이스가 마지막으로 변경된 시각으로, ISO 8601 타임스탬프입니다.

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

결제가 이루어진 변형으로, `plan_` 접두사가 붙습니다.

```json ResolutionCenterCase theme={null}
{
	"id": "reso_xxxxxxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing"
	},
	"amount": 249,
	"available_actions": ["accept", "deny", "request_info", "reply"],
	"buyer": {
		"email": "dana@example.com",
		"member_id": "mber_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"user_id": "user_xxxxxxxxxxxxxx",
		"username": "danawhitfield"
	},
	"created_at": "2026-09-15T14:30:00.000Z",
	"currency": "usd",
	"customer_appealed": false,
	"escalated": false,
	"line_items": [
		{
			"id": "li_xxxxxxxxxxxxxx",
			"label": "Ceramic Coating Package",
			"variant_id": "plan_xxxxxxxxxxxxxx",
			"variant_title": "Ceramic Coating — Full Vehicle",
			"product_id": "prod_xxxxxxxxxxxxxx",
			"product_title": "Ceramic Coating Package",
			"quantity": 1,
			"sku": null,
			"subtotal": {
				"amount": "249.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"outcome": null,
	"payment": {
		"id": "pay_xxxxxxxxxxxxxx",
		"card_brand": "visa",
		"card_last4": "4242",
		"created_at": "2026-09-02T10:00:00.000Z",
		"payment_method_type": "card"
	},
	"variant_id": "plan_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxxx",
	"reason": "product_not_received",
	"refund": null,
	"response_due_at": "2026-09-18T14:30:00.000Z",
	"status": "awaiting_merchant",
	"updated_at": "2026-09-15T14:30:00.000Z"
}
```


## Related topics

- [Resolution Center Case](https://docs.whop.com/ko/api-reference/legacy/resolution-center-cases/resolution-center-case.md)
- [Retrieve resolution center case](https://docs.whop.com/ko/api-reference/legacy/resolution-center-cases/retrieve-resolution-center-case.md)
- [List resolution center cases](https://docs.whop.com/ko/api-reference/legacy/resolution-center-cases/list-resolution-center-cases.md)
