# Refund request rejection webhook

> Sent to the original transaction’s notifyUrl only when Onerway rejects a refund request during review (notifyType=REFUND_AUDIT).

```yaml
openapi: 3.1.0
info:
  title: Refund request rejection webhook
  version: 1.0.0
  description: Sent to the original transaction’s notifyUrl only when Onerway
    rejects a refund request during review (notifyType=REFUND_AUDIT).
webhooks:
  refund.audit.rejected:
    post:
      summary: Refund request rejection webhook
      description: Sent to the original transaction’s notifyUrl only when Onerway
        rejects a refund request during review (notifyType=REFUND_AUDIT).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                notifyType:
                  type: string
                  description: Notification category.
                  x-onerway-signature-participation: included
                transactionId:
                  type: string
                  description: Onerway refund transaction number. Return this value unchanged when
                    acknowledging the notification.
                  x-onerway-signature-participation: included
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway.
                  x-onerway-signature-participation: included
                merchantTxnId:
                  type: string
                  description: Merchant transaction number for the refund. Onerway generates it if
                    omitted from the refund request.
                  x-onerway-signature-participation: included
                originMerchantTxnId:
                  type: string
                  description: Merchant transaction number of the original payment.
                  x-onerway-signature-participation: included
                responseTime:
                  type: string
                  description: Time when Onerway generated the notification result, in `yyyy-MM-dd
                    HH:mm:ss` format.
                  x-onerway-signature-participation: included
                txnTimeZone:
                  type: string
                  description: Time zone offset for the transaction times in the notification.
                  x-onerway-signature-participation: included
                orderAmount:
                  type: string
                  description: Transaction amount reported in this notification, expressed in
                    `orderCurrency` as a decimal string.
                  x-onerway-signature-participation: included
                orderCurrency:
                  type: string
                  description: Currency of `orderAmount`.
                  x-onerway-signature-participation: included
                status:
                  type: string
                  description: "Result of the rejected refund request: `F` (failed)."
                  x-onerway-signature-participation: included
                reason:
                  type: string
                  description: Result details encoded as a JSON string containing `respCode` and
                    `respMsg`. When verifying the signature, use the field value
                    as received, without parsing or reserializing its JSON
                    content.
                  x-onerway-signature-participation: included
                sign:
                  type: string
                  description: Legacy body signature, excluded from the signature input. It uses
                    only the first enabled key. Verify the notification using
                    the signature in the `X-Rh-Signature` header.
                  x-onerway-signature-participation: signature-field
            examples:
              refund_rejected:
                summary: Refund request rejected
                value:
                  notifyType: REFUND_AUDIT
                  transactionId: demo_transactionId
                  merchantNo: demo_merchantNo
                  merchantTxnId: demo_merchantTxnId
                  originMerchantTxnId: demo_originMerchantTxnId
                  responseTime: 2026-09-14 00:35:26
                  txnTimeZone: +08:00
                  orderAmount: "593.30"
                  orderCurrency: USD
                  status: F
                  reason: '{"respCode": "70002", "respMsg": "Unknown decline"}'
                  sign: replace_with_signature
      responses:
        "200":
          description: "After receiving and accepting the notification, return HTTP 200
            with `Content-Type: text/plain` and the received `transactionId`
            unchanged in the response body. Without a successful response,
            Onerway retries at 30-minute intervals, up to 3 times."
          content:
            text/plain:
              schema:
                type: string
              examples:
                return_transaction_id:
                  summary: Return transactionId
                  value: demo_transactionId
```
