# 拒付状态变化通知

> 通知拒付状态变化，不进行重试。

```yaml
openapi: 3.1.0
info:
  title: 拒付状态变化通知
  version: 1.0.0
  description: 通知拒付状态变化，不进行重试。
webhooks:
  chargeback.status.changed:
    post:
      summary: 拒付状态变化通知
      description: 通知拒付状态变化，不进行重试。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                notifyType:
                  type: string
                  description: 通知类型，固定为 `CHARGEBACK`。
                  enum:
                    - CHARGEBACK
                  x-enum-descriptions:
                    CHARGEBACK: 拒付状态变化。
                  x-onerway-signature-participation: included
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号。
                  x-onerway-signature-participation: included
                transactionId:
                  type: string
                  description: Onerway 拒付交易 ID，标识本次拒付，不是原支付交易 ID。
                  x-onerway-signature-participation: included
                originTransactionId:
                  type: string
                  description: 原支付交易的 Onerway 交易 ID，不参与签名计算。
                  x-onerway-signature-participation: excluded
                originMerchantTxnId:
                  type: string
                  description: 原支付交易的商户订单号，不参与签名计算。
                  x-onerway-signature-participation: excluded
                importTime:
                  type: string
                  description: Onerway 记录本次拒付的时间，格式为 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-signature-participation: included
                chargebackDate:
                  type: string
                  description: 发卡机构处理拒付的日期，格式为 `yyyy-MM-dd`。
                  x-onerway-signature-participation: included
                chargebackAmount:
                  type: string
                  description: 拒付金额，以十进制字符串表示，币种见 `chargebackCurrency`。
                  x-onerway-signature-participation: included
                chargebackCurrency:
                  type: string
                  description: 拒付金额的币种，通常与原交易币种一致。
                  x-onerway-signature-participation: included
                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: 拒付记录已删除。
                  x-onerway-signature-participation: included
                chargebackArn:
                  type: string
                  description: 拒付关联的收单参考号（ARN）。
                  x-onerway-signature-participation: included
                chargebackCode:
                  type: string
                  description: 卡组织规定的拒付原因码。
                  x-onerway-signature-participation: included
                chargebackReason:
                  type: string
                  description: 拒付原因说明，为自由文本。
                  x-onerway-signature-participation: included
                appealReason:
                  type: string
                  description: 拒付申诉的审核意见；无审核意见时，该字段可能不出现。
                  x-onerway-signature-participation: included
                appealDueTime:
                  type: string
                  description: 提交申诉资料的截止时间，格式为 `yyyy-MM-dd HH:mm:ss`。`NEW` 时为首次拒付申诉截止时间，`FAF`
                    时为仲裁阶段截止时间；其他状态或无截止时间时，该字段可能不出现。
                  x-onerway-signature-participation: included
                sign:
                  type: string
                  description: 通知体中的签名值。该字段本身不参与签名计算。请按签名指南使用 `X-Rh-Signature` 请求头验签。
                  x-onerway-signature-participation: signature-field
            examples:
              new:
                summary: 新发起的拒付
                value:
                  notifyType: CHARGEBACK
                  merchantNo: example_merchant
                  transactionId: example_chargeback
                  originTransactionId: example_payment
                  originMerchantTxnId: example_order
                  importTime: 2026-09-18 00:29:49
                  chargebackDate: 2026-09-18
                  chargebackAmount: "10.00"
                  chargebackCurrency: USD
                  chargebackStatus: NEW
                  chargebackArn: example_arn
                  chargebackCode: "13.1"
                  chargebackReason: Merchandise/Services Not Received
                  sign: replace_with_signature
                  appealDueTime: 2026-09-26 00:29:49
              fa:
                summary: 首次拒付申诉进行中
                value:
                  notifyType: CHARGEBACK
                  merchantNo: example_merchant
                  transactionId: example_chargeback
                  originTransactionId: example_payment
                  originMerchantTxnId: example_order
                  importTime: 2026-09-18 00:29:49
                  chargebackDate: 2026-09-18
                  chargebackAmount: "10.00"
                  chargebackCurrency: USD
                  chargebackStatus: FA
                  chargebackArn: example_arn
                  chargebackCode: "10.4"
                  chargebackReason: 其他欺诈–无卡环境
                  sign: replace_with_signature
              faf:
                summary: 首次拒付申诉失败
                value:
                  notifyType: CHARGEBACK
                  merchantNo: example_merchant
                  transactionId: example_chargeback
                  originTransactionId: example_payment
                  originMerchantTxnId: example_order
                  importTime: 2026-09-18 00:29:49
                  chargebackDate: 2026-09-18
                  chargebackAmount: "10.00"
                  chargebackCurrency: USD
                  chargebackStatus: FAF
                  chargebackArn: example_arn
                  chargebackCode: "13.1"
                  chargebackReason: Merchandise/Services Not Received
                  sign: replace_with_signature
                  appealDueTime: 2026-09-26 14:17:11
                  appealReason: Dispute not remedied.
              fas:
                summary: 首次拒付申诉成功
                value:
                  notifyType: CHARGEBACK
                  merchantNo: example_merchant
                  transactionId: example_chargeback
                  originTransactionId: example_payment
                  originMerchantTxnId: example_order
                  importTime: 2026-09-18 00:29:49
                  chargebackDate: 2026-09-18
                  chargebackAmount: "0.00"
                  chargebackCurrency: USD
                  chargebackStatus: FAS
                  chargebackArn: example_arn
                  chargebackCode: "4853"
                  chargebackReason: Cardholder Dispute - Defective/Not as Described
                  sign: replace_with_signature
                  appealReason: Dispute not remedied
              fat:
                summary: 首次拒付申诉超时
                value:
                  notifyType: CHARGEBACK
                  merchantNo: example_merchant
                  transactionId: example_chargeback
                  originTransactionId: example_payment
                  originMerchantTxnId: example_order
                  importTime: 2026-09-18 00:29:49
                  chargebackDate: 2026-09-18
                  chargebackAmount: "10.00"
                  chargebackCurrency: USD
                  chargebackStatus: FAT
                  chargebackArn: example_arn
                  chargebackCode: C42
                  chargebackReason: Card Not Present Transaction
                  sign: replace_with_signature
              sat:
                summary: 仲裁阶段超时
                value:
                  notifyType: CHARGEBACK
                  merchantNo: example_merchant
                  transactionId: example_chargeback
                  originTransactionId: example_payment
                  originMerchantTxnId: example_order
                  importTime: 2026-09-18 00:29:49
                  chargebackDate: 2026-09-18
                  chargebackAmount: "10.00"
                  chargebackCurrency: EUR
                  chargebackStatus: SAT
                  chargebackArn: example_arn
                  chargebackCode: "4837"
                  chargebackReason: No Cardholder Authorization
                  sign: replace_with_signature
                  appealReason: The merchant's response does not remedy the dispute.
      responses:
        "200":
          description: 成功接收并受理拒付状态变化通知后返回 HTTP 200，并在响应体中原样返回收到的
            `transactionId`。请勿固定返回示例值。Onerway 不重试此通知。
          content:
            text/plain:
              schema:
                type: string
              examples:
                return_transaction_id:
                  summary: 返回 transactionId
                  value: example_chargeback
```
