Submit Dispute
Sends the dispute’s evidence packet to the payment processor and moves the dispute to under_review. This is final — the packet cannot be edited or resent afterwards.
Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
Pins the request to a dated API version.
"2026-07-25"
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Path Parameters
The dispute ID (dspt_ tag).
Response
dispute submitted
The account the dispute was filed against, prefixed biz_.
The disputed amount, in whole units of currency.
The customer who filed the dispute.
When the dispute was opened, as an ISO 8601 timestamp.
Three-letter ISO currency code of the disputed amount.
The evidence packet sent to the processor to contest the dispute.
The deadline to submit evidence, as an ISO 8601 timestamp. Whop reserves the last 24 hours before the processor's own cutoff to forward the submission.
Whether evidence can still be changed and submitted.
Why evidence can no longer be edited. null while evidence_editable is true.
submitted, response_window_closed, not_contestable, null "submitted"
When the evidence was submitted to the processor, as an ISO 8601 timestamp.
Dispute ID, prefixed dspt_.
Whether this is a pre-dispute inquiry rather than a formal chargeback. Inquiries follow the same lifecycle but move no funds unless one escalates.
The payment being disputed.
The plan the disputed payment was made on, prefixed plan_.
The product the disputed payment was for, prefixed prod_.
Whether Visa Rapid Dispute Resolution settled this automatically. These refund the customer without an evidence round.
Why the customer says they are disputing, normalized across card networks. other covers a code Whop has not categorized yet — read reason_code for the raw value.
fraudulent, unrecognized, declined_authorization, product_not_received, product_unacceptable, subscription_canceled, credit_not_processed, duplicate, processing_error, documentation_request, bank_cannot_process, other "fraudulent"
The raw card-network or processor reason code, such as 10.4.
Where the dispute stands. needs_response is awaiting evidence, under_review is with the processor, won returned the funds to the seller, lost returned them to the customer, and closed ended without a ruling.
needs_response, under_review, won, lost, closed "needs_response"
When the dispute was last changed, as an ISO 8601 timestamp.

