# Chargeback status change webhook

> Reports chargeback status changes without retries.

```yaml
openapi: 3.1.0
info:
  title: Chargeback status change webhook
  version: 1.0.0
  description: Reports chargeback status changes without retries.
webhooks:
  chargeback.status.changed:
    post:
      summary: Chargeback status change webhook
      description: Reports chargeback status changes without retries.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                notifyType:
                  type: string
                  description: Notification type, fixed to `CHARGEBACK`.
                  enum:
                    - CHARGEBACK
                  x-enum-descriptions:
                    CHARGEBACK: Chargeback status change.
                  x-onerway-signature-participation: included
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway.
                  x-onerway-signature-participation: included
                transactionId:
                  type: string
                  description: Onerway chargeback transaction ID. This identifies the chargeback,
                    not the original payment.
                  x-onerway-signature-participation: included
                originTransactionId:
                  type: string
                  description: Original Onerway payment transaction ID. Excluded from signature
                    calculation.
                  x-onerway-signature-participation: excluded
                originMerchantTxnId:
                  type: string
                  description: Merchant order number of the original payment. Excluded from
                    signature calculation.
                  x-onerway-signature-participation: excluded
                importTime:
                  type: string
                  description: Time when Onerway recorded the chargeback, in `yyyy-MM-dd HH:mm:ss`
                    format.
                  x-onerway-signature-participation: included
                chargebackDate:
                  type: string
                  description: Date when the issuer processed the chargeback, in `yyyy-MM-dd`
                    format.
                  x-onerway-signature-participation: included
                chargebackAmount:
                  type: string
                  description: Chargeback amount in `chargebackCurrency`, expressed as a decimal
                    string.
                  x-onerway-signature-participation: included
                chargebackCurrency:
                  type: string
                  description: Currency of the chargeback amount, usually the same as the original
                    transaction currency.
                  x-onerway-signature-participation: included
                chargebackStatus:
                  type: string
                  description: Chargeback status reported by this notification.
                  enum:
                    - NEW
                    - FA
                    - FAF
                    - FAS
                    - FAT
                    - SA
                    - SAF
                    - SAS
                    - SAT
                    - ACCEPT
                    - REVOKE
                    - DELETE
                  x-enum-descriptions:
                    NEW: New chargeback.
                    FA: First representment in progress.
                    FAF: First representment failed.
                    FAS: First representment succeeded.
                    FAT: The deadline for first representment was missed.
                    SA: Arbitration in progress.
                    SAF: Arbitration unsuccessful for the merchant.
                    SAS: Arbitration successful for the merchant.
                    SAT: The deadline for the arbitration stage was missed.
                    ACCEPT: Chargeback accepted.
                    REVOKE: Chargeback revoked.
                    DELETE: Chargeback record deleted.
                  x-onerway-signature-participation: included
                chargebackArn:
                  type: string
                  description: Acquirer Reference Number (ARN) associated with the chargeback.
                  x-onerway-signature-participation: included
                chargebackCode:
                  type: string
                  description: Chargeback reason code assigned by the card network.
                  x-onerway-signature-participation: included
                chargebackReason:
                  type: string
                  description: Free-text reason for the chargeback.
                  x-onerway-signature-participation: included
                appealReason:
                  type: string
                  description: Review comments on the evidence submitted to dispute the
                    chargeback. This field may be absent when no comments are
                    available.
                  x-onerway-signature-participation: included
                appealDueTime:
                  type: string
                  description: Deadline for submitting evidence, in `yyyy-MM-dd HH:mm:ss` format.
                    For `NEW`, it is the first representment deadline; for
                    `FAF`, it is the deadline for the arbitration stage. This
                    field may be absent in other statuses or when no deadline is
                    available.
                  x-onerway-signature-participation: included
                sign:
                  type: string
                  description: Signature included in the notification body. This field is excluded
                    from signature calculation. Verify the notification using
                    the `X-Rh-Signature` header as described in the signing
                    guide.
                  x-onerway-signature-participation: signature-field
            examples:
              new:
                summary: New chargeback
                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: First representment in progress
                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: First representment failed
                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: First representment succeeded
                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: The deadline for first representment was missed
                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: The deadline for the arbitration stage was missed
                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: Return HTTP 200 with the received `transactionId` as the raw
            response body after the chargeback status change webhook is received
            and accepted. Do not return the fixed example value. Onerway does
            not retry this notification.
          content:
            text/plain:
              schema:
                type: string
              examples:
                return_transaction_id:
                  summary: Return transactionId
                  value: example_chargeback
```
