POST
/
disputes
/
{dispute_id}
/
documents

Authorizations

x-client-id
string
header
required

Client app ID. You can find your app id in the Merchant Dashboard.

x-client-secret
string
header
required

Client secret key. You can find your secret in the Merchant Dashboard.

Headers

x-api-version
string
default:
2023-08-01
required

API version to be used. Format is in YYYY-MM-DD

x-request-id
string

Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

x-idempotency-key
string

An idempotency key is a unique identifier you include with your API call. If the request fails or times out, you can safely retry it using the same key to avoid duplicate actions.

Path Parameters

dispute_id
integer
required

Cashfree dispute ID to get Evidences to submit to contest the Dispute.

Body

multipart/form-data
doc_type
string
required

Mention the type of the document you are uploading. Possible values :- Delivery/Service Proof, Shipping Proof, Statement of Service, Proof of Service Used, Cancellation of Service Proof, Refund Proof, Business model explanation, Extra Charges Declaration, Terms & Conditions, Customer Withdrawal Letter, Certificate of Authenticity, Reseller Agreement. You can use get evidences to contest dispute API to fetch set of documents required to contest particular dispute.

file
string
required

File types supported are jpeg, jpg, png, pdf and maximum file size allowed is 20 MB.

note
string

Response

200 - application/json
cf_dispute_remarks
string
created_at
string

This is the time when the dispute was created.

customer_details
object
dispute_amount
number

Dispute amount may differ from transaction amount for partial cases.

dispute_amount_currency
string

Dispute amount currency for a dispute

dispute_evidence
object[]
dispute_id
integer
dispute_status
enum<string>
Available options:
DISPUTE_CREATED,
DISPUTE_DOCS_RECEIVED,
DISPUTE_UNDER_REVIEW,
DISPUTE_MERCHANT_WON,
DISPUTE_MERCHANT_LOST,
DISPUTE_MERCHANT_ACCEPTED,
DISPUTE_INSUFFICIENT_EVIDENCE,
CHARGEBACK_CREATED,
CHARGEBACK_DOCS_RECEIVED,
CHARGEBACK_UNDER_REVIEW,
CHARGEBACK_MERCHANT_WON,
CHARGEBACK_MERCHANT_LOST,
CHARGEBACK_MERCHANT_ACCEPTED,
CHARGEBACK_INSUFFICIENT_EVIDENCE,
RETRIEVAL_CREATED,
RETRIEVAL_DOCS_RECEIVED,
RETRIEVAL_UNDER_REVIEW,
RETRIEVAL_MERCHANT_WON,
RETRIEVAL_MERCHANT_LOST,
RETRIEVAL_MERCHANT_ACCEPTED,
RETRIEVAL_INSUFFICIENT_EVIDENCE,
PRE_ARBITRATION_CREATED,
PRE_ARBITRATION_DOCS_RECEIVED,
PRE_ARBITRATION_UNDER_REVIEW,
PRE_ARBITRATION_MERCHANT_WON,
PRE_ARBITRATION_MERCHANT_LOST,
PRE_ARBITRATION_MERCHANT_ACCEPTED,
PRE_ARBITRATION_INSUFFICIENT_EVIDENCE,
ARBITRATION_CREATED,
ARBITRATION_DOCS_RECEIVED,
ARBITRATION_UNDER_REVIEW,
ARBITRATION_MERCHANT_WON,
ARBITRATION_MERCHANT_LOST,
ARBITRATION_MERCHANT_ACCEPTED,
ARBITRATION_INSUFFICIENT_EVIDENCE
dispute_type
enum<string>
Available options:
DISPUTE,
CHARGEBACK,
RETRIEVAL,
PRE_ARBITRATION,
ARBITRATION
order_details
object
preferred_evidence
any[]
reason_code
string
reason_description
string
resolved_at
string

This is the time when the dispute case was closed.

respond_by
string

This is the time by which evidence should be submitted to contest the dispute.

updated_at
string

This is the time when the dispute case was updated.