---
title: "Refund status update"
method: POST
path: "REFUND_STATUS_UPDATE"
tags: ["Webhooks"]
---

# Refund status update

`POST REFUND_STATUS_UPDATE` (webhook)

Sent when a payin refund's status changes.

## Payload

- object
  - `type` 'REFUND_STATUS_UPDATE', required
  - `data` PaymentPageRefundStatusChangedWebhookData, required — `data` for REFUND_STATUS_UPDATE.
    - `pageId` string, required
    - `refundId` string, required
    - `status` 'new' | 'processing' | 'succeeded' | 'failed', required
    - `refundAmount` number, required
    - `pageAmount` number, required
    - `currency` string, required
    - `pageCurrency` string — Currently in testing and will be enabled for all merchants soon. Please contact our integration team to enable this.
    - `refundCurrency` string — Currently in testing and will be enabled for all merchants soon. Please contact our integration team to enable this.
    - `checkoutPaymentId` string, required
    - `reason` string
    - `operator` string
    - `lastError` string
    - `customer` object
      - `id` string, required
      - `referenceId` string, required
      - `email` string
  - `signature` string, required — Base64-encoded HMAC-SHA256 of the `data` object, signed with your webhook secret. Use it to verify authenticity.

## Acknowledgement `200`

Return any 2xx status to acknowledge receipt. Non-2xx or timeout triggers retries.

---

[API](https://skmtc.dev/breeze/apis/breeze-api.md) · [All operations](https://skmtc.dev/breeze/apis/breeze-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/breeze/breeze-api/revisions/8911892bdf29/schema)