Upload Dispute Evidence


This API is available for Finix Flex and Finix Core customers.

A core part of the dispute lifecycle is the ability for a Merchant to upload Dispute evidence that supports their side of the Dispute. It is recommended you provide as much supporting evidence as possible.

There are four available values that indicate the state of the evidence upload:

  • 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 https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence \
    -H "Content-Type: multipart/form-data" \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
    -F 'file=@path/to/local/file'

Example Response:

	    "tags": {
	        "content-type": "application/pdf",
	        "file-extension": ".pdf",
	        "file-name": "testfile.pdf"
	    "created_at": "2022-01-27T07:43:56.13Z",
	    "updated_at": "2022-01-27T07:43:56.14Z",
	    "state": "PENDING",
	    "_links": {
	        "self": {
	            "href": "https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence/DFnA9eVoYxRnxxLKzgcGGxYL"
	    "id": "DFnA9eVoYxRnxxLKzgcGGxYL",
	    "dispute": "DIs7yQRkHDdMYhurzYz72SFk"

HTTP Request

POST https://finix.sandbox-payments-api.com/disputes/:DISPUTE_ID/evidence


The maximum upload is 8 files. The total size of all uploaded files cannot exceed 10 MB. The acceptable file forms include: .JPG, .PNG, PDF, or TIFF. The maximum PNG and JPEG size is 50 KB; maximum PDF and TIFF size is 1 MB.