Skip to content

Latest commit

 

History

History
242 lines (221 loc) · 6.6 KB

dispute.md

File metadata and controls

242 lines (221 loc) · 6.6 KB
Raw

Document

Fetch All Disputes

Dispute dispute = instance.dispute.fetchAll();

Response:

{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "disp_Esz7KAitoYM7PJ",
      "entity": "dispute",
      "payment_id": "pay_EsyWjHrfzb59eR",
      "amount": 10000,
      "currency": "INR",
      "amount_deducted": 0,
      "reason_code": "pre_arbitration",
      "respond_by": 1590604200,
      "status": "open",
      "phase": "pre_arbitration",
      "created_at": 1590059211,
      "evidence": {
        "amount": 10000,
        "summary": null,
        "shipping_proof": null,
        "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": null,
        "submitted_at": null
      }
    }
  ]
}

Fetch a Dispute

String disputeId = "disp_0000000000000";

Dispute dispute = instance.dispute.fetchAll(disputeId);

Parameters:

Name Type Description
disputeId* string The unique identifier of the dispute.

Response:

{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "INR",
  "amount_deducted": 0,
  "reason_code": "pre_arbitration",
  "respond_by": 1590604200,
  "status": "open",
  "phase": "pre_arbitration",
  "created_at": 1590059211,
  "evidence": {
    "amount": 10000,
    "summary": "goods delivered",
    "shipping_proof": null,
    "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": null,
    "submitted_at": null
  }
}

Contest a Dispute

// Use this API sample code for draft

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)

Parameters:

Name Type Description
disputeId* string The unique identifier of the dispute.
amount integer The amount being contested. If the contest amount is not mentioned, we will assume it to be a full dispute contest.
summary string The explanation provided by you for contesting the dispute. It can have a maximum length of 1000 characters.
shipping_proof array 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.
others array All keys listed here are supported 
// Use this API sample code for submit

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)

Response:

// Draft
{
  "id": "disp_AHfqOvkldwsbqt",
  "entity": "dispute",
  "payment_id": "pay_EsyWjHrfzb59eR",
  "amount": 10000,
  "currency": "INR",
  "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
  }
}

//Submit 
{
  "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
  }
}

PN: * indicates mandatory fields

For reference click here