# Query RDR alerts

> Query RDR alert cases by case identifier, case type, received time, original transaction details, or handling status.

```yaml
openapi: 3.1.0
info:
  title: Query RDR alerts
  version: 1.0.0
  description: Query RDR alert cases by case identifier, case type, received time,
    original transaction details, or handling status.
paths:
  /rdr/agency-cw/detail-page:
    post:
      summary: Query RDR alerts
      description: Query RDR alert cases by case identifier, case type, received time,
        original transaction details, or handling status.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. It limits the query to one
                    merchant account.
                caseId:
                  type: string
                  description: Unique RDR alert case identifier. Submit it to query one case
                    precisely.
                caseTypes:
                  type: string
                  description: Alert case type filter, used to retrieve alerts by risk source.
                  enum:
                    - DISPUTE
                    - CANCEL
                    - FRAUD NOTICE
                    - DISPUTE NOTICE
                  x-enum-descriptions:
                    DISPUTE: Chargeback dispute case.
                    CANCEL: Cancellation request alert.
                    FRAUD NOTICE: Fraud notice alert.
                    DISPUTE NOTICE: Pre-dispute notice alert before a formal dispute occurs.
                  x-onerway-constraints:
                    - kind: rule
                      text: Submit one or more case types. Separate multiple values with commas.
                    - kind: rule
                      text: Use the enum values exactly as listed. `FRAUD NOTICE` and `DISPUTE NOTICE`
                        contain spaces, and `DISPUTE` and `DISPUTE NOTICE` are
                        distinct values.
                caseReceivedDateStart:
                  type: string
                  description: Start of the alert received time range, in `yyyy-MM-dd HH:mm:ss`
                    format.
                  x-onerway-condition:
                    - Provide this field when filtering by alert received time
                      range.
                caseReceivedDateEnd:
                  type: string
                  description: End of the alert received time range, in `yyyy-MM-dd HH:mm:ss`
                    format.
                  x-onerway-condition:
                    - Provide this field when filtering by alert received time
                      range.
                txnTimeStart:
                  type: string
                  description: Start of the original transaction time range, in `yyyy-MM-dd
                    HH:mm:ss` format.
                  x-onerway-condition:
                    - Provide this field when filtering by original transaction
                      time range.
                txnTimeEnd:
                  type: string
                  description: End of the original transaction time range, in `yyyy-MM-dd
                    HH:mm:ss` format.
                  x-onerway-condition:
                    - Provide this field when filtering by original transaction
                      time range.
                resellerSubMerchantId:
                  type: string
                  description: Sub-merchant identifier assigned by the agency operator.
                  x-onerway-condition:
                    - Provide this field when an agency operator queries alert
                      records for its sub-merchants. Regular merchants do not
                      need to submit it.
                bin:
                  type: string
                  description: Acquirer BIN (Bank Identification Number), identifying the
                    institution that provides acquiring services to the
                    merchant.
                  x-onerway-condition:
                    - Provide this field when filtering alert records by
                      acquirer BIN.
                caid:
                  type: string
                  description: Card Acceptor ID (CAID).
                  x-onerway-condition:
                    - Provide this field when filtering alert records by Card
                      Acceptor ID.
                dba:
                  type: string
                  description: Merchant doing-business-as name.
                  x-onerway-condition:
                    - Provide this field when filtering alert records by
                      merchant trading name.
                merchantOrderId:
                  type: string
                  description: Original merchant order ID, used to match the alert back to the
                    merchant order.
                  x-onerway-condition:
                    - Provide this field when filtering by the original merchant
                      order ID.
                arn:
                  type: string
                  description: Acquirer Reference Number (ARN).
                  x-onerway-condition:
                    - Provide this field when filtering by Acquirer Reference
                      Number.
                statusList:
                  type: string
                  description: Filter RDR alert cases by status.
                  enum:
                    - ACCEPTED
                    - DECLINED
                  x-enum-descriptions:
                    ACCEPTED: Accepted.
                    DECLINED: Declined.
                  x-onerway-constraints:
                    - kind: rule
                      text: Specify `ACCEPTED`, `DECLINED`, or both separated by a comma. Values are
                        case-sensitive.
                current:
                  type: string
                  description: Query page number, starting from `1`.
                sign:
                  type: string
                  description: Request signature string. See [Request
                    signing](/payments/get-started/request-signing) for how to
                    generate it.
              required:
                - merchantNo
                - current
                - sign
            examples:
              query-rdr-alerts:
                summary: Query RDR alerts
                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` means the query request was processed successfully. Other
                      values are error codes. See [Response
                      codes](/payments/api-reference/response-codes)."
                  respMsg:
                    type: string
                    description: Human-readable message for the response code.
                  data:
                    type: object
                    properties:
                      content:
                        type: array
                        description: RDR alert cases matching the query conditions. Each record includes
                          original transaction information, case information,
                          and automatic handling rule results.
                        items:
                          type: object
                          properties:
                            merchantNo:
                              type: string
                              description: Merchant number assigned by Onerway, identifying the merchant
                                account.
                            caseId:
                              type: string
                              description: Unique RDR alert case identifier.
                            caseReceivedDate:
                              type: string
                              description: Alert received time in `yyyy-MM-dd HH:mm:ss` format.
                            caseType:
                              type: string
                              description: Alert case type, identifying the risk source of this alert.
                              enum:
                                - DISPUTE
                                - CANCEL
                                - FRAUD NOTICE
                                - DISPUTE NOTICE
                              x-enum-descriptions:
                                DISPUTE: Chargeback dispute case.
                                CANCEL: Cancellation request alert.
                                FRAUD NOTICE: Fraud notice alert.
                                DISPUTE NOTICE: Pre-dispute notice alert before a formal dispute occurs.
                            caseAmount:
                              type: string
                              description: Alert case amount.
                            caseCurrency:
                              type: string
                              description: Alert case currency, using a three-letter [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes)
                                currency code.
                            reasonCode:
                              type: string
                              description: Dispute or chargeback reason code defined by the card network.
                            pricingTier:
                              type: string
                              description: RDR case pricing tier.
                            caseSource:
                              type: string
                              description: Alert source.
                            status:
                              type: string
                              description: RDR alert handling status. This field is not a numeric status code.
                              enum:
                                - Accepted
                                - Declined
                              x-enum-descriptions:
                                Accepted: Accepted.
                                Declined: Declined.
                            statusCode:
                              type: string
                              description: Handling status code returned together with `status`.
                              x-onerway-constraints:
                                - kind: rule
                                  text: Known values include `103` for `Accepted`, and `900` or `957` for
                                    `Declined`. Use this code for reconciliation
                                    and troubleshooting; do not infer a detailed
                                    decline reason from this code alone.
                            ruleType:
                              type: string
                              description: RDR rule type triggered by this case.
                            ruleName:
                              type: string
                              description: RDR rule name triggered by this case.
                            partnerName:
                              type: string
                              description: RDR partner name used by the RDR service.
                            partnerId:
                              type: string
                              description: RDR partner ID used by the RDR service.
                            clientName:
                              type: string
                              description: RDR client name used by the RDR service.
                            clientId:
                              type: string
                              description: RDR client ID used by the RDR service.
                            merchantName:
                              type: string
                              description: RDR merchant name used by the RDR service. This is different from
                                Onerway `merchantNo`.
                            merchantId:
                              type: string
                              description: RDR merchant ID used by the RDR service. This is different from
                                Onerway `merchantNo`.
                            mcc:
                              type:
                                - string
                                - "null"
                              description: Merchant Category Code (MCC).
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Can return `null`.
                                  zh: 可能返回 `null`。
                            bin:
                              type: string
                              description: Acquirer BIN (Bank Identification Number), identifying the
                                institution that provides acquiring services to
                                the merchant.
                            caid:
                              type: string
                              description: Card Acceptor ID (CAID).
                            dba:
                              type: string
                              description: Merchant doing-business-as name.
                            caseDescriptorContact:
                              type: string
                              description: Billing descriptor or contact information for the alert case.
                              x-onerway-value:
                                empty: true
                                when:
                                  en: Can return an empty string.
                                  zh: 可能返回空字符串。
                            txnTime:
                              type: string
                              description: Original transaction time in `yyyy-MM-dd HH:mm:ss` format.
                            txnAmount:
                              type: string
                              description: Original transaction amount.
                            txnCurrency:
                              type: string
                              description: Original transaction currency, using a three-letter [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes)
                                currency code.
                            caseAuthorizationCode:
                              type: string
                              description: Authorization code of the original transaction.
                            merchantOrderId:
                              type: string
                              description: Original merchant order ID, used to match the alert back to the
                                merchant order.
                            arn:
                              type: string
                              description: Acquirer Reference Number (ARN).
                            cardBin:
                              type: string
                              description: BIN of the card used in the original transaction.
                            cardLastFour:
                              type: string
                              description: Last four digits of the original transaction card number.
                            paymentType:
                              type: string
                              description: Payment type or card network.
                            resellerSubMerchantId:
                              type: string
                              description: Sub-merchant identifier assigned by the agency operator.
                            sign:
                              type:
                                - string
                                - "null"
                              description: Record-level response signature string.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: The record-level signature can return `null`.
                                  zh: 该字段可能返回 `null`。
                      current:
                        type: string
                        description: Current returned page number, using 1-based numbering.
                      size:
                        type: number
                        description: Number of records in the current page. The current page size is
                          fixed at 10 records.
                      totalPages:
                        type: number
                        description: Total number of pages based on the current page size.
                      totalElements:
                        type: number
                        description: Total number of RDR alert cases matching the query conditions.
                    description: Business data object containing RDR alert cases and pagination
                      information.
```
