Contest a Dispute

// This sample code is for drafting a dispute.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X PATCH https://api.razorpay.com/v1/disputes/disp_AHfqOvkldwsbqt/contest \
-H "Content-Type: application/json"
-d'{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
}'

// This sample code is for submitting a dispute.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X PATCH https://api.razorpay.com/v1/disputes/disp_AHfqOvkldwsbqt/contest \
-H "Content-Type: application/json"
-d'{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
}'

// This sample code is for drafting a dispute.

RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String disputeId = "disp_0000000000000";

JSONObject disputeRequest = new JSONObject();
disputeRequest.put("amount",5000);
disputeRequest.put("summary","goods delivered");
List<Object> shipping_proof = new ArrayList<>();
shipping_proof.add("doc_EFtmUsbwpXwBH9")
shipping_proof.add("doc_EFtmUsbwpXwBH8")
disputeRequest.put("shipping_proof", shipping_proof);
List<Object> others = new ArrayList<>();
JSONObject otherParam = new JSONObject();
otherParam.put("type","receipt_signed_by_customer");
List<Object> doc = new ArrayList<>();
doc.add("doc_EFtmUsbwpXwBH1");
doc.add("doc_EFtmUsbwpXwBH7");
otherParam.put("document_ids",doc);
others.add(otherParam)
disputeRequest.put("others", others);
disputeRequest.put("action", "submit");

Dispute dispute = instance.dispute.contest(disputeId, disputeRequest)

// This sample code is for submitting a dispute.

RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String disputeId = "disp_0000000000000";

JSONObject disputeRequest = new JSONObject();
List<Object> billing_proof = new ArrayList<>();
billing_proof.add("doc_EFtmUsbwpXwBH9")
billing_proof.add("doc_EFtmUsbwpXwBH8")
disputeRequest.put("billing_proof", billing_proof);
disputeRequest.put("action", "submit");

Dispute dispute = instance.dispute.contest(disputeId, disputeRequest)

// This sample code is for drafting a dispute.

import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

disputeId = "disp_0000000000000";

