Bills3

Customers4

Disputes4

Documents3

Instant Settlements3

Invoices8

Items5

Linked Accounts8

Orders5

Partner Accounts1

Partner Documents4

Partner Stakeholders1

Partner Webhooks5

Payment Downtimes2

Payment Links6

Payments4

Plans3

QR Codes6

Refunds6

Settlements3

Subscriptions10

Transfers8

Virtual Accounts10

X Account Validation3

X Banking Balances1

X Contacts4

X Fund Accounts4

X Payout Links4

X Payouts6

X Transactions2

Disputes

Contest a dispute

Submit evidence to challenge a dispute. Use action=draft to save without submitting, or action=submit to send for bank review (triggers payment.dispute.under_review webhook). At least one evidence document is required when submitting. You can contest partial amounts by specifying amount.

patch/disputes/{id}/contest

Request

Base URL
https://api.razorpay.com/v1
Auth
- HTTP basic
- or OAuth 2
  Authorization codehttps://mcp.razorpay.com/authorize
  Client credentials
  Token URLhttps://mcp.razorpay.com/token
  Scopesread_only
TypeScript
https://skmtc.dev/razorpay/apis/razorpay-api/docs/disputes/:id/contest/patch.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Dispute ID (disp_*).

Request body

action'draft' | 'submit'

draft: save evidence without submitting. submit: send for bank review. Minimum one document required for submit.

amountinteger

Amount being contested (paise). Defaults to full dispute amount.

summarystring

Your explanation of why the dispute should be resolved in your favour. Max 1000 characters.

shipping_proofstring[]

Document IDs proving product shipment.

billing_proofstring[]

cancellation_proofstring[]

customer_communicationstring[]

proof_of_servicestring[]

explanation_letterstring[]

refund_confirmationstring[]

access_activity_logstring[]

refund_cancellation_policystring[]

term_and_conditionsstring[]

othersobject[]

Response

Dispute contested. Status changes to 'under_review' on submit.

idstring

Unique dispute identifier. Prefix: disp_

entity'dispute'

payment_idstring

The payment against which the dispute was raised (pay_*).

amountinteger

Disputed amount in currency subunits.

currencystring

amount_deductedinteger

Amount deducted from your balance when dispute is lost.

reason_codestring

Code identifying the dispute reason.

reason_descriptionstring

Human-readable explanation of the dispute cause.

respond_byinteger

Unix timestamp by which you must respond. Missing this forfeits the dispute.

status'open' | 'under_review' | 'won' | 'lost' | 'closed'

open: action required. under_review: evidence submitted, awaiting bank decision. won: resolved in your favour. lost: resolved against you. closed: resolved without chargeback.

phase'fraud' | 'retrieval' | 'chargeback' | 'pre_arbitration' | 'arbitration'

Escalation stage of the dispute process.

created_atinteger

Changes

No recorded changes to this operation across all 1 revision of this API.