质疑接口 - Dispute contest

使用流程

1. 先调用上传文件接口获取证据文件的存储路径
2. 使用返回的 storageUri 值作为证据的 url 字段值
3. 调用本接口提交争议质疑及相关证据

请求地址

https://{{gateway_domain}}/pg/v2/dispute/contest

请求参数

HTTP Method

POST

HTTP Header

字段	数据类型	长度限制	是否必填项	说明
Content-Type	String	N/A	是	字段值只支持 application/json
Accept	String	N/A	是	字段值只支持 application/json
Authorization	String		是	Authorization: {type} {credentials}，详情参考签名规范部分

HTTP Body

字段	数据类型	长度限制	是否必填项	说明
disputeNo	String	32	是	平台争议订单号
evidenceList	Array[OpenDisputeEvidence]	N/A	是	争议证据列表

evidenceList 字段说明

字段	数据类型	长度限制	是否必填项	说明
type	String	N/A	是	证据类型，支持：OTHER（其他）、REFUND（退款）、RECEIPT（收据）、DEFAULT（默认）
name	String	N/A	是	证据名称
url	String	N/A	是	证据文件存储路径，需要通过上传文件接口获取的 storageUri 值，详情参考上传文件接口文档

响应结果

HTTP Header

字段	数据类型	是否必填项	说明
Content-Type	String	是	字段值只支持 application/json
Authorization	String	是	Authorization: {type} {credentials}，详情参考签名规范部分

HTTP Body

字段	数据类型	是否必填项	说明
code	String	是	参考响应码表
errorMessage	String	否	错误信息
data	JSON Object	否

data 字段说明

字段	数据类型	是否必填项	说明
result	Boolean	否	更新结果

示例

请求

curl https://{{gateway_domain}}/pg/v2/dispute/contest \
  -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H 'Authorization: V2_SHA256 appId=1111b620f93b48c5904210ff47bb1111,sign=9e494e8a91bcdd08f18ad5b2cfdbfd5654f5c00c89f8216eebd7c1637b6ce01b,timestamp=1714128828114,nonce=C7CA27DC6D55DA935DFC8450C721CC99' \
  -d '{
    "disputeNo": "1234567890",
    "evidenceList": [
      {
        "type": "RECEIPT",
        "name": "交易收据",
        "url": "s3://uploaded/m/80/open/dispute-evidence/2ace1b345cbb4a09852d7d92e540591a.png"
      },
      {
        "type": "REFUND",
        "name": "退款证明",
        "url": "s3://uploaded/m/80/open/dispute-evidence/ed283d5a58034c4a947b18d77621d9d8.pdf"
      }
    ]
}'

响应

HTTP/1.1 200 OK
Content-Type: application/json
Server: nginx/1.18.0
Date: Mon, 06 Mar 2024 12:00:00 GMT
Authorization: V2_SHA256 appId=1111b620f93b48c5904210ff47bb1111,sign=ac6ae72f8c46f5c2092c3dab9bb0e08b6cdb6d5e7ff8ad190499a8955d57f297,timestamp=1714128245401,nonce=28FA11BF8FD1309767551B4FD8A57BD5

{
    "code": "OK",
    "errorMessage": null,
    "data": {
      "result": true
    }
}