Skip to main content
PATCH
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"

경로 매개변수

id
string
필수

The dispute ID (dspt_ tag).

본문

evidence
object

The evidence packet to send to the processor. Only the fields you provide are changed.

응답

dispute updated

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"