submitEvidence Method

Overview

The submitEvidence method uploads supporting documentation to contest a chargeback dispute.

Business Use Case: A customer disputed a charge claiming they never received their order. You have delivery confirmation and submit this evidence.

Request Fields

Field	Type	Required	Description
disputeId	string	Yes	The connector's dispute ID
evidenceType	string	Yes	delivery_proof, customer_communication, receipt, etc.
files	array	Yes	URLs to evidence files
description	string	No	Description of evidence

Response Fields

Field	Type	Description
disputeId	string	Connector's dispute ID
evidenceSubmitted	boolean	Success status
status	DisputeStatus	Updated dispute status
statusCode	number	HTTP status code

Example

SDK Setup

const { DisputeClient } = require('hyperswitch-prism');

const disputeClient = new DisputeClient({
    connector: 'stripe',
    apiKey: 'YOUR_API_KEY',
    environment: 'SANDBOX'
});

Request

const request = {
    disputeId: "dp_xxx",
    evidenceType: "delivery_proof",
    files: [
        "https://storage.example.com/delivery_receipt.pdf",
        "https://storage.example.com/tracking.png"
    ],
    description: "Package delivered on 2024-01-15 with signature"
};

const response = await disputeClient.submitEvidence(request);

Response

{
    disputeId: "dp_xxx",
    evidenceSubmitted: true,
    status: "NEEDS_RESPONSE",
    statusCode: 200
}

Evidence Types

Type	Use When
delivery_proof	Physical goods delivered
customer_communication	Customer confirmed receipt
receipt	Proof of purchase
cancellation_policy	Customer agreed to terms

Next Steps

• defend - Submit formal defense after evidence
• get - Check dispute status