上传申诉文件

约 631 字大约 2 分钟

2025-04-23

上传成功后，接口仅返回文件存储路径；文件还没有提交到具体拒付案件。后续需要在上传拒付材料或提交材料并进行抗辩流程中引用该文件。

请求格式

该接口必须使用 multipart/form-data 提交，不支持使用纯 JSON 请求体提交。file 是顶层 multipart 文件字段，bizContent 是顶层 multipart 文本字段，其内容是 JSON 字符串。

Request Body Parameters

multipart/form-data

公共请求参数

bizContent

fileNameString(64)必填
文件名称。必须包含文件扩展名，建议与 file 上传文件原始文件名保持一致。
md5String(128)可选
上传文件内容的 MD5。若传入，必须与上传文件内容的 MD5 完全一致；建议使用 32 位小写十六进制格式。不传则不校验 MD5。

其他参数

请求报文示例

{
  "clientId": "2023060217493010231",
  "accId": "2023060217493010231446",
  "version": "1.0",
  "signType": "SHA256",
  "bizContent": {
    "fileName": "chargeback_evidence.pdf",
    "md5": "d41d8cd98f00b204e9800998ecf8427e"
  },
  "sign": "{{Sign}}",
  "file": "@/path/to/chargeback_evidence.pdf"
}

Responses Body Parameters

application/json

公共返回参数

bizContent

filePathString必填
上传后的文件路径。后续提交申诉材料时，可在 supplyDefenseDocument 接口的 defenseDocuments[].contentPath 中使用该值引用文件。

响应报文示例

{
  "clientId": "2023060217493010231",
  "accId": "2023060217493010231446",
  "code": "000000",
  "description": "Success",
  "bizContent": {
    "filePath": "/dispute/2026/08/27/abc123.pdf"
  },
  "signType": "SHA256",
  "sign": "{{Sign}}"
}

签名说明

文件字段 file 中的二进制内容不直接参与 V4 请求签名。参与签名的是顶层 Form Data 文本字段：

accId
bizContent
clientId
signType
version

生成签名时需先移除 sign 字段。若 bizContent 中传入 md5，则 md5 会作为 bizContent 字符串的一部分参与签名，同时服务端会使用该值校验上传文件内容。

签名原文示例：

accId=2023060217493010231446&bizContent={"fileName":"chargeback_evidence.pdf","md5":"d41d8cd98f00b204e9800998ecf8427e"}&clientId=2023060217493010231&signType=SHA256&version=1.0

生成签名时使用的 bizContent 字符串必须与实际请求中传入的 bizContent 完全一致。空格、转义方式、字段顺序、md5 大小写不一致，都可能导致签名校验失败或 MD5 校验失败。

cURL 示例

curl -X POST 'https://{baseUrl}/v4/dispute/disputeUploadFile' \
  -F 'clientId=2023060217493010231' \
  -F 'accId=2023060217493010231446' \
  -F 'version=1.0' \
  -F 'signType=SHA256' \
  -F 'bizContent={"fileName":"chargeback_evidence.pdf","md5":"d41d8cd98f00b204e9800998ecf8427e"}' \
  -F 'sign={requestSign}' \
  -F 'file=@/path/to/chargeback_evidence.pdf;type=application/pdf'

对接注意事项

file 必须是真实文件上传字段，字段名固定为 file。
bizContent 是字符串字段，字段内容是 JSON。
md5 是上传文件内容的 MD5，不是文件名、文件路径或 bizContent 的 MD5。
单个文件最大 10 MB。
判断接口是否成功应以响应字段 code 为准，HTTP 200 只代表服务端已处理 HTTP 请求。