# 查询欺诈通知

> 按通知 ID、欺诈类型、原交易或生成时间范围查询欺诈通知。

```yaml
openapi: 3.1.0
info:
  title: 查询欺诈通知
  version: 1.0.0
  description: 按通知 ID、欺诈类型、原交易或生成时间范围查询欺诈通知。
paths:
  /fraud/list:
    post:
      summary: 查询欺诈通知
      description: 按通知 ID、欺诈类型、原交易或生成时间范围查询欺诈通知。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；获取方式参见[接入准备](/zh/payments/get-started/setup#获取凭证)。
                notificationId:
                  type: string
                  description: 欺诈通知的唯一标识，可按单条欺诈通知精确查询。
                fraudType:
                  type: string
                  description: 欺诈类型，可按欺诈类型筛选欺诈通知。
                  enum:
                    - Lost
                    - Lost Fraud
                    - Stolen
                    - Stolen Fraud
                    - NRI
                    - Never Received Issue
                    - Fraud Application
                    - Fraudulent Application
                    - Counterfeit
                    - Counterfeit Card Fraud
                    - Miscellaneous
                    - Fraudulent Use of Account Number
                    - Card Not Present Fraud
                    - Account Takeover Fraud
                    - First-Party Fraud
                    - Bust-out Collusive Merchant
                    - Incorrect Processing
                    - Merchant Misrepresentation
                    - Manipulation of Account Holder
                    - Manipulation of Cardholder
                    - Modification of Payment Order
                  x-enum-descriptions:
                    Lost: 卡片丢失。
                    Lost Fraud: 涉及遗失卡片的欺诈。
                    Stolen: 卡片被盗。
                    Stolen Fraud: 涉及被盗卡片的欺诈。
                    NRI: 未收到卡片（Never Received Issue）。
                    Never Received Issue: 涉及持卡人未收到的卡片的欺诈。
                    Fraud Application: 欺诈申请。
                    Fraudulent Application: 以欺诈方式申请卡片。
                    Counterfeit: 伪卡。
                    Counterfeit Card Fraud: 伪卡欺诈。
                    Miscellaneous: 其他类型。
                    Fraudulent Use of Account Number: 账号欺诈使用。
                    Card Not Present Fraud: 无卡欺诈。
                    Account Takeover Fraud: 账户盗用欺诈。
                    First-Party Fraud: 第一方欺诈。
                    Bust-out Collusive Merchant: 商户合谋欺诈。
                    Incorrect Processing: 错误处理。
                    Merchant Misrepresentation: 商户虚假陈述。
                    Manipulation of Account Holder: 账户持有人操纵。
                    Manipulation of Cardholder: 持卡人操纵。
                    Modification of Payment Order: 支付指令篡改。
                originTransactionId:
                  type: string
                  description: 原 Onerway 交易 ID，JSON 以 `String` 传输，可按发生欺诈通知的原交易筛选。
                createTimeStart:
                  type: string
                  description: 通知生成时间范围的起点，格式 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-constraints:
                    - kind: rule
                      text: 仅按时间范围查询时，须同时提供 `createTimeStart` 与 `createTimeEnd`，二者区间最大 90 天。
                createTimeEnd:
                  type: string
                  description: 通知生成时间范围的终点，格式 `yyyy-MM-dd HH:mm:ss`，应晚于 `createTimeStart`。
                  x-onerway-constraints:
                    - kind: rule
                      text: 仅按时间范围查询时，须同时提供 `createTimeStart` 与 `createTimeEnd`，二者区间最大 90 天。
                current:
                  type: string
                  description: 查询页码。`0` 和 `1` 都表示第一页；响应中的 `current` 统一返回 1-based 页码。
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
              required:
                - merchantNo
                - current
                - sign
            examples:
              query-fraud-notifications-by-time-range:
                summary: 按时间范围查询欺诈通知
                value:
                  createTimeEnd: 2026-06-21 23:59:59
                  createTimeStart: 2026-06-01 00:00:00
                  current: "1"
                  merchantNo: replace_with_merchant_no
                  sign: "{{SIGN}}"
      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: 符合查询条件的欺诈通知列表，每条为一条欺诈通知。
                        items:
                          type: object
                          properties:
                            merchantNo:
                              type: string
                              description: Onerway 分配的商户号，标识商户账户。
                            notificationId:
                              type: string
                              description: 欺诈通知的唯一标识。
                            fraudType:
                              type: string
                              description: 欺诈类型。
                              enum:
                                - Lost
                                - Lost Fraud
                                - Stolen
                                - Stolen Fraud
                                - NRI
                                - Never Received Issue
                                - Fraud Application
                                - Fraudulent Application
                                - Counterfeit
                                - Counterfeit Card Fraud
                                - Miscellaneous
                                - Fraudulent Use of Account Number
                                - Card Not Present Fraud
                                - Account Takeover Fraud
                                - First-Party Fraud
                                - Bust-out Collusive Merchant
                                - Incorrect Processing
                                - Merchant Misrepresentation
                                - Manipulation of Account Holder
                                - Manipulation of Cardholder
                                - Modification of Payment Order
                              x-enum-descriptions:
                                Lost: 卡片丢失。
                                Lost Fraud: 涉及遗失卡片的欺诈。
                                Stolen: 卡片被盗。
                                Stolen Fraud: 涉及被盗卡片的欺诈。
                                NRI: 未收到卡片（Never Received Issue）。
                                Never Received Issue: 涉及持卡人未收到的卡片的欺诈。
                                Fraud Application: 欺诈申请。
                                Fraudulent Application: 以欺诈方式申请卡片。
                                Counterfeit: 伪卡。
                                Counterfeit Card Fraud: 伪卡欺诈。
                                Miscellaneous: 其他类型。
                                Fraudulent Use of Account Number: 账号欺诈使用。
                                Card Not Present Fraud: 无卡欺诈。
                                Account Takeover Fraud: 账户盗用欺诈。
                                First-Party Fraud: 第一方欺诈。
                                Bust-out Collusive Merchant: 商户合谋欺诈。
                                Incorrect Processing: 错误处理。
                                Merchant Misrepresentation: 商户虚假陈述。
                                Manipulation of Account Holder: 账户持有人操纵。
                                Manipulation of Cardholder: 持卡人操纵。
                                Modification of Payment Order: 支付指令篡改。
                            createTime:
                              type: string
                              description: 欺诈通知生成时间，格式 `yyyy-MM-dd HH:mm:ss`。
                            originTransactionId:
                              type: string
                              description: 该欺诈通知对应的原 Onerway 交易 ID，JSON 以 `String` 传输。
                            txnAmount:
                              type: string
                              description: 源交易金额。实际到账 / 结算金额按结算批次结算，以对应批次的结算明细 / 结算报表为准。
                            cardBrand:
                              type: string
                              description: 源交易使用的卡品牌 / 卡组织。
                            chargebackStatus:
                              type: string
                              description: 源交易的拒付标志。
                              enum:
                                - "0"
                                - "1"
                              x-enum-descriptions:
                                "0": 源交易无拒付。
                                "1": 源交易有拒付。
                              x-onerway-constraints:
                                - kind: consistency
                                  text: 此处为 `0` / `1`
                                    标志，与[查询拒付记录接口](/zh/payments/api-reference/endpoints/query-chargebacks)中表示拒付生命周期阶段的
                                    `chargebackStatus` 语义不同。
                            refundStatus:
                              type: number
                              description: 源交易的退款状态。
                              enum:
                                - "0"
                                - "1"
                                - "2"
                              x-enum-descriptions:
                                "0": 未退款。
                                "1": 全部退款。
                                "2": 部分退款。
                      current:
                        type: string
                        description: 当前返回的页码（1-based）。
                      size:
                        type: number
                        description: 当前页的记录数（当前固定每页 10 条）。
                      totalPages:
                        type: number
                        description: 按当前页大小计算的总页数。
                      totalElements:
                        type: number
                        description: 符合查询条件的欺诈通知总条数。
                    description: 业务数据对象，包含欺诈通知列表与分页信息。
```
