Upload an Evidence Document

Upload file-based evidence to support payment dispute resolution cases.

When you create a dispute evidence document, you receive an upload URL in the response. You use this upload URL to upload your file directly. After you upload the file, you can submit the evidence.

Step 1 | Create a dispute evidence document

This step creates a new dispute evidence document and provides an upload URL for file attachment.

To create a dispute evidence document, call Create Dispute Evidence Document, specifying the dispute ID.

Save the uploadUrl included in the response.

Step 2 | Upload the file with the upload URL

This step uploads your evidence file by calling the upload URL from the previous step.

Syntax

Copy

Authorization

This method uses the upload token included in the URL for authorization. You don't need additional authorization.

Important: The upload token expires after 10 minutes, so the upload URL must be used within 10 minutes of receiving it.

Headers params

NameTypeOptionalDescription
Content-TypestringnoFile content type. For example, "image/jpeg" for a jpg file.

Note: You can use the standard File API to retrieve the file content type using the File or Blob type attributes. You can also use external libraries, such as file-type, to retrieve the file content type.

Examples

JavaScript

Copy

Curl

Copy

Note: The upload process is asynchronous. A successful response doesn't guarantee the file is immediately available. The file processing happens in the background. When the upload is complete, the Dispute Evidence Document Updated event is triggered.

What's next

To submit the evidence to the payment processor or bank, call Defend Dispute. This submits all evidence documents associated with the dispute for review by the payment processor.

Did this help?