# 查询 RDR 预警

> 按案件标识、案件类型、接收时间、原交易信息或处理状态查询 RDR 预警案件。

```yaml
openapi: 3.1.0
info:
  title: 查询 RDR 预警
  version: 1.0.0
  description: 按案件标识、案件类型、接收时间、原交易信息或处理状态查询 RDR 预警案件。
paths:
  /rdr/agency-cw/detail-page:
    post:
      summary: 查询 RDR 预警
      description: 按案件标识、案件类型、接收时间、原交易信息或处理状态查询 RDR 预警案件。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；用于限定查询的商户账户范围。
                caseId:
                  type: string
                  description: RDR 预警案件唯一标识；传入后可按单条案件精确查询。
                caseTypes:
                  type: string
                  description: 按预警案件类型筛选，便于按风险来源分别拉取。
                  enum:
                    - DISPUTE
                    - CANCEL
                    - FRAUD NOTICE
                    - DISPUTE NOTICE
                  x-enum-descriptions:
                    DISPUTE: 拒付争议（已正式发起的争议案件）。
                    CANCEL: 取消请求预警。
                    FRAUD NOTICE: 欺诈预警通知。
                    DISPUTE NOTICE: 拒付预警通知（争议正式发生前的早期提醒）。
                  x-onerway-constraints:
                    - kind: rule
                      text: 可传一个或多个案件类型，多个类型以英文逗号分隔。
                    - kind: rule
                      text: 取值需按枚举原样传入：`FRAUD NOTICE`、`DISPUTE NOTICE` 含空格；`DISPUTE` 与 `DISPUTE
                        NOTICE` 是两个独立取值。
                caseReceivedDateStart:
                  type: string
                  description: 预警接收时间范围的起点，格式为 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-condition:
                    - 按预警接收时间范围筛选时提供。
                caseReceivedDateEnd:
                  type: string
                  description: 预警接收时间范围的终点，格式为 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-condition:
                    - 按预警接收时间范围筛选时提供。
                txnTimeStart:
                  type: string
                  description: 原交易时间范围的起点，格式为 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-condition:
                    - 按原交易时间范围筛选时提供。
                txnTimeEnd:
                  type: string
                  description: 原交易时间范围的终点，格式为 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-condition:
                    - 按原交易时间范围筛选时提供。
                resellerSubMerchantId:
                  type: string
                  description: 代理运营商的子商户标识。
                  x-onerway-condition:
                    - 代理运营商查询其子商户预警记录时提供；普通商户无需传入。
                bin:
                  type: string
                  description: 收单机构 BIN（Bank Identification Number），用于标识为商户提供收单服务的机构。
                  x-onerway-condition:
                    - 按收单机构 BIN 筛选预警记录时提供。
                caid:
                  type: string
                  description: 商户受理标识（CAID，Card Acceptor ID）。
                  x-onerway-condition:
                    - 按商户受理标识筛选预警记录时提供。
                dba:
                  type: string
                  description: 商户对外经营名称（DBA，Doing Business As）。
                  x-onerway-condition:
                    - 按商户经营名称筛选预警记录时提供。
                merchantOrderId:
                  type: string
                  description: 原交易的商户订单号，用于将预警匹配回商户自有订单。
                  x-onerway-condition:
                    - 按原交易商户订单号筛选时提供。
                arn:
                  type: string
                  description: 收单参考号（ARN，Acquirer Reference Number）。
                  x-onerway-condition:
                    - 按收单参考号筛选时提供。
                statusList:
                  type: string
                  description: 按处理状态筛选 RDR 预警案件。
                  enum:
                    - ACCEPTED
                    - DECLINED
                  x-enum-descriptions:
                    ACCEPTED: 已接受。
                    DECLINED: 已拒绝。
                  x-onerway-constraints:
                    - kind: rule
                      text: 指定 `ACCEPTED` 或 `DECLINED`；同时指定两个状态时，以英文逗号分隔。取值区分大小写。
                current:
                  type: string
                  description: 查询页码，从 `1` 开始。
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
              required:
                - merchantNo
                - current
                - sign
            examples:
              query-rdr-alerts:
                summary: 查询 RDR 预警
                value:
                  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
      responses:
        "200":
          description: Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 响应码；`20000`
                      表示查询请求处理成功，其余为错误码。完整码表见[响应码](/zh/payments/api-reference/response-codes)。
                  respMsg:
                    type: string
                    description: 响应码对应的可读说明。
                  data:
                    type: object
                    properties:
                      content:
                        type: array
                        description: 符合查询条件的 RDR 预警案件列表；每条含原交易信息、案件信息与自动处理规则结果。
                        items:
                          type: object
                          properties:
                            merchantNo:
                              type: string
                              description: Onerway 分配的商户号，标识商户账户。
                            caseId:
                              type: string
                              description: RDR 预警案件唯一标识（Case ID）。
                            caseReceivedDate:
                              type: string
                              description: 预警接收时间，格式为 `yyyy-MM-dd HH:mm:ss`。
                            caseType:
                              type: string
                              description: 预警案件类型，标识本条预警的风险来源。
                              enum:
                                - DISPUTE
                                - CANCEL
                                - FRAUD NOTICE
                                - DISPUTE NOTICE
                              x-enum-descriptions:
                                DISPUTE: 拒付争议（已正式发起的争议案件）。
                                CANCEL: 取消请求预警。
                                FRAUD NOTICE: 欺诈预警通知。
                                DISPUTE NOTICE: 拒付预警通知（争议正式发生前的早期提醒）。
                            caseAmount:
                              type: string
                              description: 预警案件金额，即本次争议 / 预警涉及的金额。
                            caseCurrency:
                              type: string
                              description: 预警案件币种，符合 [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes)
                                标准。
                            reasonCode:
                              type: string
                              description: 争议 / 拒付原因代码，由卡组织定义。
                            pricingTier:
                              type: string
                              description: RDR 案件定价层级。
                            caseSource:
                              type: string
                              description: 预警来源。
                            status:
                              type: string
                              description: RDR 预警处理状态，不是数字状态码。
                              enum:
                                - Accepted
                                - Declined
                              x-enum-descriptions:
                                Accepted: 已接受。
                                Declined: 已拒绝。
                            statusCode:
                              type: string
                              description: 与 `status` 配套返回的处理状态代码。
                              x-onerway-constraints:
                                - kind: rule
                                  text: 当前已知 `Accepted` 可返回 `103`，`Declined` 可返回 `900` 或
                                    `957`。该代码仅用于对账和问题排查，不建议仅根据该代码推断具体拒绝原因。
                            ruleType:
                              type: string
                              description: 触发本案件自动处理的 RDR 规则类型。
                            ruleName:
                              type: string
                              description: 触发本案件自动处理的 RDR 规则名称。
                            partnerName:
                              type: string
                              description: RDR 服务使用的合作伙伴名称。
                            partnerId:
                              type: string
                              description: RDR 服务使用的合作伙伴编号。
                            clientName:
                              type: string
                              description: RDR 服务使用的客户名称。
                            clientId:
                              type: string
                              description: RDR 服务使用的客户编号。
                            merchantName:
                              type: string
                              description: RDR 服务使用的商户名称；与 Onerway `merchantNo` 不同。
                            merchantId:
                              type: string
                              description: RDR 服务使用的商户编号；与 Onerway `merchantNo` 不同。
                            mcc:
                              type:
                                - string
                                - "null"
                              description: 商户类别代码（MCC，Merchant Category Code）。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Can return `null`.
                                  zh: 可能返回 `null`。
                            bin:
                              type: string
                              description: 收单机构 BIN（Bank Identification Number），用于标识为商户提供收单服务的机构。
                            caid:
                              type: string
                              description: 商户受理标识（CAID，Card Acceptor ID）。
                            dba:
                              type: string
                              description: 商户对外经营名称（DBA，Doing Business As）。
                            caseDescriptorContact:
                              type: string
                              description: 预警案件的账单描述 / 联系信息。
                              x-onerway-value:
                                empty: true
                                when:
                                  en: Can return an empty string.
                                  zh: 可能返回空字符串。
                            txnTime:
                              type: string
                              description: 原交易时间，格式为 `yyyy-MM-dd HH:mm:ss`。
                            txnAmount:
                              type: string
                              description: 原交易金额。
                            txnCurrency:
                              type: string
                              description: 原交易币种，符合 [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes)
                                标准。
                            caseAuthorizationCode:
                              type: string
                              description: 原交易授权码。
                            merchantOrderId:
                              type: string
                              description: 原交易的商户订单号，用于匹配回商户自有订单。
                            arn:
                              type: string
                              description: 收单参考号（ARN，Acquirer Reference Number）。
                            cardBin:
                              type: string
                              description: 持卡人实际交易卡的 BIN。
                            cardLastFour:
                              type: string
                              description: 原交易卡号后四位。
                            paymentType:
                              type: string
                              description: 支付类型 / 卡组织。
                            resellerSubMerchantId:
                              type: string
                              description: 代理运营商的子商户标识。
                            sign:
                              type:
                                - string
                                - "null"
                              description: 记录级响应签名字符串。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: The record-level signature can return `null`.
                                  zh: 该字段可能返回 `null`。
                      current:
                        type: string
                        description: 当前返回的页码（1-based）。
                      size:
                        type: number
                        description: 当前页的记录数（固定每页 10 条）。
                      totalPages:
                        type: number
                        description: 按当前页大小计算的总页数。
                      totalElements:
                        type: number
                        description: 符合查询条件的预警案件总条数。
                    description: 业务数据对象，包含预警案件列表与分页信息。
```
