Skip to main content
PATCH
TypeScript

Autorisations

Authorization
string
header
requis

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

En-têtes

Api-Version-Date
string

Pins the request to a dated API version.

Exemple:

"2026-11-17"

Paramètres de chemin

id
string
requis

The dispute ID (dspt_ tag).

Corps

evidence
object

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

Réponse

dispute updated

acceptable
boolean
requis

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.

Exemple:

true

account_id
string | null
requis

The account the dispute was filed against, prefixed biz_.

Exemple:

"biz_xxxxxxxxxxxxxx"

amount
number
requis

The disputed amount, in whole units of currency.

Exemple:

150

buyer
object
requis

The customer who filed the dispute.

created_at
string
requis

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

Exemple:

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

currency
string
requis

Three-letter ISO currency code of the disputed amount.

Exemple:

"usd"

evidence
object
requis

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

evidence_due_at
string | null
requis

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.

Exemple:

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

evidence_editable
boolean
requis

Whether evidence can still be changed and submitted.

Exemple:

true

evidence_locked_reason
enum<string> | null
requis

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

Options disponibles:
submitted,
response_window_closed,
not_contestable,
null
Exemple:

"submitted"

evidence_submitted_at
string | null
requis

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

Exemple:

null

fee
object | null
requis

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

fee_charged
boolean
requis

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.

Exemple:

true

id
string
requis

Dispute ID, prefixed dspt_.

Exemple:

"dspt_xxxxxxxxxxxxxx"

inquiry
boolean
requis

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

Exemple:

false

issuer_comments
object[]
requis
line_items
object[]
requis
payment
object
requis

The payment being disputed.

product_id
string | null
requis

The product the disputed payment was for, prefixed prod_.

Exemple:

"prod_xxxxxxxxxxxxxx"

reason
enum<string>
requis

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

Options disponibles:
fraudulent,
unrecognized,
declined_authorization,
product_not_received,
product_unacceptable,
subscription_canceled,
credit_not_processed,
duplicate,
processing_error,
documentation_request,
bank_cannot_process,
other
Exemple:

"other"

reason_code
string | null
requis

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

Exemple:

"13.1"

status
enum<string>
requis

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.

Options disponibles:
needs_response,
warning_needs_response,
under_review,
warning_under_review,
generating_response,
won,
lost,
prevented,
warning_closed
Exemple:

"needs_response"

submission_failure_reason
string | null
requis

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.

Exemple:

null

updated_at
string
requis

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

Exemple:

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

variant_id
string | null
requis

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

Exemple:

"plan_xxxxxxxxxxxxxx"