Deprecated API Reference

This API Reference is being deprecated. Please use the New API Reference.

Upload Dispute Evidence

A core part of the dispute lifecycle is allowing the Merchant to appeal the dispute. Merchant can upload evidence to the Dispute that supports their side of the Dispute. It's recommended Merchants upload as much supporting evidence as possible.

  • You can upload up to 8 files; the total size of the uploaded files combined cannot exceed 10 MB.
  • The file formats allowed include JPG, PNG, PDF, or TIFF.
  • Individual PNG and JPEG files can't exceed 50 KB; PDF and TIFF files can't exceed 1 MB.

There are four values available for state when uploading evidence includes:

  • PENDING: The evidence file has not yet been submitted to the Processor . No user action is required.
  • SUCCEEDED: The evidence file has been successfully sent to the Processor . No further user action is required.
  • CANCELED: The evidence file upload was not completed due to user action.
  • FAILED: An issue occurred. User action is required. Any of the following issues could have occurred:
    • There was an error in the system and the user should retry uploading their evidence file.
    • There is an issue with the file and the user should retry uploading a different file.
    • There is an issue and the user should contact Support.
curl \
    -H "Content-Type: multipart/form-data" \
    -H 'Finix-Version:2022-02-01' \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
    -F 'file=@path/to/local/file'

Example Response:

	"id": "DFcVgoEuDeWn4eSvdZca8Hf",
	"created_at": "2022-10-06T20:22:54.93Z",
	"updated_at": "2022-10-06T20:30:00.63Z",
	"dispute": "DIs7yQRkHDdMYhurzYz72SFk",
	"state": "SUCCEEDED",
	"tags": {
		"file-extension": ".png",
		"content-type": "image/png",
		"file-name": "test_file.png"
	"_links": {
		"self": {
			"href": ""

HTTP Request