# 查询拒付记录 > 按拒付 ID、交易标识或导入时间范围查询拒付记录。 ```yaml openapi: 3.1.0 info: title: 查询拒付记录 version: 1.0.0 description: 按拒付 ID、交易标识或导入时间范围查询拒付记录。 paths: /v1/chargeback/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#获取凭证)。 chargebackIds: type: string description: 按 Onerway 拒付 ID 批量查询，多个值以英文逗号分隔。 x-onerway-required: conditional x-onerway-condition: - 作为查询条件之一提供；`merchantTxnIds` / `originTransactionIds` / `chargebackIds` / `importTimeStart` + `importTimeEnd` 至少提供一类。 x-onerway-constraints: - kind: range max: 10 unit: 个 ID text: 单次请求最多传入 10 个以英文逗号分隔的 ID。 merchantTxnIds: type: string description: 按商户交易号批量查询拒付记录，多个值以英文逗号分隔。 x-onerway-required: conditional x-onerway-condition: - 作为查询条件之一提供；`merchantTxnIds` / `originTransactionIds` / `chargebackIds` / `importTimeStart` + `importTimeEnd` 至少提供一类。 x-onerway-constraints: - kind: range max: 10 unit: 个 ID text: 单次请求最多传入 10 个以英文逗号分隔的 ID。 originTransactionIds: type: string description: 按发生拒付的原交易（Onerway 交易号）批量查询拒付记录，多个值以英文逗号分隔。 x-onerway-required: conditional x-onerway-condition: - 作为查询条件之一提供；`merchantTxnIds` / `originTransactionIds` / `chargebackIds` / `importTimeStart` + `importTimeEnd` 至少提供一类。 x-onerway-constraints: - kind: range max: 10 unit: 个 ID text: 单次请求最多传入 10 个以英文逗号分隔的 ID。 importTimeStart: type: string description: 时间范围查询的起点，按 Onerway 收到拒付交易的时间过滤，格式 `yyyy-MM-dd HH:mm:ss`。 x-onerway-required: conditional x-onerway-condition: - 作为查询条件之一提供；`merchantTxnIds` / `originTransactionIds` / `chargebackIds` / `importTimeStart` + `importTimeEnd` 至少提供一类。 x-onerway-constraints: - kind: rule text: 按时间范围查询时，须同时提供 `importTimeStart` 与 `importTimeEnd`，二者区间最大 90 天。 importTimeEnd: type: string description: 时间范围查询的终点，格式 `yyyy-MM-dd HH:mm:ss`，应晚于 `importTimeStart`。 x-onerway-required: conditional x-onerway-condition: - 作为查询条件之一提供；`merchantTxnIds` / `originTransactionIds` / `chargebackIds` / `importTimeStart` + `importTimeEnd` 至少提供一类。 x-onerway-constraints: - kind: rule text: 按时间范围查询时，须同时提供 `importTimeStart` 与 `importTimeEnd`，二者区间最大 90 天。 current: type: string description: 查询页码。`0` 和 `1` 都表示第一页；响应中的 `current` 始终从 1 开始计数。 sign: type: string description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。 required: - merchantNo - current - sign examples: query-chargebacks-by-time-range: summary: 按时间范围查询拒付记录 value: current: "1" importTimeEnd: 2026-06-21 23:59:59 importTimeStart: 2026-06-01 00:00:00 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 分配的商户号，标识商户账户。 chargebackId: type: string description: Onerway 生成的拒付交易 ID，以 JSON 字符串返回。与 Onerway 沟通具体拒付案件时引用此 ID。 importTime: type: string description: Onerway 收到该拒付交易的时间，格式 `yyyy-MM-dd HH:mm:ss`。 merchantTxnId: type: string description: 发生拒付的原交易的商户支付订单号（商户系统生成的每笔支付唯一交易标识）。 originTransactionId: type: string description: 发生拒付的原交易 Onerway 交易 ID，以 JSON 字符串返回。 txnAmount: type: string description: 原交易金额，以结算币种计。实际到账 / 结算金额按结算批次结算，以对应批次的结算明细 / 结算报表为准。 txnCurrency: type: string description: 原交易的结算币种，[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 三位字母货币代码。实际结算币种以商户与 Onerway 预先约定的结算配置为准。 txnTime: type: string description: 原交易完成时间，格式 `yyyy-MM-dd HH:mm:ss`。 paymentMethod: type: string description: 原交易使用的支付方式 / 卡品牌。 chargebackAmount: type: string description: 以 `chargebackCurrency` 计价的拒付金额，可能小于或等于原交易金额。 chargebackCurrency: type: string description: 拒付金额币种，通常与原交易币种一致，[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 三位字母货币代码。 chargebackSettleAmount: type: - string - "null" description: 拒付录入时折算至商户结算币种的金额；后续拒付状态变化不会更新此值。 x-onerway-value: nullable: true when: en: May be `null` if no settlement amount was recorded when the chargeback was created, including for historical records. zh: 拒付录入时未记录结算金额的记录（包括历史记录）可返回 `null`。 chargebackSettleCurrency: type: - string - "null" description: 拒付录入时计算 `chargebackSettleAmount` 所用的商户结算币种，[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 三位字母货币代码。 x-onerway-value: nullable: true when: en: May be `null` when no chargeback settlement currency was recorded, including historical records. zh: 未记录拒付结算币种时可返回 `null`，包括历史记录。 chargebackDate: type: string description: 拒付发生日期，即发卡行处理拒付的日期，格式 `yyyy-MM-dd`。 chargebackStatus: type: string description: 拒付的当前处理状态。 enum: - NEW - FA - FAF - FAS - FAT - SA - SAF - SAS - SAT - ACCEPT - REVOKE - DELETE x-enum-descriptions: NEW: 新发起的拒付：持卡人已提交拒付申请；商户应审核并决定接受拒付还是提出申诉。 FA: 首次拒付申诉进行中：卡组织正在处理商户的首次拒付申诉。 FAF: 首次拒付申诉失败：首次申诉被拒绝；商户可能仍可进入仲裁阶段（二次申诉）。 FAS: 首次拒付申诉成功：首次申诉被接受，拒付已撤销、资金已返还。 FAT: 首次拒付申诉超时：首次申诉未在规定期限内完成。 SA: 仲裁中（二次申诉）：首次拒付申诉失败后，已进入仲裁阶段。 SAF: 仲裁失败：商户未获支持，拒付维持。 SAS: 仲裁成功：商户获支持，资金已返还。 SAT: 仲裁阶段（二次申诉）超时：未在规定期限内完成所需回应。 ACCEPT: 接受拒付：商户接受拒付，不提出申诉；交易金额将被扣除。 REVOKE: 拒付已撤销：拒付已被持卡人或发卡行撤回。 DELETE: 拒付记录已删除：拒付记录已从系统中移除。 chargebackReason: type: string description: 拒付原因说明，解释本次拒付发起的具体理由（自由文本，非枚举）。 chargebackArn: type: string description: 拒付对应的收单行参考号（ARN），可用于对账与争议处理。 appealDueTime: type: string description: 申诉截止时间；须在此期限前提交证据以抗辩拒付，格式 `yyyy-MM-dd HH:mm:ss`。 chargebackCode: type: string description: 卡组织规定的拒付原因码。 current: type: string description: 当前返回的页码，从 1 开始计数。 size: type: number description: 当前页的记录数（当前固定每页 10 条）。 totalPages: type: number description: 按当前页大小计算的总页数。 totalElements: type: number description: 符合查询条件的拒付记录总条数。 description: 拒付记录列表与分页信息。 ```