client.dispute.contest(disputeId,{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for submitting a dispute.

import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

client.dispute.contest(disputeId,{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for drafting a dispute.

$api = new Api($key_id, $secret);

$disputeId = "disp_0000000000000";

$api->dispute->fetch($disputeId)->contest(array("amount" => 5000, "summary" => "goods delivered", "shipping_proof" => array("doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"), "others" => array(array("type" => "receipt_signed_by_customer", "document_ids" => array("doc_EFtmUsbwpXwBH1", "doc_EFtmUsbwpXwBH7"))), "action" => "draft"));

// This sample code is for submitting a dispute.

$api = new Api($key_id, $secret);

$api->dispute->fetch($disputeId)->contest(array("billing_proof" => array("doc_EFtmUsbwpXwBG9", "doc_EFtmUsbwpXwBG8"), "action" => "submit"));

// This sample code is for drafting a dispute.

RazorpayClient client = new RazorpayClient(your_key_id, your_secret);

String disputeId = "disp_0000000000000";

Dictionary<string, object> disputeRequest = new Dictionary<string, object>();
disputeRequest.Add("amount",5000);
disputeRequest.Add("summary","goods delivered");
List<string> shipping_proof = new List<string>();
shipping_proof.Add("doc_EFtmUsbwpXwBH9");
shipping_proof.Add("doc_EFtmUsbwpXwBH8");
disputeRequest.Add("shipping_proof", shipping_proof);
List<Dictionary<string, object>> others = new List<Dictionary<string, object>>();
Dictionary<string, object> otherParam = new Dictionary<string, object>();
otherParam.Add("type","receipt_signed_by_customer");
List<string> doc = new List<string>();
doc.Add("doc_EFtmUsbwpXwBH1");
doc.Add("doc_EFtmUsbwpXwBH7");
otherParam.Add("document_ids",doc);
others.Add(otherParam);
disputeRequest.Add("others", others);
disputeRequest.Add("action", "submit");

Dispute dispute = client.Dispute.Fetch(disputeId).Contest(disputeRequest);

// This sample code is for submitting a dispute.

RazorpayClient client = new RazorpayClient(your_key_id, your_secret);

String disputeId = "disp_0000000000000";

Dictionary<string, object> disputeRequest = new Dictionary<string, object>();
List<string> billing_proof = new List<string>();
billing_proof.Add("doc_EFtmUsbwpXwBH9");
billing_proof.Add("doc_EFtmUsbwpXwBH8");
disputeRequest.Add("billing_proof", billing_proof);
disputeRequest.Add("action", "submit");

Dispute dispute = client.Dispute.Fetch(disputeId).Contest(disputeRequest);

// This sample code is for drafting a dispute.

require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

disputeId = "disp_0000000000000"

Razorpay::Dispute.contest(disputeId,{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for submitting a dispute.

require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

disputeId = "disp_0000000000000"

Razorpay::Dispute.contest(disputeId, {
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for drafting a dispute.

var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

var disputeId = "disp_0000000000000";

instance.disputes.contest(disputeId,{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for submitting a dispute.

var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

instance.disputes.contest(disputeId, {
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for drafting a dispute.

import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

disputeId := "disp_0000000000000";

shipping_proof := [2]string{"doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"}
doc := [2]string{"doc_EFtmUsbwpXwBH1", "doc_EFtmUsbwpXwBH7"}

other := make(map[string]interface{})
other["0"] = map[string]interface{}{
  "type":         "receipt_signed_by_customer",
  "document_ids": doc,
}

params := map[string]interface{}{
  "amount":         5000,
  "summary":        "goods delivered",
  "shipping_proof": shipping_proof,
  "others":         other,
  "action":         "draft",
}

body, err := client.Dispute.Contest(disputeId, params, nil)

// This sample code is for submitting a dispute.

import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

billing_proof := [2]string{"doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"}

params := map[string]interface{}{
  "billing_proof": billing_proof,
  "action":         "submit",
}

body, err := client.Dispute.Contest(disputeId, params, nil)

// This sample code is for drafting a dispute.

razorpay disputes contest disp_AHfqOvkldwsbqt \
  --amount 5000 \
  --summary "goods delivered" \
  --shipping-proof doc_EFtmUsbwpXwBH9 \
  --shipping-proof doc_EFtmUsbwpXwBH8 \ 
  --term-and-conditions doc_TnC001 \ 
  --others '[
    {"type":"receipt_signed_by_customer","document_ids":["doc_EFtmUsbwpXwBH1","doc_EFtmUsbwpXwBH7"]},
    {"type":"delivery_confirmation","document_ids":["doc_DEL001"]} 
  ]' \
  --action draft

// This sample code is for submitting a dispute.

razorpay disputes contest disp_AHfqOvkldwsbqt \
    --billing-proof doc_EFtmUsbwpXwBG9 \
    --billing-proof doc_EFtmUsbwpXwBG8 \
    --action submit

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "USD",
  "amount_deducted": 0,
  "reason_code": "chargeback",
  "respond_by": 1590604200,
  "status": "open",
  "phase": "chargeback",
  "created_at": 1590059211,
  "evidence": {
    "amount": 5000,
    "summary": "goods delivered",
    "shipping_proof": [
      "doc_EFtmUsbwpXwBH9",
      "doc_EFtmUsbwpXwBH8"
    ],
    "billing_proof": null,
    "cancellation_proof": null,
    "customer_communication": null,
    "proof_of_service": null,
    "explanation_letter": null,
    "refund_confirmation": null,
    "access_activity_log": null,
    "refund_cancellation_policy": null,
    "term_and_conditions": null,
    "others": [
      {
        "type": "receipt_signed_by_customer",
        "document_ids": [
          "doc_EFtmUsbwpXwBH1",
          "doc_EFtmUsbwpXwBH7"
        ]
      }
    ],
    "submitted_at": null
  }
}

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "INR",
  "amount_deducted": 0,
  "reason_code": "chargeback",
  "respond_by": 1590604200,
  "status": "under_review",
  "phase": "chargeback",
  "created_at": 1590059211,
  "evidence": {
    "amount": 5000,
    "summary": "goods delivered",
    "shipping_proof": [
      "doc_EFtmUsbwpXwBH9",
      "doc_EFtmUsbwpXwBH8"
    ],
    "billing_proof": [
      "doc_EFtmUsbwpXwBG9",
      "doc_EFtmUsbwpXwBG8"
    ],
    "cancellation_proof": null,
    "customer_communication": null,
    "proof_of_service": null,
    "explanation_letter": null,
    "refund_confirmation": null,
    "access_activity_log": null,
    "refund_cancellation_policy": null,
    "term_and_conditions": null,
    "others": [
      {
        "type": "receipt_signed_by_customer",
        "document_ids": [
          "doc_EFtmUsbwpXwBH1",
          "doc_EFtmUsbwpXwBH7"
        ]
      }
    ],
    "submitted_at": 1590603200
  }
}

{
  "error":{
    "code":"BAD_REQUEST_ERROR",
    "description":"The id provided does not exist",
    "source":"business",
    "step":"payment_initiation",
    "reason":"input_validation_failed",
    "metadata":{

    }
  }
}

PATCH

disputes

:id

contest

// This sample code is for drafting a dispute.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X PATCH https://api.razorpay.com/v1/disputes/disp_AHfqOvkldwsbqt/contest \
-H "Content-Type: application/json"
-d'{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
}'

// This sample code is for submitting a dispute.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X PATCH https://api.razorpay.com/v1/disputes/disp_AHfqOvkldwsbqt/contest \
-H "Content-Type: application/json"
-d'{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
}'

// This sample code is for drafting a dispute.

RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String disputeId = "disp_0000000000000";

JSONObject disputeRequest = new JSONObject();
disputeRequest.put("amount",5000);
disputeRequest.put("summary","goods delivered");
List<Object> shipping_proof = new ArrayList<>();
shipping_proof.add("doc_EFtmUsbwpXwBH9")
shipping_proof.add("doc_EFtmUsbwpXwBH8")
disputeRequest.put("shipping_proof", shipping_proof);
List<Object> others = new ArrayList<>();
JSONObject otherParam = new JSONObject();
otherParam.put("type","receipt_signed_by_customer");
List<Object> doc = new ArrayList<>();
doc.add("doc_EFtmUsbwpXwBH1");
doc.add("doc_EFtmUsbwpXwBH7");
otherParam.put("document_ids",doc);
others.add(otherParam)
disputeRequest.put("others", others);
disputeRequest.put("action", "submit");

Dispute dispute = instance.dispute.contest(disputeId, disputeRequest)

// This sample code is for submitting a dispute.

RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String disputeId = "disp_0000000000000";

JSONObject disputeRequest = new JSONObject();
List<Object> billing_proof = new ArrayList<>();
billing_proof.add("doc_EFtmUsbwpXwBH9")
billing_proof.add("doc_EFtmUsbwpXwBH8")
disputeRequest.put("billing_proof", billing_proof);
disputeRequest.put("action", "submit");

Dispute dispute = instance.dispute.contest(disputeId, disputeRequest)

// This sample code is for drafting a dispute.

import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

disputeId = "disp_0000000000000";

client.dispute.contest(disputeId,{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for submitting a dispute.

import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

client.dispute.contest(disputeId,{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for drafting a dispute.

$api = new Api($key_id, $secret);

$disputeId = "disp_0000000000000";

$api->dispute->fetch($disputeId)->contest(array("amount" => 5000, "summary" => "goods delivered", "shipping_proof" => array("doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"), "others" => array(array("type" => "receipt_signed_by_customer", "document_ids" => array("doc_EFtmUsbwpXwBH1", "doc_EFtmUsbwpXwBH7"))), "action" => "draft"));

// This sample code is for submitting a dispute.

$api = new Api($key_id, $secret);

$api->dispute->fetch($disputeId)->contest(array("billing_proof" => array("doc_EFtmUsbwpXwBG9", "doc_EFtmUsbwpXwBG8"), "action" => "submit"));

// This sample code is for drafting a dispute.

RazorpayClient client = new RazorpayClient(your_key_id, your_secret);

String disputeId = "disp_0000000000000";

Dictionary<string, object> disputeRequest = new Dictionary<string, object>();
disputeRequest.Add("amount",5000);
disputeRequest.Add("summary","goods delivered");
List<string> shipping_proof = new List<string>();
shipping_proof.Add("doc_EFtmUsbwpXwBH9");
shipping_proof.Add("doc_EFtmUsbwpXwBH8");
disputeRequest.Add("shipping_proof", shipping_proof);
List<Dictionary<string, object>> others = new List<Dictionary<string, object>>();
Dictionary<string, object> otherParam = new Dictionary<string, object>();
otherParam.Add("type","receipt_signed_by_customer");
List<string> doc = new List<string>();
doc.Add("doc_EFtmUsbwpXwBH1");
doc.Add("doc_EFtmUsbwpXwBH7");
otherParam.Add("document_ids",doc);
others.Add(otherParam);
disputeRequest.Add("others", others);
disputeRequest.Add("action", "submit");

Dispute dispute = client.Dispute.Fetch(disputeId).Contest(disputeRequest);

// This sample code is for submitting a dispute.

RazorpayClient client = new RazorpayClient(your_key_id, your_secret);

String disputeId = "disp_0000000000000";

Dictionary<string, object> disputeRequest = new Dictionary<string, object>();
List<string> billing_proof = new List<string>();
billing_proof.Add("doc_EFtmUsbwpXwBH9");
billing_proof.Add("doc_EFtmUsbwpXwBH8");
disputeRequest.Add("billing_proof", billing_proof);
disputeRequest.Add("action", "submit");

Dispute dispute = client.Dispute.Fetch(disputeId).Contest(disputeRequest);

// This sample code is for drafting a dispute.

require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

disputeId = "disp_0000000000000"

Razorpay::Dispute.contest(disputeId,{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for submitting a dispute.

require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

disputeId = "disp_0000000000000"

Razorpay::Dispute.contest(disputeId, {
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for drafting a dispute.

var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

var disputeId = "disp_0000000000000";

instance.disputes.contest(disputeId,{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for submitting a dispute.

var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

instance.disputes.contest(disputeId, {
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for drafting a dispute.

import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

disputeId := "disp_0000000000000";

shipping_proof := [2]string{"doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"}
doc := [2]string{"doc_EFtmUsbwpXwBH1", "doc_EFtmUsbwpXwBH7"}

other := make(map[string]interface{})
other["0"] = map[string]interface{}{
  "type":         "receipt_signed_by_customer",
  "document_ids": doc,
}

params := map[string]interface{}{
  "amount":         5000,
  "summary":        "goods delivered",
  "shipping_proof": shipping_proof,
  "others":         other,
  "action":         "draft",
}

body, err := client.Dispute.Contest(disputeId, params, nil)

// This sample code is for submitting a dispute.

import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

billing_proof := [2]string{"doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"}

params := map[string]interface{}{
  "billing_proof": billing_proof,
  "action":         "submit",
}

body, err := client.Dispute.Contest(disputeId, params, nil)

// This sample code is for drafting a dispute.

razorpay disputes contest disp_AHfqOvkldwsbqt \
  --amount 5000 \
  --summary "goods delivered" \
  --shipping-proof doc_EFtmUsbwpXwBH9 \
  --shipping-proof doc_EFtmUsbwpXwBH8 \ 
  --term-and-conditions doc_TnC001 \ 
  --others '[
    {"type":"receipt_signed_by_customer","document_ids":["doc_EFtmUsbwpXwBH1","doc_EFtmUsbwpXwBH7"]},
    {"type":"delivery_confirmation","document_ids":["doc_DEL001"]} 
  ]' \
  --action draft

// This sample code is for submitting a dispute.

razorpay disputes contest disp_AHfqOvkldwsbqt \
    --billing-proof doc_EFtmUsbwpXwBG9 \
    --billing-proof doc_EFtmUsbwpXwBG8 \
    --action submit

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "USD",
  "amount_deducted": 0,
  "reason_code": "chargeback",
  "respond_by": 1590604200,
  "status": "open",
  "phase": "chargeback",
  "created_at": 1590059211,
  "evidence": {
    "amount": 5000,
    "summary": "goods delivered",
    "shipping_proof": [
      "doc_EFtmUsbwpXwBH9",
      "doc_EFtmUsbwpXwBH8"
    ],
    "billing_proof": null,
    "cancellation_proof": null,
    "customer_communication": null,
    "proof_of_service": null,
    "explanation_letter": null,
    "refund_confirmation": null,
    "access_activity_log": null,
    "refund_cancellation_policy": null,
    "term_and_conditions": null,
    "others": [
      {
        "type": "receipt_signed_by_customer",
        "document_ids": [
          "doc_EFtmUsbwpXwBH1",
          "doc_EFtmUsbwpXwBH7"
        ]
      }
    ],
    "submitted_at": null
  }
}

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "INR",
  "amount_deducted": 0,
  "reason_code": "chargeback",
  "respond_by": 1590604200,
  "status": "under_review",
  "phase": "chargeback",
  "created_at": 1590059211,
  "evidence": {
    "amount": 5000,
    "summary": "goods delivered",
    "shipping_proof": [
      "doc_EFtmUsbwpXwBH9",
      "doc_EFtmUsbwpXwBH8"
    ],
    "billing_proof": [
      "doc_EFtmUsbwpXwBG9",
      "doc_EFtmUsbwpXwBG8"
    ],
    "cancellation_proof": null,
    "customer_communication": null,
    "proof_of_service": null,
    "explanation_letter": null,
    "refund_confirmation": null,
    "access_activity_log": null,
    "refund_cancellation_policy": null,
    "term_and_conditions": null,
    "others": [
      {
        "type": "receipt_signed_by_customer",
        "document_ids": [
          "doc_EFtmUsbwpXwBH1",
          "doc_EFtmUsbwpXwBH7"
        ]
      }
    ],
    "submitted_at": 1590603200
  }
}

{
  "error":{
    "code":"BAD_REQUEST_ERROR",
    "description":"The id provided does not exist",
    "source":"business",
    "step":"payment_initiation",
    "reason":"input_validation_failed",
    "metadata":{

    }
  }
}

Available in🇮🇳 India🇺🇸 United States

Use this endpoint to contest a dispute, indicating that you would like to challenge the dispute raised against a payment. In addition to explicitly contesting a dispute, the contest process can also be triggered by:

Attaching an evidence document using Documents API with having a purpose set to dispute_evidence.
Providing the evidence in textual format.
Specifying the contest amount (partial or full). The default choice is contesting the full amount if it is not specifically mentioned.
Ensure you pass the action parameter as submit to confirm the contest of the dispute. Dispute evidence draft does not get auto-submitted.
Ensure you provide a minimum of one document for contesting a dispute. Add as many relevant documents as possible to maximise the chances of dispute resolution in your favor.

// This sample code is for drafting a dispute.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X PATCH https://api.razorpay.com/v1/disputes/disp_AHfqOvkldwsbqt/contest \
-H "Content-Type: application/json"
-d'{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
}'

// This sample code is for submitting a dispute.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-X PATCH https://api.razorpay.com/v1/disputes/disp_AHfqOvkldwsbqt/contest \
-H "Content-Type: application/json"
-d'{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
}'

// This sample code is for drafting a dispute.

RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String disputeId = "disp_0000000000000";

JSONObject disputeRequest = new JSONObject();
disputeRequest.put("amount",5000);
disputeRequest.put("summary","goods delivered");
List<Object> shipping_proof = new ArrayList<>();
shipping_proof.add("doc_EFtmUsbwpXwBH9")
shipping_proof.add("doc_EFtmUsbwpXwBH8")
disputeRequest.put("shipping_proof", shipping_proof);
List<Object> others = new ArrayList<>();
JSONObject otherParam = new JSONObject();
otherParam.put("type","receipt_signed_by_customer");
List<Object> doc = new ArrayList<>();
doc.add("doc_EFtmUsbwpXwBH1");
doc.add("doc_EFtmUsbwpXwBH7");
otherParam.put("document_ids",doc);
others.add(otherParam)
disputeRequest.put("others", others);
disputeRequest.put("action", "submit");

Dispute dispute = instance.dispute.contest(disputeId, disputeRequest)

// This sample code is for submitting a dispute.

RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String disputeId = "disp_0000000000000";

JSONObject disputeRequest = new JSONObject();
List<Object> billing_proof = new ArrayList<>();
billing_proof.add("doc_EFtmUsbwpXwBH9")
billing_proof.add("doc_EFtmUsbwpXwBH8")
disputeRequest.put("billing_proof", billing_proof);
disputeRequest.put("action", "submit");

Dispute dispute = instance.dispute.contest(disputeId, disputeRequest)

// This sample code is for drafting a dispute.

import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

disputeId = "disp_0000000000000";

client.dispute.contest(disputeId,{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for submitting a dispute.

import razorpay
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

client.dispute.contest(disputeId,{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for drafting a dispute.

$api = new Api($key_id, $secret);

$disputeId = "disp_0000000000000";

$api->dispute->fetch($disputeId)->contest(array("amount" => 5000, "summary" => "goods delivered", "shipping_proof" => array("doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"), "others" => array(array("type" => "receipt_signed_by_customer", "document_ids" => array("doc_EFtmUsbwpXwBH1", "doc_EFtmUsbwpXwBH7"))), "action" => "draft"));

// This sample code is for submitting a dispute.

$api = new Api($key_id, $secret);

$api->dispute->fetch($disputeId)->contest(array("billing_proof" => array("doc_EFtmUsbwpXwBG9", "doc_EFtmUsbwpXwBG8"), "action" => "submit"));

// This sample code is for drafting a dispute.

RazorpayClient client = new RazorpayClient(your_key_id, your_secret);

String disputeId = "disp_0000000000000";

Dictionary<string, object> disputeRequest = new Dictionary<string, object>();
disputeRequest.Add("amount",5000);
disputeRequest.Add("summary","goods delivered");
List<string> shipping_proof = new List<string>();
shipping_proof.Add("doc_EFtmUsbwpXwBH9");
shipping_proof.Add("doc_EFtmUsbwpXwBH8");
disputeRequest.Add("shipping_proof", shipping_proof);
List<Dictionary<string, object>> others = new List<Dictionary<string, object>>();
Dictionary<string, object> otherParam = new Dictionary<string, object>();
otherParam.Add("type","receipt_signed_by_customer");
List<string> doc = new List<string>();
doc.Add("doc_EFtmUsbwpXwBH1");
doc.Add("doc_EFtmUsbwpXwBH7");
otherParam.Add("document_ids",doc);
others.Add(otherParam);
disputeRequest.Add("others", others);
disputeRequest.Add("action", "submit");

Dispute dispute = client.Dispute.Fetch(disputeId).Contest(disputeRequest);

// This sample code is for submitting a dispute.

RazorpayClient client = new RazorpayClient(your_key_id, your_secret);

String disputeId = "disp_0000000000000";

Dictionary<string, object> disputeRequest = new Dictionary<string, object>();
List<string> billing_proof = new List<string>();
billing_proof.Add("doc_EFtmUsbwpXwBH9");
billing_proof.Add("doc_EFtmUsbwpXwBH8");
disputeRequest.Add("billing_proof", billing_proof);
disputeRequest.Add("action", "submit");

Dispute dispute = client.Dispute.Fetch(disputeId).Contest(disputeRequest);

// This sample code is for drafting a dispute.

require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

disputeId = "disp_0000000000000"

Razorpay::Dispute.contest(disputeId,{
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for submitting a dispute.

require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

disputeId = "disp_0000000000000"

Razorpay::Dispute.contest(disputeId, {
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for drafting a dispute.

var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

var disputeId = "disp_0000000000000";

instance.disputes.contest(disputeId,{
  "billing_proof": [
    "doc_EFtmUsbwpXwBG9",
    "doc_EFtmUsbwpXwBG8"
  ],
  "action": "submit"
})

// This sample code is for submitting a dispute.

var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

instance.disputes.contest(disputeId, {
  "amount": 5000,
  "summary": "goods delivered",
  "shipping_proof": [
    "doc_EFtmUsbwpXwBH9",
    "doc_EFtmUsbwpXwBH8"
  ],
  "others": [
    {
      "type": "receipt_signed_by_customer",
      "document_ids": [
        "doc_EFtmUsbwpXwBH1",
        "doc_EFtmUsbwpXwBH7"
      ]
    }
  ],
  "action": "draft"
})

// This sample code is for drafting a dispute.

import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

disputeId := "disp_0000000000000";

shipping_proof := [2]string{"doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"}
doc := [2]string{"doc_EFtmUsbwpXwBH1", "doc_EFtmUsbwpXwBH7"}

other := make(map[string]interface{})
other["0"] = map[string]interface{}{
  "type":         "receipt_signed_by_customer",
  "document_ids": doc,
}

params := map[string]interface{}{
  "amount":         5000,
  "summary":        "goods delivered",
  "shipping_proof": shipping_proof,
  "others":         other,
  "action":         "draft",
}

body, err := client.Dispute.Contest(disputeId, params, nil)

// This sample code is for submitting a dispute.

import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

billing_proof := [2]string{"doc_EFtmUsbwpXwBH9", "doc_EFtmUsbwpXwBH8"}

params := map[string]interface{}{
  "billing_proof": billing_proof,
  "action":         "submit",
}

body, err := client.Dispute.Contest(disputeId, params, nil)

// This sample code is for drafting a dispute.

razorpay disputes contest disp_AHfqOvkldwsbqt \
  --amount 5000 \
  --summary "goods delivered" \
  --shipping-proof doc_EFtmUsbwpXwBH9 \
  --shipping-proof doc_EFtmUsbwpXwBH8 \ 
  --term-and-conditions doc_TnC001 \ 
  --others '[
    {"type":"receipt_signed_by_customer","document_ids":["doc_EFtmUsbwpXwBH1","doc_EFtmUsbwpXwBH7"]},
    {"type":"delivery_confirmation","document_ids":["doc_DEL001"]} 
  ]' \
  --action draft

// This sample code is for submitting a dispute.

razorpay disputes contest disp_AHfqOvkldwsbqt \
    --billing-proof doc_EFtmUsbwpXwBG9 \
    --billing-proof doc_EFtmUsbwpXwBG8 \
    --action submit

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "USD",
  "amount_deducted": 0,
  "reason_code": "chargeback",
  "respond_by": 1590604200,
  "status": "open",
  "phase": "chargeback",
  "created_at": 1590059211,
  "evidence": {
    "amount": 5000,
    "summary": "goods delivered",
    "shipping_proof": [
      "doc_EFtmUsbwpXwBH9",
      "doc_EFtmUsbwpXwBH8"
    ],
    "billing_proof": null,
    "cancellation_proof": null,
    "customer_communication": null,
    "proof_of_service": null,
    "explanation_letter": null,
    "refund_confirmation": null,
    "access_activity_log": null,
    "refund_cancellation_policy": null,
    "term_and_conditions": null,
    "others": [
      {
        "type": "receipt_signed_by_customer",
        "document_ids": [
          "doc_EFtmUsbwpXwBH1",
          "doc_EFtmUsbwpXwBH7"
        ]
      }
    ],
    "submitted_at": null
  }
}

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "INR",
  "amount_deducted": 0,
  "reason_code": "chargeback",
  "respond_by": 1590604200,
  "status": "under_review",
  "phase": "chargeback",
  "created_at": 1590059211,
  "evidence": {
    "amount": 5000,
    "summary": "goods delivered",
    "shipping_proof": [
      "doc_EFtmUsbwpXwBH9",
      "doc_EFtmUsbwpXwBH8"
    ],
    "billing_proof": [
      "doc_EFtmUsbwpXwBG9",
      "doc_EFtmUsbwpXwBG8"
    ],
    "cancellation_proof": null,
    "customer_communication": null,
    "proof_of_service": null,
    "explanation_letter": null,
    "refund_confirmation": null,
    "access_activity_log": null,
    "refund_cancellation_policy": null,
    "term_and_conditions": null,
    "others": [
      {
        "type": "receipt_signed_by_customer",
        "document_ids": [
          "doc_EFtmUsbwpXwBH1",
          "doc_EFtmUsbwpXwBH7"
        ]
      }
    ],
    "submitted_at": 1590603200
  }
}

{
  "error":{
    "code":"BAD_REQUEST_ERROR",
    "description":"The id provided does not exist",
    "source":"business",
    "step":"payment_initiation",
    "reason":"input_validation_failed",
    "metadata":{

    }
  }
}

Path Parameters

string

required

The unique identifier of the dispute.

Request Parameters

integer

The amount being contested. If the contest amount is not mentioned, we will assume it to be a full dispute contest.

string

The explanation provided by you for contesting the dispute. It can have a maximum length of 1000 characters.

list

List of document ids which serves as proof that the product was shipped to the customer at their provided address. It should show their complete shipping address, if possible.

list

List of document ids which serves as proof of order confirmation, such as a receipt.

list

List of document ids that serves as proof that this product/service was cancelled.

list

List of document ids listing any written/email communication from the customer confirming that the customer received the product/service or is satisfied with the product/service.

list

List of document ids showing proof of service provided to the customer.

list

(List of document ids) Any letter(s) from you specifying information pertinent to the dispute/payment that needs to be considered for processing the dispute.

list

List of document ids showing proof that the refund was provided to the customer.

list

List of document ids of any server or activity logs which prove that the customer accessed or downloaded the purchased digital product.

list

List of document ids listing your refund and/or cancellation policy, as shown to the customer.

list

List of document ids listing your sales terms and conditions, as shown to the customer.

list

Specifies the evidence documents to be uploaded as a part of contesting a dispute. It is a list of tuples consisting of the following:

string

Describes the custom type of evidence document(s) provided.

list

List of document ids corresponding to the customer evidence type.

Example

[
  {
    "type": "receipt_signed_by_customer",
    "document_ids": [
      "doc_EFtmUsbwpXwBH7",
      "doc_EFtmUsbwpXwBH6"
    ]
  }  
]

string

The action to be taken for this contest. Possible values:

draft: Allows you to contest the dispute by updating the dispute entity. This action does not submit the dispute yet. The absence of the key action or a corresponding value would default the action to draft.
submit: Allows you to contest the dispute by updating the dispute entity and submitting the same to Razorpay. You need to provide a minimum of one document id (across any of the evidence object attributes) for a successful submission:
- Submitting for review would change the status of your dispute from open to under_review.
- It triggers the webhook event payment.dispute.under_review.

Add as many relevant documents as possible to maximise the chances of dispute resolution in your favour.

Response Parameters

string

The unique identifier of the dispute generated by Razorpay. For example, disp_AHfqOvkldwsbqt.

string

Indicates the type of entity. In this case, it is dispute.

string

The unique identifier of the payment against which the dispute was created. For example, pay_EsyWjHrfzb59eR.

integer

Amount, in currency subunits, for which the dispute was created.

string

3-letter ISO currency code associated with the amount. Check the list of supported currencies.

integer

The amount, in currency subunits, deducted from your Razorpay current balance when the dispute is lost. This amount will be 0 unless the status of dispute is updated to lost. Know about the different states of disputes.

string

Code associated with the reason for the dispute.

string

A brief description of the reason for dispute.

integer

Unix timestamp by which a response should be sent to the customer.

string

The status of the dispute. Possible statuses are:

open: Indicates that the dispute has been created.
under_review: Indicates that the issuing bank is reviewing the dispute.
won: Indicates that the bank has accepted the remedial documents, and you have won the chargeback.
lost: Indicates that the bank did not accept the remedial documents, and you have lost the chargeback.
closed: Indicates that the fraudulent transaction was closed after you provided either the transaction details or made a refund to the customer.

string

Phase associated with the dispute. Possible phases are:

fraud: A dispute raised by the bank when it suspects a transaction to be fraudulent based on the risk analysis.
retrieval: A request initiated by the customer with their issuer bank for additional information about a transaction.
chargeback: A refund claim initiated by the customers with their issuer banks. In such cases, the bank starts an official inquiry.
pre_arbitration: A chargeback that you have won is challenged by the customer for the second time.
arbitration: A chargeback that you have won is challenged for a third time by the customer and the card networks directly getting involved.

integer

Unix timestamp when the dispute was created.

object

Provides details of the evidence submitted/saved for contesting a dispute. Use the Documents API to securely share documents with Razorpay.

integer

The contested amount in currency subunits, for which evidence is provided. The value can vary from 0 to the dispute amount. The default value is the dispute amount.

string

The explanation provided by you for contesting the dispute. It can have a maximum length of 1000 characters.

list

List of document ids which serves as proof that the product was shipped to the customer at their provided address. It should show their complete shipping address, if possible.

list

List of document ids which serves as proof of order confirmation, such as a receipt.

list

List of document ids that serves as proof that this product/service was cancelled.

list

List of document ids listing any written/email communication from the customer confirming that the customer received the product/service or is satisfied with the product/service.

list

List of document ids showing proof of service provided to the customer.

list

(List of document ids) Any letter(s) from you specifying information pertinent to the dispute/payment that needs to be considered for processing the dispute.

list

List of document ids showing proof that the refund had been provided to the customer.

list

List of document ids of any server or activity logs which prove that the customer accessed or downloaded the purchased digital product.

list

List of document ids listing your refund and/or cancellation policy, as shown to the customer.

list

List of document ids listing your sales terms and conditions, as shown to the customer.

list

Specifies the evidence documents to be uploaded as a part of contesting a dispute. It is a list of tuples consisting of the following:

string

Describes the custom type of evidence document(s) provided.

list

List of document ids corresponding to the customer evidence type.

Example

[
  {
    "type": "receipt_signed_by_customer",
    "document_ids": [
      "doc_EFtmUsbwpXwBH7",
      "doc_EFtmUsbwpXwBH6"
    ]
  }  
]

integer

Unix timestamp when the dispute was last submitted by you (for review) to Razorpay. The default value is null.

Errors

The id provided does not exist.

Code: 400

A wrong prefix is used.
The dispute id does not exist or does not belong to the requestor.

Solution:

The dispute id must start with disp_.
Use a valid dispute id that belongs to the requestor.

_id is not a valid id.

Code: 400

The id is not 14 characters long.
The id is not alphanumeric.

Solution: Use a valid dispute id.

invalid_proof_type is/are not required and should not be sent.

Code: 400Incorrect parameters are passed in the request body.Solution: No parameter is required in the request body.

Action not allowed as deadline to respond has elapsed.

Code: 400The deadline to respond for a dispute has elapsed.Solution: You can only respond to a dispute within the deadline.

Action not allowed when dispute is in lost status.

Code: 400This error occurs when you try to perform an action on a dispute with lost status.Solution: You cannot perform any action on a dispute with lost status.

Action not allowed when dispute is in won status.

Code: 400This error occurs when you try to perform an action on a dispute with won status.Solution: You cannot perform any action on a dispute with won status.

Action not allowed when dispute is in closed status.

Code: 400This error occurs when you try to perform an action on a closed dispute.Solution: You cannot perform any action on a closed dispute.

Action not allowed when dispute is in under_review status.

Code: 400This error occurs when you try to perform an action on a dispute under review.Solution: You cannot perform any action on a dispute under review.

contest amount cannot be greater than dispute amount.

Code: 400This error occurs when the contest amount is greater than the dispute amount.Solution: Make sure the contest amount is lesser than the dispute amount.

The selected action is invalid.

Code: 400This error occurs when you try to perform an invalid action.Solution: Only valid actions can be performed.

Invalid file id provided or merchant is unauthorized to access the fileId(s) provided

Code: 400This error occurs when you try to access invalid or unauthorised files.Solution: Make sure the file is valid or you have access to the file.

Last modified on October 8, 2026

​Path Parameters

​Request Parameters

​Response Parameters

​Errors

Path Parameters

Request Parameters

Response Parameters

Errors