Onerway
POST

查询 RDR 预警

该接口用于查询 RDR 预警案件,将案件匹配回原交易,并查看自动处理规则和处理状态。

请求

merchantNo
Onerway 分配的商户号;用于限定查询的商户账户范围。
示例:
caseId
RDR 预警案件唯一标识;传入后可按单条案件精确查询。
示例:
caseTypes
按预警案件类型筛选,便于按风险来源分别拉取。
示例:
可选值
DISPUTE
拒付争议(已正式发起的争议案件)。
CANCEL
取消请求预警。
FRAUD NOTICE
欺诈预警通知。
约束
规则
可传一个或多个案件类型,多个类型以英文逗号分隔。
规则
取值需按枚举原样传入:FRAUD NOTICE、DISPUTE NOTICE 含空格;DISPUTE 与 DISPUTE NOTICE 是两个独立取值。
caseReceivedDateStart
条件:按预警接收时间范围筛选时提供。
预警接收时间范围的起点,格式为 yyyy-MM-dd HH:mm:ss。
示例:
caseReceivedDateEnd
条件:按预警接收时间范围筛选时提供。
预警接收时间范围的终点,格式为 yyyy-MM-dd HH:mm:ss。
示例:
txnTimeStart
条件:按原交易时间范围筛选时提供。
原交易时间范围的起点,格式为 yyyy-MM-dd HH:mm:ss。
示例:
txnTimeEnd
条件:按原交易时间范围筛选时提供。
原交易时间范围的终点,格式为 yyyy-MM-dd HH:mm:ss。
示例:
resellerSubMerchantId
条件:代理运营商查询其子商户预警记录时提供;普通商户无需传入。
代理运营商的子商户标识。
bin
条件:按收单机构 BIN 筛选预警记录时提供。
收单机构 BIN(Bank Identification Number),用于标识为商户提供收单服务的机构。
caid
条件:按商户受理标识筛选预警记录时提供。
商户受理标识(CAID,Card Acceptor ID)。
dba
条件:按商户经营名称筛选预警记录时提供。
商户对外经营名称(DBA,Doing Business As)。
merchantOrderId
条件:按原交易商户订单号筛选时提供。
原交易的商户订单号,用于将预警匹配回商户自有订单。
arn
条件:按收单参考号筛选时提供。
收单参考号(ARN,Acquirer Reference Number)。
statusList
按处理状态筛选 RDR 预警案件。
示例:
可选值
ACCEPTED
已接受。
DECLINED
已拒绝。
约束
规则
指定 ACCEPTED 或 DECLINED;同时指定两个状态时,以英文逗号分隔。取值区分大小写。
current
查询页码,从 1 开始。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/rdr/agency-cw/detail-page' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "caseReceivedDateEnd": "2025-04-02 17:42:10",
  "caseReceivedDateStart": "2025-02-02 17:42:10",
  "caseTypes": "DISPUTE NOTICE,FRAUD NOTICE",
  "current": "1",
  "merchantNo": "replace_with_merchant_no",
  "sign": "{{SIGN}}",
  "statusList": "ACCEPTED,DECLINED"
}'

响应

respCode
响应码;20000 表示查询请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
业务数据对象,包含预警案件列表与分页信息。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。