RDR 预警查询
本文档介绍如何查询 RDR 预警信息。通过该接口，您可以查询特定时间范围内的预警详情，包括交易争议、拒付风险等预警信息。
功能说明
预警查询接口允许商户：
- 分页查询预警信息
- 按多个维度筛选预警记录
- 查看预警的详细信息和处理状态
- 跟踪预警从产生到处理的全流程
预警类型
预警类型主要包括：
- 拒付预警
- 持卡人争议预警
- 欺诈交易预警
接口定义
GET
请求参数
| 名称 | 类型 | 长度 | 必填 | 签名 | 描述 |
|---|---|---|---|---|---|
| merchantNo | String | 20 | Yes | Yes | 商户编号 |
| caseId | String | 64 | No | Yes | Case ID |
| caseTypes | String | 32 | No | Yes | 预警类型，多个类型使用英文逗号分隔：DISPUTE - 拒付预警CANCEL - 取消预警FRAUD NOTICE - 欺诈预警DISPUTE NOTICE - 争议预警 |
| caseReceivedDateStart | String | 32 | No | Yes | 接收预警日期开始时间，格式：yyyy-MM-dd HH:mm:ss |
| caseReceivedDateEnd | String | 32 | No | Yes | 接收预警日期结束时间，格式：yyyy-MM-dd HH:mm:ss |
| txnTimeStart | String | 32 | No | Yes | 原交易时间范围起始值，格式：yyyy-MM-dd HH:mm:ss |
| txnTimeEnd | String | 32 | No | Yes | 原交易时间范围结束值，格式：yyyy-MM-dd HH:mm:ss |
| resellerSubMerchantId | String | 20 | No | Yes | 代理运营商的子商户标识 |
| bin | String | 32 | No | Yes | BIN 码 |
| caid | String | 32 | No | Yes | CAID：持卡人账户标识符 |
| dba | String | 128 | No | Yes | Doing Business As：商户实际经营名称 |
| merchantOrderId | String | 64 | No | Yes | 原交易商户订单号 |
| arn | String | 32 | No | Yes | ARN：收单参考号 |
| statusList | String | 32 | No | Yes | 预警处理状态列表，多个状态使用英文逗号分隔：ACCEPTED - 已接受DECLINED - 已拒绝 |
| current | String | 8 | Yes | Yes | 查询页码，从 1 开始 |
| sign | String | / | Yes | No | 请求签名，详见签名说明 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| respCode | String | 来自 Onerway 的响应码 |
| respMsg | String | 来自 Onerway 的响应信息 |
| data | Object | 响应数据。 请参阅对象 data |
data
| 名称 | 签名 | 类型 | 描述 |
|---|---|---|---|
| content | Yes | Array | 预警记录列表 |
| current | Yes | String | 当前页码 |
| size | Yes | Number | 每页记录数 |
| totalPages | Yes | Number | 总页数 |
| totalElements | Yes | Number | 总记录数 |
content 中的对象
| 名称 | 签名 | 类型 | 描述 |
|---|---|---|---|
| merchantNo | Yes | String | 商户编号 |
| caseId | Yes | String | Case ID |
| caseReceivedDate | Yes | String | 预警接收时间 |
| caseType | Yes | String | 预警类型 |
| caseAmount | Yes | String | 预警金额 |
| caseCurrency | Yes | String | 预警币种，符合 ISO 4217 标准 |
| reasonCode | Yes | String | 原因代码 |
| pricingTier | Yes | String | 定价层级 |
| caseSource | Yes | String | 预警来源 |
| status | Yes | String | 预警处理状态 |
| statusCode | Yes | String | 状态代码 |
| ruleType | Yes | String | 规则类型 |
| ruleName | Yes | String | 规则名称 |
| partnerName | Yes | String | 合作伙伴名称 |
| partnerId | Yes | String | 合作伙伴编号 |
| clientName | Yes | String | 客户名称 |
| clientId | Yes | String | 客户编号 |
| merchantName | Yes | String | 商户名称 |
| merchantId | Yes | String | 商户编号 |
| mcc | Yes | String | 商户类别代码（MCC） |
| bin | Yes | String | BIN 码 |
| caid | Yes | String | CAID：持卡人账户标识符 |
| dba | Yes | String | Doing Business As：商户实际经营名称 |
| caseDescriptorContact | Yes | String | 预警描述联系信息 |
| txnTime | Yes | String | 原交易时间 |
| txnAmount | Yes | String | 原交易金额 |
| txnCurrency | Yes | String | 原交易币种，符合 ISO 4217 标准 |
| caseAuthorizationCode | Yes | String | 授权码 |
| merchantOrderId | Yes | String | 原交易商户订单号 |
| arn | Yes | String | ARN：收单参考号 |
| cardBin | Yes | String | 卡BIN |
| cardLastFour | Yes | String | 卡号后四位 |
| paymentType | Yes | String | 支付类型 |
| resellerSubMerchantId | Yes | String | 代理商子商户编号 |
| sign | No | String | 响应签名，详见签名说明 |
请求及响应示例
GET
json
{
"arn": "",
"bin": "",
"caid": "",
"caseId": "",
"caseReceivedDateEnd": "2025-04-02 17:42:10",
"caseReceivedDateStart": "2025-02-02 17:42:10",
"caseTypes": "",
"current": "1",
"dba": "",
"merchantNo": "800209",
"merchantOrderId": "",
"resellerSubMerchantId": "",
"sign": "ad6f8744b0b5563e9eda80c3c56b8fbe8acce5630c6c7ff1da40a65314515a22",
"statusList": "",
"txnTimeEnd": "2025-04-03 17:42:10",
"txnTimeStart": "2025-02-02 17:42:10"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"content": [
{
"merchantNo": "800209",
"caseId": "642678339",
"caseReceivedDate": "2025-04-01 00:00:00",
"caseType": "DISPUTE",
"caseAmount": "49.99",
"caseCurrency": "USD",
"reasonCode": "13.1",
"pricingTier": "Tier 1",
"caseSource": "VMPI",
"status": "Accepted",
"statusCode": "103",
"ruleType": "AMOUNT",
"ruleName": "Refund All",
"partnerName": "Ronghan International Limited DBA OnerWay",
"partnerId": "12914",
"clientName": "Ronghan DBA as Onerway",
"clientId": "131647",
"merchantName": "Letsort - 453760 - 171000000025171",
"merchantId": "928199",
"mcc": null,
"bin": "453760",
"caid": "171000000017937",
"dba": "Letsort",
"caseDescriptorContact": "",
"txnTime": "2025-04-01 00:00:00",
"txnAmount": "49.99",
"txnCurrency": "USD",
"caseAuthorizationCode": "001026",
"merchantOrderId": "8d2d6515a55efb7",
"arn": "74537604033404369399234",
"cardBin": "407154",
"cardLastFour": "7168",
"paymentType": "Visa",
"resellerSubMerchantId": "009009",
"sign": null
}
],
"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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
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
预警查询流程
注意事项
注意事项
- 建议合理设置查询条件，避免返回过多数据
- 可通过多个维度组合查询，提高查询精确度
- 预警信息可能会有延迟，建议定期查询
- 请求参数需要按照签名规则进行签名
最佳实践
- 设置合理的时间范围进行查询
- 优先使用 Case ID 进行精确查询
- 对于代理商，可使用
resellerSubMerchantId查询特定子商户的预警 - 根据预警类型和处理状态进行分类查询
- 关注预警处理状态的变化，及时采取相应措施