downloadDisputeEvidence
Use this API to access the dispute evidence template and the previously uploaded dispute evidence file. The dispute evidence template contains prefilled transaction and payment information related to the dispute, which will assist you in preparing your evidence. The dispute evidence file is the document you uploaded in the previous dispute.
Structure
A message consists of a header and body. The following sections are focused on the body structure. For the header structure, see：
Note: Set the data type of each field (except array) as String. This means that you must use double quotation marks (" ") to enclose the field value. Examples:
- If the data type of a field is Integer and its value is 20, set it as "20".
- If the data type of a field is Boolean and its value is
true, set it as "true".
Request parameters
disputeId String REQUIRED
The unique ID that is assigned by Antom to identify a dispute.
More information:
- Maximum length: 64 characters
disputeEvidenceType String REQUIRED
The type of dispute evidence you can download. Valid values are:
DISPUTE_EVIDENCE_TEMPLATE: the pre-filled dispute evidence template, which is a valuable tool for improving the success rate of your defense. We highly recommend downloading this template to ensure all necessary information is included in your defense document. For a template sample with pre-filled information, see Merchant Letter.DISPUTE_EVIDENCE_FILE: the dispute evidence file uploaded by the supplyDefenseDocument API.
More information:
- Maximum length: 64 characters
Response parameters
result Result REQUIRED
The result of the API call.
disputeEvidence String
The dispute evidence that is encoded in the Based64 format. Decode the Base64 document to get the Word or PDF file.
Note: This prameter is returned when the value of resultCode is
SUCCESS.
More information:
- Maximum length: 1000000 characters
disputeEvidenceFormat String
The document format of the dispute evidence. Valid values are:
WORD: indicates that the format of the dispute evidence is Word.PDF: indicates that the format of the dispute evidence is PDF.
Note: This prameter is returned when the value of resultCode is
SUCCESS.
More information:
- Maximum length: 64 characters
Request
Response
Result/Error codes
| Code | Value | Message | Further action |
|---|---|---|---|
| SUCCESS | S | Success. | |
| UNKNOWN_EXCEPTION | U | API failed due to an unknown reason. | Call the interface again to resolve the issue. If not resolved, contact Antom Technical Support. |
| PARAM_ILLEGAL | F | Illegal parameters. For example, non-numeric input, invalid date. | Check and verify whether the required request fields (including the header fields and body fields) of the current API are correctly passed and valid. |