Skip to main content
POST
TypeScript

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

payment:dispute

헤더

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
예시:

"d9105228-4a08-46b1-8b91-42fed586d383"

경로 매개변수

id
string
필수

The dispute ID (dspt_ tag).

본문

documents
object[]
필수

The full set of evidence documents the dispute should carry, beyond the four fixed evidence slots. Replaces all previously uploaded documents; an empty list removes them all. Send up to 10, 10MB each and 25MB in total. Accepted content types: application/pdf, application/json, image/jpeg, image/png, image/webp — any other type is rejected. Upload files through POST /files and reference them by id, or send the files as multipart file parts to upload and attach in one call. Policy documents (return_policy, shipping_policy, cancellation_policy, terms_of_service) default from the account's own documents; uploading one here replaces the account copy for this dispute, and a cancellation_policy or return_policy upload also takes precedence over the matching fixed evidence slot.

Maximum array length: 10

응답

evidence documents attached

acceptable
boolean
필수

Whether the dispute can be conceded to the customer with POST /disputes/{id}/accept. True only for a chargeback still awaiting a response, before evidence_due_at, whose payment processor supports accepting disputes. Inquiries are never acceptable.

예시:

true

account_id
string | null
필수

The account the dispute was filed against, prefixed biz_.

예시:

"biz_xxxxxxxxxxxxxx"

amount
number
필수

The disputed amount, in whole units of currency.

예시:

150

buyer
object
필수

The customer who filed the dispute.

created_at
string
필수

When the dispute was opened, as an ISO 8601 timestamp.

예시:

"2026-01-01T12:00:00.000Z"

currency
string
필수

Three-letter ISO currency code of the disputed amount.

예시:

"usd"

evidence
object
필수

The evidence packet sent to the processor to contest the dispute.

evidence_due_at
string | null
필수

The deadline to submit evidence, as an ISO 8601 timestamp. null when the network already auto-resolved the dispute (Visa RDR) with no evidence round, or when the processor hasn't reported a deadline for this dispute.

예시:

"2026-01-01T12:00:00.000Z"

evidence_editable
boolean
필수

Whether evidence can still be changed and submitted.

예시:

true

evidence_locked_reason
enum<string> | null
필수

Why evidence can no longer be edited. null while evidence_editable is true.

사용 가능한 옵션:
submitted,
response_window_closed,
not_contestable,
null
예시:

"submitted"

evidence_submitted_at
string | null
필수

When the evidence was submitted to the processor, as an ISO 8601 timestamp.

예시:

null

fee
object | null
필수

The dispute fee charged to the account, in the currency it was collected in. null when fee_charged is false.

fee_charged
boolean
필수

Whether Whop charged the account a dispute fee for this one. false when the payment was fully refunded before the dispute was opened, for a Visa RDR resolution, and for an inquiry.

예시:

true

id
string
필수

Dispute ID, prefixed dspt_.

예시:

"dspt_xxxxxxxxxxxxxx"

inquiry
boolean
필수

Whether this is a pre-dispute inquiry rather than a formal chargeback. Inquiries follow the same lifecycle but move no funds unless one escalates.

예시:

false

issuer_comments
object[]
필수
line_items
object[]
필수
payment
object
필수

The payment being disputed.

product_id
string | null
필수

The product the disputed payment was for, prefixed prod_.

예시:

"prod_xxxxxxxxxxxxxx"

reason
enum<string>
필수

Why the customer says they are disputing, normalized across processors and card networks. other covers a processor reason Whop has not categorized yet.

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

"other"

reason_code
string | null
필수

The raw card-network or processor reason code, such as 10.4. Informational only — reason is not derived from it.

예시:

"13.1"

status
enum<string>
필수

needs_response awaits evidence (after a processor refused a filing, submission_failure_reason says why); generating_response has evidence with the processor, not yet accepted; under_review is with the processor; won/lost are the rulings; prevented settles like lost. warning_ statuses are the inquiry tiers. Past evidence_due_at an open one reports under_review.

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

"needs_response"

submission_failure_reason
string | null
필수

Why the payment processor refused the last filing, in plain English, while the dispute is back in needs_response. Fix what it names and submit again. Only on retrieve: dispute.updated reports the move back to needs_response, then read this here.

예시:

null

updated_at
string
필수

When the dispute was last changed, as an ISO 8601 timestamp.

예시:

"2026-01-01T12:00:00.000Z"

variant_id
string | null
필수

The variant the disputed payment was made on, prefixed plan_.

예시:

"plan_xxxxxxxxxxxxxx"