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

# Disputes API

> 분쟁(Dispute)은 고객이 은행을 통해 결제에 대해 제기하는 차지백이거나, 차지백이 될 수 있는 문의입니다.

분쟁에는 이의가 제기된 결제, 응답 기한, 제출한 증빙 자료, 그리고 처리업체가 판정한 이후의 결과가 포함됩니다.

Disputes API를 사용하여 분쟁을 조회하고, 분쟁에 아직 이의를 제기할 수 있는 동안 증빙 자료 패킷을 편집하여 검토를 위해 제출하거나, 이의를 제기하지 않으려는 차지백을 수락할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [분쟁 목록 조회](https://docs.whop.com/ko/api-reference/disputes/list-disputes.md) | GET `/disputes` |
| [분쟁 조회](https://docs.whop.com/ko/api-reference/disputes/retrieve-dispute.md) | GET `/disputes/{id}` |
| [분쟁 요약 조회](https://docs.whop.com/ko/api-reference/disputes/retrieve-dispute-summary.md) | GET `/disputes/summary` |
| [분쟁 수락](https://docs.whop.com/ko/api-reference/disputes/accept-dispute.md) | POST `/disputes/{id}/accept` |
| [분쟁 제출](https://docs.whop.com/ko/api-reference/disputes/submit-dispute.md) | POST `/disputes/{id}/submit` |
| [분쟁 증빙 자료 업로드](https://docs.whop.com/ko/api-reference/disputes/upload-dispute-evidence.md) | POST `/disputes/{id}/upload_evidence` |
| [분쟁 업데이트](https://docs.whop.com/ko/api-reference/disputes/update-dispute.md) | PATCH `/disputes/{id}` |

## 속성

**id** `string` *required*

분쟁 ID이며, 접두사는 `dspt_`입니다.

**acceptable** `boolean` *required*

`POST /disputes/\{id} /accept`로 분쟁을 고객에게 양보할 수 있는지 여부입니다. 아직 응답을 기다리는 차지백이고, `evidence_due_at` 이전이며, 결제 처리업체가 분쟁 수락을 지원하는 경우에만 true입니다. 문의는 수락할 수 없습니다.

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

분쟁이 제기된 계정으로, 접두사는 `biz_`입니다.

**amount** `number` *required*

분쟁 금액으로, `currency`의 정수 단위입니다.

**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_`입니다. 게스트 체크아웃의 경우 `null`입니다.
>
> **username** `string | null` *required*
>
> 고객의 Whop 사용자 이름입니다.

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

분쟁이 시작된 시점으로, ISO 8601 타임스탬프입니다.

**currency** `string` *required*

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

**evidence** `object` *required*

분쟁에 이의를 제기하기 위해 처리업체에 보내는 증빙 자료 패킷입니다.

> [accordion] 속성
>
> **access\_activity\_log** `string | null` *required*
>
> 로그인 또는 다운로드 활동 등 고객의 상품 접근 기록입니다.
>
> **billing\_address** `string | null` *required*
>
> 고객이 체크아웃 시 제공한 청구지 주소입니다.
>
> **cancellation\_policy\_attachment** `object | null` *required*
>
> 취소 정책 문서입니다. 기본값은 계정의 취소 정책이며, 없으면 서비스 약관, 그다음 반품 정책, 그다음 Whop의 플랫폼 정책 순으로 사용됩니다.
>
> > [accordion] 속성
> >
> > **id** `string | null` *required*
> >
> > 첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 `null`입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 업로드된 파일의 MIME 유형입니다.
> >
> > **filename** `string | null` *required*
> >
> > 업로드된 파일의 이름입니다.
> >
> > **platform** `boolean` *required*
> >
> > 판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
> >
> > **url** `string | null` *required*
> >
> > 첨부 파일을 다운로드할 수 있는 URL입니다.
>
> **cancellation\_policy\_disclosure** `string | null` *required*
>
> 구매 전에 고객에게 취소 정책이 어떻게 표시되었는지입니다.
>
> **customer\_communication\_attachment** `object | null` *required*
>
> 고객과의 서신 또는 고객이 상품을 사용했다는 증거입니다.
>
> > [accordion] 속성
> >
> > **id** `string | null` *required*
> >
> > 첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 `null`입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 업로드된 파일의 MIME 유형입니다.
> >
> > **filename** `string | null` *required*
> >
> > 업로드된 파일의 이름입니다.
> >
> > **platform** `boolean` *required*
> >
> > 판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
> >
> > **url** `string | null` *required*
> >
> > 첨부 파일을 다운로드할 수 있는 URL입니다.
>
> **customer\_email\_address** `string | null` *required*
>
> 고객이 체크아웃 시 사용한 이메일 주소입니다.
>
> **customer\_name** `string | null` *required*
>
> 체크아웃 시 고객이 입력한 이름입니다.
>
> **documents** `object[]` *required*
>
> 네 개의 고정 슬롯 외의 추가 증빙 문서로, `PATCH /disputes/\{id}`에서 `evidence.documents`로 설정합니다. 각 문서는 `document_type`에 따라 제출된 패킷에 포함됩니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 파일 ID이며, 접두사는 `file_`입니다.
> >
> > **blurhash** `string | null` *required*
> >
> > 이미지 또는 비디오의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 업로드된 파일의 MIME 유형입니다. 업로드는 처리업체가 허용하는 유형으로 제한되며, 유형이 없으면 거부되므로 절대 null이 아닙니다.
> >
> > 사용 가능한 옵션: `application/pdf`, `application/json`, `image/jpeg`, `image/png`, `image/webp`
> >
> > **created\_at** `string` *required*
> >
> > 파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
> >
> > **document\_type** `string` *required*
> >
> > 이 문서가 증명하는 내용입니다. `return_policy`, `cancellation_policy`, `terms_of_service`는 판매자의 정책 문서입니다. 정책 문서는 이 분쟁에 대해 계정의 사본을 대체합니다. `return_policy`, `cancellation_policy`, `customer_communication`은 해당하는 고정 증빙 슬롯도 대체합니다. `shipping_policy`는 판매자의 배송 약관입니다. `customer_communication`은 지원 스레드나 채팅 기록 같은 구매자와의 서신입니다. `product_image`는 구매자가 받은 상품 또는 서비스의 사진입니다. `physical_fulfillment`는 실물 주문이 배송되어 도착했다는 증거입니다. `digital_fulfillment`는 구매자가 디지털 상품에 접근했다는 증거입니다. `customer_order_history`는 이 판매자에 대한 구매자의 과거 주문 내역입니다. `prior_transactions`는 사기 방어를 위한 플랫폼 전체의 구매자 결제 내역입니다. `customer_session`은 IP 주소, 기기 지문, AVS 및 CVV 결과, 3D Secure 결과 같은 체크아웃 데이터입니다. `subscription`은 갱신, 취소, 발송된 알림 같은 멤버십 수명 주기 증빙입니다. `complete_evidence`는 최대 19페이지의 PDF 하나로 된 판매자의 전체 응답이며, 유일한 문서여야 합니다. Whop은 다른 모든 증빙 필드, 첨부 파일, 문서 대신 `complete_evidence` 문서를 처리업체에 보냅니다.
> >
> > 사용 가능한 옵션: `return_policy`, `shipping_policy`, `cancellation_policy`, `terms_of_service`, `physical_fulfillment`, `customer_order_history`, `product_image`, `prior_transactions`, `customer_session`, `digital_fulfillment`, `subscription`, `customer_communication`, `complete_evidence`
> >
> > **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`
> >
> > 멀티파트 업로드의 ID로, `complete`에 다시 전달합니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
> >
> > **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입니다.
>
> **notes** `string | null` *required*
>
> 분쟁을 검토하는 처리업체를 위한 추가 정보입니다.
>
> **product\_description** `string | null` *required*
>
> 판매자 자신의 말로 설명한, 고객이 구매한 항목입니다.
>
> **refund\_policy\_attachment** `object | null` *required*
>
> 환불 정책 문서입니다. 기본값은 계정의 반품 정책이며, 없으면 서비스 약관, 그다음 Whop의 플랫폼 정책 순으로 사용됩니다.
>
> > [accordion] 속성
> >
> > **id** `string | null` *required*
> >
> > 첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 `null`입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 업로드된 파일의 MIME 유형입니다.
> >
> > **filename** `string | null` *required*
> >
> > 업로드된 파일의 이름입니다.
> >
> > **platform** `boolean` *required*
> >
> > 판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
> >
> > **url** `string | null` *required*
> >
> > 첨부 파일을 다운로드할 수 있는 URL입니다.
>
> **refund\_policy\_disclosure** `string | null` *required*
>
> 구매 전에 고객에게 환불 정책이 어떻게 표시되었는지입니다.
>
> **refund\_refusal\_explanation** `string | null` *required*
>
> 환불이 요청되었으나 거절된 경우, 환불이 거절된 이유입니다.
>
> **service\_date** `string | null` *required*
>
> 상품 또는 서비스가 제공된 시점입니다.
>
> **uncategorized\_attachment** `object | null` *required*
>
> 다른 카테고리에 해당하지 않는 보조 증빙 자료입니다.
>
> > [accordion] 속성
> >
> > **id** `string | null` *required*
> >
> > 첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 `null`입니다.
> >
> > **content\_type** `string | null` *required*
> >
> > 업로드된 파일의 MIME 유형입니다.
> >
> > **filename** `string | null` *required*
> >
> > 업로드된 파일의 이름입니다.
> >
> > **platform** `boolean` *required*
> >
> > 판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
> >
> > **url** `string | null` *required*
> >
> > 첨부 파일을 다운로드할 수 있는 URL입니다.

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

증빙 자료 제출 기한으로, ISO 8601 타임스탬프입니다. 네트워크가 증빙 자료 단계 없이 이미 분쟁을 자동 해결한 경우(Visa RDR) 또는 처리업체가 이 분쟁의 기한을 보고하지 않은 경우 `null`입니다.

**evidence\_editable** `boolean` *required*

`evidence`를 아직 변경하고 제출할 수 있는지 여부입니다.

**evidence\_locked\_reason** `string | null` *required*

증빙 자료를 더 이상 편집할 수 없는 이유입니다. `evidence_editable`이 true인 동안에는 `null`입니다.

사용 가능한 옵션: `submitted`, `response_window_closed`, `not_contestable`

**evidence\_submitted\_at** `string | null` *required*

증빙 자료가 처리업체에 제출된 시점으로, ISO 8601 타임스탬프입니다.

**fee** `object | null` *required*

계정에 청구된 분쟁 수수료로, 징수된 통화 기준입니다. `fee_charged`가 false이면 `null`입니다.

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

**fee\_charged** `boolean` *required*

Whop이 이 분쟁에 대해 계정에 분쟁 수수료를 청구했는지 여부입니다. 분쟁이 시작되기 전에 결제가 전액 환불된 경우, Visa RDR 해결의 경우, 문의의 경우 `false`입니다.

**inquiry** `boolean` *required*

정식 차지백이 아닌 분쟁 전 문의인지 여부입니다. 문의는 동일한 수명 주기를 따르지만 격상되지 않는 한 자금이 이동하지 않습니다.

**issuer\_comments** `object[]` *required*

카드 발급사가 분쟁을 접수할 때 남긴 내용입니다. 발급사가 제공한 경우에만 채워지며, 받은 순서대로 나열됩니다.

> [accordion] 속성
>
> **received\_at** `string | null` *required*
>
> 코멘트를 받은 시점으로, ISO 8601 타임스탬프입니다.
>
> **text** `string` *required*
>
> 발급사가 작성한 내용으로, 받은 그대로입니다.

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

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

> [accordion] 속성
>
> **id** `string | null` *required*
>
> 라인 항목 ID이며, 접두사는 `li_`입니다. 결제가 항목 스냅샷 도입 이전의 것이어서 항목을 결제의 변형에서 읽는 경우 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`입니다.

**payment** `object` *required*

분쟁 대상 결제입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 결제 ID이며, 접두사는 `pay_`입니다.
>
> **amount** `number | null` *required*
>
> 고객에게 청구된 금액으로, 결제 통화의 정수 단위입니다.
>
> **card\_brand** `string | null` *required*
>
> 고객이 카드로 결제한 경우의 카드 브랜드입니다.
>
> **card\_last4** `string | null` *required*
>
> 고객이 카드로 결제한 경우 카드의 마지막 네 자리입니다.
>
> **created\_at** `string` *required*
>
> 결제가 이루어진 시점으로, ISO 8601 타임스탬프입니다.
>
> **currency** `string | null` *required*
>
> 결제의 세 글자 ISO 통화 코드입니다. 처리업체가 다른 통화로 정산하는 경우 분쟁 통화와 다를 수 있습니다.
>
> **payment\_instrument** `object | null` *required*
>
> 이 결제에 사용된 결제 수단으로, 표시용 형태입니다. 결제 수단 유형, 구매자에게 표시되는 이름, 표준 아이콘 세트, 그리고 카드인 경우 계정이 해당 카드에 사용하는 네트워크 거래 ID를 포함한 카드 정보가 포함됩니다. 결제에 결제 수단이 지정되지 않은 경우 null입니다.
>
> > [accordion] 속성
> >
> > **card** `object | null` *required*
> >
> > 카드, Apple Pay, Google Pay 결제에만 해당합니다. 카드의 네트워크, 마지막 네 자리, 발급사 식별 번호, 만료일, 네트워크 거래 ID입니다.
> >
> > > [accordion] 속성
> > >
> > > **brand** `string | null` *required*
> > >
> > > 네트워크 식별자(`visa`, `amex`, …)로, `card.networks` 항목 및 저장된 카드 결제 수단과 일치합니다. 저장소에 네트워크가 기록되지 않은 경우 null입니다.
> > >
> > > **exp\_month** `number | null` *required*
> > >
> > > 카드 만료 월(1\~12)입니다. 저장소에 기록되지 않은 경우 null입니다.
> > >
> > > **exp\_year** `number | null` *required*
> > >
> > > 카드의 네 자리 만료 연도입니다. 저장소에 기록되지 않은 경우 null입니다.
> > >
> > > **issuer\_identification\_number** `string | null` *required*
> > >
> > > BIN이라고도 하는 발급사 식별 번호로, 발급 은행을 식별하는 카드의 앞 6자리 또는 8자리입니다. 처리업체가 보고하지 않은 경우 null입니다.
> > >
> > > **last4** `string | null` *required*
> > >
> > > 수집된 경우 카드의 마지막 네 자리입니다.
> > >
> > > **network\_transaction\_id** `string | null` *required*
> > >
> > > 이 계정이 해당 카드에 사용하는 네트워크 거래 ID입니다. Whop에 해당 값이 있는 경우, 해당 카드에 대한 첫 번째 고객 참여 청구 또는 인증에서 얻은 이 계정 자체의 ID입니다. 그렇지 않으면 이 카드의 이전 네트워크 거래 ID로, 다른 계정의 거래에서 온 것이거나 카드와 함께 가져온 것일 수 있습니다. 이 계정에서 이 카드로 이후 가맹점 주도 청구를 할 때 이전 거래로 인용하세요. 값이 생길 때까지 null입니다. 결제가 처음 기록될 때 전송된 웹훅에는 `null`이 포함될 수 있으므로, 값을 확인하려면 결제를 조회하세요.
> >
> > **display\_name** `string` *required*
> >
> > 구매자에게 표시되는 결제 수단 이름으로, 카드가 표시되는 경우 "Visa •••• 4242", 그렇지 않으면 결제 수단 자체의 이름("Klarna")입니다.
> >
> > **icons** `object` *required*
> >
> > 표준 아이콘 세트로, 정사각형과 카드 모양이 각각 라이트 및 다크 색상으로 제공됩니다.
> >
> > > [accordion] 속성
> > >
> > > **card** `object` *required*
> > >
> > > 신용카드 비율의 타일(48x30)입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > 어두운 배경용 색상입니다.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > 모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > 2배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > 4배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > 벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > 밝은 배경용 색상입니다.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > 모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > 2배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > 4배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > 벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
> > >
> > > **square** `object` *required*
> > >
> > > 정사각형 타일(32x32)입니다.
> > >
> > > > [accordion] 속성
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > 어두운 배경용 색상입니다.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > 모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > 2배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > 4배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > 벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > 밝은 배경용 색상입니다.
> > > >
> > > > > [accordion] 속성
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > 모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > 2배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > 4배 밀도의 래스터 대체 이미지입니다.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > 벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
> >
> > **installment\_count** `number | null` *required*
> >
> > 할부 결제 수단에만 해당합니다. 청구가 나뉘는 결제 횟수입니다. 문구가 아닌 데이터이므로 레이블은 클라이언트 측에서 구성하고 번역하세요.
> >
> > **payment\_method\_type** `string` *required*
> >
> > 결제 수단 유형 식별자입니다(예: `card`, `klarna`, `apple_pay`).
>
> **payment\_method\_type** `string | null` *required*
>
> 고객의 결제 방식입니다(예: `card` 또는 `paypal`).
>
> **payment\_processor** `string | null` *required*
>
> 지원 중단됨: 더 이상 채워지지 않습니다. 항상 `null`입니다. 지원 중단됨: 더 이상 채워지지 않습니다. 항상 null입니다.

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

분쟁 대상 결제의 상품으로, 접두사는 `prod_`입니다.

**reason** `string` *required*

고객이 주장하는 분쟁 사유로, 처리업체와 카드 네트워크 전반에 걸쳐 정규화됩니다. `other`는 Whop이 아직 분류하지 않은 처리업체 사유를 포함합니다.

사용 가능한 옵션: `fraudulent`, `unrecognized`, `declined_authorization`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, `credit_not_processed`, `duplicate`, `processing_error`, `documentation_request`, `bank_cannot_process`, `other`

**reason\_code** `string | null` *required*

카드 네트워크 또는 처리업체의 원래 사유 코드입니다(예: `10.4`). 참고용이며, `reason`은 이 값에서 파생되지 않습니다.

**status** `string` *required*

`needs_response`는 증빙 자료를 기다리는 상태입니다(처리업체가 제출을 거부한 경우 `submission_failure_reason`에 사유가 표시됩니다). `generating_response`는 증빙 자료가 처리업체에 있지만 아직 수락되지 않은 상태입니다. `under_review`는 처리업체가 검토 중인 상태입니다. `won`/`lost`는 판정 결과입니다. `prevented`는 `lost`처럼 정산됩니다. `warning_` 상태는 문의 단계입니다. `evidence_due_at`이 지난 진행 중인 분쟁은 `under_review`로 보고됩니다.

사용 가능한 옵션: `needs_response`, `warning_needs_response`, `under_review`, `warning_under_review`, `generating_response`, `won`, `lost`, `prevented`, `warning_closed`

**submission\_failure\_reason** `string | null` *required*

분쟁이 `needs_response`로 돌아간 동안, 결제 처리업체가 마지막 제출을 거부한 이유를 쉬운 영어로 설명합니다. 지적된 사항을 수정하고 다시 제출하세요. 조회 시에만 제공됩니다. `dispute.updated`가 `needs_response`로의 복귀를 알리면, 여기에서 이 값을 확인하세요.

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

분쟁이 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다.

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

분쟁 대상 결제가 이루어진 변형으로, 접두사는 `plan_`입니다.

```json Dispute theme={null}
{
	"id": "dspt_xxxxxxxxxxxxx",
	"acceptable": true,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"amount": 49.99,
	"buyer": {
		"email": "alex@example.com",
		"member_id": "mem_xxxxxxxxxxxxx",
		"name": "Alex Rivera",
		"user_id": "user_xxxxxxxxxxxxx",
		"username": "alex"
	},
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"evidence": {
		"access_activity_log": "2026-05-02 14:11 UTC signed in and opened the course; 2026-05-04 09:32 UTC downloaded lesson materials",
		"billing_address": "123 Main St, Austin, TX 78701, US",
		"cancellation_policy_attachment": null,
		"cancellation_policy_disclosure": "Shown on the checkout page beneath the pay button.",
		"customer_communication_attachment": {
			"id": "att_xxxxxxxxxxxxx",
			"content_type": "application/pdf",
			"filename": "support-thread.pdf",
			"platform": false,
			"url": "https://assets.whop.com/uploads/att_xxxxxxxxxxxxx/support-thread.pdf"
		},
		"customer_email_address": "alex@example.com",
		"customer_name": "Alex Rivera",
		"notes": "Customer accessed the product for four weeks before disputing.",
		"product_description": "Monthly membership to the Pickaxe trading community, including the full course library.",
		"refund_policy_attachment": {
			"id": null,
			"content_type": "application/pdf",
			"filename": "refund-policy.pdf",
			"platform": true,
			"url": "https://whop.com/policies/refund-policy.pdf"
		},
		"refund_policy_disclosure": "Linked in the order confirmation email and on the checkout page.",
		"refund_refusal_explanation": "Refund was refused because the membership had been used past the 7-day refund window.",
		"service_date": "2026-05-01",
		"uncategorized_attachment": null,
		"documents": [
			{
				"id": "file_xxxxxxxxxxxxxx",
				"object": "file",
				"document_type": "product_image",
				"filename": "before-and-after-coating.png",
				"content_type": "image/png",
				"size": 48213,
				"url": "https://cdn.whop.com/attachments/before-and-after-coating.png",
				"upload_status": "ready",
				"visibility": "private",
				"created_at": "2026-06-01T12:00:00Z",
				"width": null,
				"height": null,
				"blurhash": null,
				"duration_seconds": null,
				"waveform_url": null,
				"removed_by_moderation": false
			}
		]
	},
	"evidence_due_at": "2026-06-15T00:00:00Z",
	"evidence_editable": true,
	"evidence_locked_reason": null,
	"submission_failure_reason": null,
	"evidence_submitted_at": null,
	"fee": {
		"amount": "15.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"fee_charged": true,
	"inquiry": false,
	"issuer_comments": [
		{
			"received_at": "2026-06-01T12:00:00Z",
			"text": "Cardholder states they did not authorize this transaction."
		}
	],
	"payment": {
		"id": "pay_xxxxxxxxxxxxx",
		"amount": 49.99,
		"card_brand": "visa",
		"card_last4": "4242",
		"created_at": "2026-05-01T09:30:00Z",
		"currency": "usd",
		"payment_method_type": "card",
		"payment_processor": null,
		"payment_instrument": {
			"payment_method_type": "card",
			"display_name": "Visa •••• 4242",
			"icons": {
				"square": {
					"light": {
						"svg": "https://content.whop.com/payment_methods/visa/square_light.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/square_light_32.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/square_light_64.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/square_light_128.png"
					},
					"dark": {
						"svg": "https://content.whop.com/payment_methods/visa/square_dark.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/square_dark_32.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/square_dark_64.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/square_dark_128.png"
					}
				},
				"card": {
					"light": {
						"svg": "https://content.whop.com/payment_methods/visa/card_light.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/card_light_30.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/card_light_60.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/card_light_120.png"
					},
					"dark": {
						"svg": "https://content.whop.com/payment_methods/visa/card_dark.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/card_dark_30.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/card_dark_60.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/card_dark_120.png"
					}
				}
			},
			"card": {
				"brand": "visa",
				"last4": "4242",
				"issuer_identification_number": "41111111",
				"exp_month": 11,
				"exp_year": 2030,
				"network_transaction_id": "016153570198200"
			},
			"installment_count": null
		}
	},
	"line_items": [
		{
			"id": "li_xxxxxxxxxxxxx",
			"label": "Ceramic Coating Package",
			"variant_id": "plan_xxxxxxxxxxxxx",
			"variant_title": "One-time",
			"product_id": "prod_xxxxxxxxxxxxx",
			"product_title": "Ceramic Coating Package",
			"quantity": 1,
			"sku": "CERAMIC-COAT-3YR",
			"subtotal": {
				"amount": "299.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"variant_id": "plan_xxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"reason": "fraudulent",
	"reason_code": "10.4",
	"status": "needs_response",
	"updated_at": "2026-06-01T12:00:00Z"
}
```


## Related topics

- [Dispute Alerts API](https://docs.whop.com/ko/api-reference/dispute-alerts/dispute-alert.md)
- [Dispute](https://docs.whop.com/ko/api-reference/legacy/disputes/dispute.md)
- [List disputes](https://docs.whop.com/ko/api-reference/legacy/disputes/list-disputes.md)
