notifyDefenseDocument

2026-11-02 17:57

Antom 生成拒付争议案件的抗辩材料后，向商户主动发送通知。商户收到通知后，可根据通知中的文件元信息，通过 downloadDisputeEvidence 接口下载生成的抗辩材料。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个参数（除数组外）的数据类型设置为字符串，即参数的值必须使用英文双引号（" "）包裹起来。例如：

如果参数的数据类型为整数属性，且其值为 20，设置为 "20"。
如果参数的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

disputeId String REQUIRED

Antom 争议 ID，用于将该通知与商户本地争议案件进行关联。

更多信息：

最大长度：64 字符

notifyTime Datetime REQUIRED

通知生成时间，该参数与 disputeId 共同构成本次通知的逻辑事件标识：重试通知会复用相同的 notifyTime，新的逻辑事件会生成新的 notifyTime。

更多信息：

最大长度：32 字符
值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

defenseFile DefenseFile REQUIRED

生成的抗辩材料文件元信息。

注意：通知中不直接返回文件内容，商户收到通知后需通过 downloadDisputeEvidence 接口下载，证据类型为 DISPUTE_EVIDENCE_AI。

winRateLevel String

当前抗辩材料对应的预测胜诉率等级。有效值为：

HIGH：表示证据较强，建议进行抗辩。
MEDIUM：表示证据强度中等，补充缺失证据标签可提高胜诉概率
LOW：表示胜诉概率较低，可能建议接受争议。

注意：该参数仅作参考；当算法未生成胜诉率等级时，不返回该参数。

更多信息：

最大长度：8 字符

recommendedEvidence Map<String, String>

建议补充的证据集合，采用键值对结构：

Key 为证据标签，最多包含 32 个 Key。
Value 为补充要求说明，最大长度不超过 512 字符。

suggestionsForImprovement String

针对抗辩材料的语言优化建议。

注意：该参数仅作参考，不代表对争议结果的承诺。

更多信息：

最大长度：2048 字符

出参

result Result REQUIRED

发送给 Antom 确认已收到通知的固定值。

API Explorer

请求

{
  "disputeId": "20260831190000000001",
  "notifyTime": "2026-09-02T10:15:00.000+08:00",
  "defenseFile": {
    "fileName": "defense_letter_20260831.pdf",
    "fileMd5": "5d41402abc4b2a76b9719d911017c592",
    "fileFormat": "PDF"
  },
  "winRateLevel": "HIGH",
  "recommendedEvidence": {
    "MARKETING_MATERIALS_AND_LISTINGS": "Provide the product listing page screenshot to strengthen the not-as-described rebuttal."
  },
  "suggestionsForImprovement": "The logistics proof is strong. Adding the product listing page would further improve the outcome."
}

响应

{
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success",
    "resultStatus": "S"
  }
}

结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功。	无需进一步操作。