supplyEvidence
This API is used to supplement and submit defense evidence for a specified chargeback dispute case.
Note: The request message for this API is large and must be initiated through the large-message gateway. Please select the corresponding large-message gateway address from the table below based on your country/region.
Country/Region | Method | URL | |
US | POST | https://open-big-na.alipay.com/v1/payments/supplyEvidence | |
SG | POST | https://open-big-sea.alipay.com/v1/payments/supplyEvidence | |
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 parameter (except array) as String. This means that you must use double quotation marks (" ") to enclose the parameter value. Examples:
- If the data type of a parameter is Integer and its value is
20, set it as "20". - If the data type of a parameter is Boolean and its value is
true, set it as "true".Â
Request parameters
disputeId String  REQUIRED
Antom dispute ID.
Note: If the dispute does not exist or belongs to another merchant, DISPUTE_NOT_FOUND_OR_NO_ACCESS will be returned.
More information:
- Maximum length: 64 characters
evidenceContent Map<String, Object>  REQUIRED
The evidence content collection. It uses a key-value structure:
- The key is evidenceTag. The collection must contain at least 1 key and can contain up to 32 keys.
- The value is the parameter object corresponding to the evidenceTag. The length of a single value must not exceed 4,000,000 characters.
Note: If the key is not included in the values of evidenceTag, EVIDENCE_TAG_NOT_SUPPORTED will be returned.
More information:
- Maximum length: 10000000 characters
Response parameters
result Result  REQUIRED
The result of the API call.
disputeId String Â
Antom dispute ID.
Note: This parameter is returned when the value of result.resultStatus is S.
More information:
- Maximum length: 64 characters
evidenceResults Array<EvidenceResult> Â
The list of processing results for each evidence tag.
Note: This parameter is returned when the value of result.resultStatus is F and the failure reason can be attributed to a specific evidence tag.
Request
{
"disputeId": "20260831190000000001",
"evidenceContent": {
"LOGISTIC_INFORMATION": {
"trackingNumber": "SF1234567890",
"postCode": "5***00",
"shippingAddress": "***",
"trackingUrl": "https://www.sf-express.com/track?no=SF1234567890",
"proofOfShipment": "Signed for by the recipient on 2026-08-20 10:32 (SF Express)",
"logisticScreenshotFile": {
"fileName": "delivery_proof.jpg",
"fileFormat": "JPG",
"fileContent": "/9j/4AAQSkZJRgABAQAAAQ..."
}
},
"CUSTOMER_COMMUNICATIONS": {
"customerCommunications": "2026-08-20 buyer confirmed receipt in chat: \"Package received, thanks.\""
},
"RETURN_AND_REFUND_POLICY": {
"returnAndRefundPolicy": "https://merchant.example.com/refund-policy"
},
"UNCATEGORIZED": {
"supplementProof": "The buyer placed 14 undisputed orders with the same shipping address in the past 12 months.",
"supplementProofFileList": [
{
"fileName": "order_history.pdf",
"fileFormat": "PDF",
"fileContent": "JVBERi0xLjQK..."
},
{
"fileName": "crm_note.png",
"fileFormat": "PNG",
"fileContent": "iVBORw0KGgoAAAANS..."
}
]
}
}
}Response
{
"result": {
"resultCode": "PARTIAL_SUCCESS",
"resultStatus": "F",
"resultMessage": "part of the evidence tags failed"
},
"disputeId": "20260831190000000001",
"evidenceResults": [
{
"evidenceTag": "LOGISTIC_INFORMATION",
"success": "true"
},
{
"evidenceTag": "CUSTOMER_COMMUNICATIONS",
"success": "false",
"resultCode": "EVIDENCE_TAG_NOT_SUPPORTED"
},
{
"evidenceTag": "PROOF_OF_SERVICE_COMPLETION",
"success": "false",
"resultCode": "EVIDENCE_FIELD_MISSING",
"failedFieldPath": "PROOF_OF_SERVICE_COMPLETION.merchantOrderNo"
}
]
}