Antom, leading provider of tailored payment solutions

supplyEvidence

该接口用于为指定的拒付争议案件补充提交抗辩证据。

注意:该接口请求报文较大,需通过大报文网关发起调用。请根据所在地区,参考下表选择对应的大报文网关地址。

国家/地区

方法

URL

US

POST

https://open-big-na.alipay.com/v1/payments/supplyEvidence

SG

POST

https://open-big-sea.alipay.com/v1/payments/supplyEvidence

结构

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

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

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


入参

disputeId String  REQUIRED

Antom 争议 ID。

注意:如果该争议不存在,或该争议属于其他商户,将返回 DISPUTE_NOT_FOUND_OR_NO_ACCESS。

更多信息:

  • 最大长度:64 字符

evidenceContent Map<String, Object>  REQUIRED

证据内容集合。采用键值对结构:

  • Key 为 evidenceTag,集合中至少包含 1 个 Key,最多包含 32 个 Key。
  • Value 为该 evidenceTag 对应的参数对象,单个 Value 长度不超过 4,000,000 字符。

注意:如果 Key 不在证据标签取值中,将返回 EVIDENCE_TAG_NOT_SUPPORTED。

更多信息:

  • 最大长度:10000000 字符

出参

result Result  REQUIRED

接口调用的结果。

disputeId String  

Antom 争议 ID。

注意:当 result.resultStatus 的值为 S 时返回。

更多信息:

  • 最大长度:64 字符

evidenceResults Array<EvidenceResult>  

各证据标签的处理结果列表。

注意:当 result.resultStatus 的值为 F 时且失败原因可归因于具体证据标签时返回。

API Explorer

请求

Case
json
{
  "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..."
        }
      ]
    }
  }
}

响应

json
{
  "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"
    }
  ]
}

错误码

结果码

状态

信息

操作建议

SUCCESS

S

全部标签保存成功。

等待 notifyDefenseDocument 接口通知。

PARTIAL_SUCCESS

F

部分标签成功、部分标签失败。

读取 evidenceResults 定位失败标签,仅重传失败标签。

DISPUTE_NOT_FOUND_OR_NO_ACCESS

F

disputeId 不存在,或不属于当前 商户 ID 对应的商户。

不可重试。核对 disputeId 来源是否为本商户收到的 notifyDispute 或 notifyDefenseStrategySuggestion 接口推送的案件。

MERCHANT_NOT_ENABLED

F

商户未开通智能抗辩 API。

修改参数无法解决。需联系 Antom 客户经理申请开通,开通前不要重试。

EVIDENCE_TAG_NOT_SUPPORTED

F

evidenceContent 的 key 不在证据标签 24 个枚举值内,或不适用于本商户 MCC 分型

修正后可重试。根据 evidenceResults.evidenceTag 定位具体不支持的标签。

EVIDENCE_CONTENT_INVALID

F

标签对应的值非 JSON 对象,或结构不可解析,或 JSON 对象内容为空

修正后可重试。按对应标签字段要求重新构造该标签对象。

EVIDENCE_FIELD_MISSING

F

标签内必填参数缺失。

修正后可重试。根据 evidenceResults.failedFieldPath 定位并补齐缺失参数,例如 LOGISTIC_INFORMATION.trackingNumber,仅重传该标签。

FILE_FORMAT_NOT_SUPPORTED

F

文件格式不支持,fileFormat 不在 PDF、JPG、JPEG、PNG、WORD 范围内

转换为支持的文件格式后重试。注意格式值需使用大写。

CAPACITY_EXCEEDED

F

容量超限,例如 evidenceContent 的 key 数超过 32,或 UNCATEGORIZED.supplementProofFileList 元素数超过 5 个

如果 evidenceContent key 数超过 32,可拆分为多次调用提交,每批 key 互不相同;如果 UNCATEGORIZED.supplementProofFileList 超过 5,不可拆批,因为同标签重传会覆盖,应合并文件后提交或改用其他适配标签。服务端不会静默截断,超容时整笔拒绝。

FIXED_EVIDENCE_SIZE_EXCEED

F

商户级固定证据合并后超过 32KB UTF-8 字节限制

精简固定证据内容后重试。整笔失败,已留存内容不会变更。

TIME_EXCEEDS_LIMIT

F

已超过抗辩截止时间

不可重试,案件已进入终态,停止提交。

PROCESS_FAIL

F

一般业务失败,不属于上述明确错误类型

不可重试,联系 Antom 技术支持排查。

UNKNOWN_EXCEPTION

U

系统异常,包括并发写重试耗尽等

可重试。同标签重传为覆盖,不会产生重复风险。

PARAM_ILLEGAL

F

参数格式非法,例如 disputeId 缺失或超长、evidenceContent 为空或不是对象、参数值包含非法控制字符

修正入参后重试。