查询接口 - Dispute query
请求地址
HTTP
https://{{gateway_domain}}/pg/v2/dispute/query请求参数
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
| 字段 | 数据类型 | 长度限制 | 是否必填项 | 说明 |
|---|---|---|---|---|
| merchantTradeNo | String | 50 | disputeNo, paymentNo, merchantTradeNo 三选一 | 商户支付订单号 |
| disputeNo | String | 32 | disputeNo, paymentNo, merchantTradeNo 三选一 | 平台争议订单号 |
| paymentNo | String | 32 | disputeNo, paymentNo, merchantTradeNo 三选一 | 平台订单号 |
响应结果
HTTP Header
| 字段 | 数据类型 | 是否必填项 | 说明 |
|---|---|---|---|
| Content-Type | String | 是 | 字段值只支持 application/json |
| Authorization | String | 是 | Authorization: {type} {credentials}，详情参考签名规范部分 |
HTTP Body
| 字段 | 数据类型 | 是否必填项 | 说明 |
|---|---|---|---|
| code | String | 是 | 参考响应码表 |
| errorMessage | String | 否 | 错误信息 |
| data | JSON Object | 否 |
data 字段说明
| 字段 | 数据类型 | 是否必填项 | 说明 |
|---|---|---|---|
| disputeNo | String | 是 | 支付平台争议号 |
| paymentNo | String | 是 | 平台订单号 |
| merchantTradeNo | String | 是 | 商户支付订单号 |
| status | String | 是 | 详见争议状态 |
| type | String | 否 | 争议类型 |
| rrn | String | 否 | 渠道检索参考号码，依赖渠道返回 |
| deadline | String | 否 | 争议截止时间 |
| paymentAmount | String | 是 | 订单金额 |
| disputeAmount | String | 是 | 争议金额 |
| currency | String | 是 | 币种 |
| disputeReason | String | 是 | 争议原因 |
| createdTime | String | 是 | 争议创建时间（本地时间，含时间区间） |
示例
请求
HTTP
curl https://{{gateway_domain}}/pg/v2/dispute/query \
-X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H 'Authorization: V2_SHA256 appId=1111b620f93b48c5904210ff47bb1111,sign=9e494e8a91bcdd08f18ad5b2cfdbfd5654f5c00c89f8216eebd7c1637b6ce01b,timestamp=1714128828114,nonce=C7CA27DC6D55DA935DFC8450C721CC99' \
-d '{
"merchantTradeNo": "MTOU-0211"
}'响应
HTTP
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": {
"disputeNo": "1234567890",
"paymentNo": "1234567890",
"merchantTradeNo": "MTOU-0211",
"status": "OPEN",
"type": "FRAUD",
"rrn": "123456789",
"paymentAmount": "1.00",
"disputeAmount": "1.00",
"currency": "INR",
"disputeReason": "FRAUD",
"createdTime": "2024-04-23T22:10:45+08:00",
"deadline": "2024-04-23T22:10:45+08:00"
}
}Dispute 状态
| 状态 | 说明 |
|---|---|
| OPEN | 争议已创建 |
| UNDER_REVIEW | 争议处理中 |
| WON | 争议获胜 |
| LOST | 争议失败 |
| CLOSED | 争议关闭 |
Dispute 类型
| 状态 | 说明 |
|---|---|
| FRAUD | 欺诈 |
| RETRIEVAL | 检索 |
| BO_RBI_COMPLAINT | RBI 投诉 |
| ARBITRATION_RAISE | 仲裁提出 |
| PRE_ARBITRATION_RAISE | 预仲裁提出 |
| DIFFERED_CHARGEBACK_RAISE | 延迟退款提出 |
| CHARGEBACK_RAISE | 退款提出 |
| CHARGEBACK | 退款 |
| CYBER_CRIME_CASE | 网络犯罪案例 |
| USER_COMPLAINT | 用户投诉 |
| UNKNOWN | 未知 |