拒付订单查询
注意
调用此接口之前，需先联系我们开通查询拒付权限。
拒付是指在信用卡交易完成后，持卡人认为交易存在争议或被认为是欺诈性的，于是向发卡行提出退款要求。该接口可以查询是否存在此类订单。
请求参数
POST
Content-Type: application/json; charset=UTF-8 ❌
Content-Type: application/json ✅
| 名称 | 类型 | 长度 | 必填 | 签名 | 描述 |
|---|---|---|---|---|---|
| merchantNo | String | 20 | Yes | Yes | 商户号。 商户注册时，OnerWay会为商户创建商户号 |
| merchantTxnIds | String | / | No | Yes | 商户交易订单号，可以是多个，以逗号分隔， |
| originTransactionIds | String | / | No | Yes | 来自 OnerWay 的原交易订单号，可以是多个，以逗号分隔 |
| chargebackIds | String | / | No | Yes | 来自 OnerWay 的拒付交易单号，可以是多个，以逗号分隔 |
| importTimeStart | String | / | No | Yes | OnerWay 接收的拒付交易的开始时间，格式为yyyy-MM-dd HH:mm:ss |
| importTimeEnd | String | / | No | Yes | OnerWay 接收的拒付交易的结束时间，格式为yyyy-MM-dd HH:mm:ss。 最长间隔为 90 天。 |
| current | String | / | Yes | Yes | 查询的当前页码，每页10条记录 |
| sign | String | / | Yes | No | 签名字符串，请参阅签名接口 |
请求参数中，merchantTxnIds 、transactionIds 、startTime 和 endTime 三者必须上送一个。
响应参数
| 名称 | 类型 | 签名 | 描述 |
|---|---|---|---|
| respCode | String | No | 来自 Onerway 的响应码 |
| respMsg | String | No | 来自 Onerway 的响应信息 |
| data | Map | No | 响应数据。 请参阅对象 Page |
Page
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| content | List | Yes | 交易信息列表，请参阅对象 ChargebackInfo |
| current | String | Yes | 当前页码 |
| size | String | Yes | 当前页大小 |
| totalPages | String | Yes | 总页数 |
| totalElements | String | Yes | 总条数 |
ChargebackInfo
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| merchantNo | String | Yes | 商户号。 商户注册时，OnerWay 会为商户创建商户号 |
| merchantTxnId | String | Yes | 商户创建的商户交易订单号，不同的订单号视为不同的交易 |
| originTransactionId | String | Yes | 来自 Onerway 的原交易订单号。 |
| txnAmount | String | Yes | 以结算币种计的原交易金额 |
| txnCurrency | String | Yes | 原交易结算币种。 请参阅 ISO 4217 货币代码 |
| txnTime | String | Yes | 原交易完成时间 |
| paymentMethod | String | Yes | 具体支付方式，包括卡和本地支付类型 |
| chargebackId | String | Yes | Onerway 创建的拒付交易订单号 |
| importTime | String | Yes | OnerWay 接收拒付交易的时间 |
| chargebackAmount | String | Yes | 发生的拒付金额 |
| chargebackCurrency | String | Yes | 拒付金额的币种。 请参阅 ISO 4217 货币代码 |
| chargebackDate | String | Yes | 拒付发生的日期 |
| chargebackStatus | String | Yes | 拒付交易状态。 请参阅 |
| chargebackReason | String | Yes | 拒付原因 |
| chargebackArn | String | Yes | ARN |
| appealDueTime | String | Yes | 申诉资料提交截止时间，格式为yyyy-MM-dd HH:mm:ss |
| chargebackCode | String | Yes | 拒付代码 |
拒付订单查询请求响应示例
POST
根据 交易列表 查询拒付订单
json
{
"chargebackIds": "",
"current": "1",
"importTimeEnd": "2024-07-24 00:00:00",
"importTimeStart": "2024-07-23 00:00:00",
"merchantNo": "800209",
"merchantTxnIds": "",
"originTransactionIds": "",
"sign": "a78bfa309daf6c1ae444ad87eed54cc5bd38a822e7360c04a6a11c3e70ca49c0"
}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"content": [
{
"merchantNo": "800209",
"chargebackId": "1815647844296949760",
"importTime": "2024-07-23 15:19:14",
"merchantTxnId": "1721712864000",
"originTransactionId": "1815621472153370624",
"txnAmount": "20.00",
"txnCurrency": "USD",
"txnTime": "2024-07-23 13:36:59",
"paymentMethod": "MASTERCARD",
"chargebackAmount": "10.00",
"chargebackCurrency": "USD",
"chargebackDate": "2024-07-23",
"chargebackReason": "1111",
"chargebackArn": "1111",
"chargebackCode": "111",
"appealDueTime": "2024-07-26 15:19:14",
"chargebackStatus": "NEW"
},
{
"merchantNo": "800209",
"chargebackId": "1815648032830914560",
"importTime": "2024-07-23 15:19:59",
"merchantTxnId": "355243001534",
"originTransactionId": "1815582133184757760",
"txnAmount": "30.00",
"txnCurrency": "USD",
"txnTime": "2024-07-23 10:58:25",
"paymentMethod": "VISA",
"chargebackAmount": "10.00",
"chargebackCurrency": "USD",
"chargebackDate": "2024-07-23",
"chargebackReason": "111",
"chargebackArn": "1111",
"chargebackCode": "111",
"appealDueTime": "2024-07-26 15:19:59",
"chargebackStatus": "NEW"
}
],
"current": "1",
"size": 10,
"totalPages": 1,
"totalElements": 2
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
根据 订单号 查询拒付订单
json
{
"chargebackIds": "",
"current": "1",
"importTimeEnd": "",
"importTimeStart": "",
"merchantNo": "800209",
"merchantTxnIds": "355243001534",
"originTransactionIds": "",
"sign": "188e1743854b0343d63181bfcc7ec72769046b4bda7044000f7ed8baf44ba7df"
}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"content": [
{
"merchantNo": "800209",
"chargebackId": "1815648032830914560",
"importTime": "2024-07-23 15:19:59",
"merchantTxnId": "355243001534",
"originTransactionId": "1815582133184757760",
"txnAmount": "30.00",
"txnCurrency": "USD",
"txnTime": "2024-07-23 10:58:25",
"paymentMethod": "VISA",
"chargebackAmount": "10.00",
"chargebackCurrency": "USD",
"chargebackDate": "2024-07-23",
"chargebackReason": "111",
"chargebackArn": "1111",
"chargebackCode": "111",
"appealDueTime": "2024-07-26 15:19:59",
"chargebackStatus": "NEW"
}
],
"current": "1",
"size": 10,
"totalPages": 1,
"totalElements": 1
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
此示例仅限参考 请勿拿此示例直接请求。