v1

latestOpenAPI 3.0.0Proprietary2026-07-1313647393.0 KB

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

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