---
title: "Transfer refund"
method: POST
path: "transfers#refund"
tags: ["webhook-event", "transfer"]
---

# Transfer refund

`POST transfers#refund` (webhook)

This event provides information about refund amount and currency. Triggered every time a transfer's status becomes `funds_refunded`. 
    
* Event type: `transfers#refund`
* Profile level subscriptions: Supported
* Application level subscriptions: Supported

{% admonition type="info" %}
In sandbox, the refund amount in this webhook is simulated. It may not reflect the amount in account balances or the sandbox UI. See [Simulate transfer state change](/api-reference/simulation/simulationtransferstatechange#sandbox-refund) for details about sandbox refund behaviour.
{% /admonition %}

Each event contains a timestamp. Events may not be delivered in the order they occurred. Use `data.occurred_at` to reconcile the order.
See the [Event ordering guide](/guides/developer/webhooks/event-ordering) for details.

See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices.

## Headers

- `X-Signature-SHA256` string
- `X-Delivery-Id` string, uuid
- `X-Test-Notification` boolean

## Payload

- union
  - V4002
    - `schema_version` '4.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event.
    - `event_type` string — Event type identifier.
    - `sent_at` string, date-time — Timestamp when the event was sent.
    - `data` object
      - `resource` object
        - `type` string — Transfer resource type (always `transfer`).
        - `id` integer — ID of the transfer.
        - `profile_id` integer — Identifies the Wise profile associated with this refund.
        - `account_id` integer — ID referring to the initial beneficiary of the payment. The ultimate beneficiary is the sender the funds are being refunded to.
        - `refund_amount` number, double — The total amount that was refunded to the customer. Includes any applicable fees.
        - `refund_currency` string — The three-letter ISO currency code representing the currency in which the refund was issued.
      - `occurred_at` string, date-time — The date and time the refund was triggered.
  - V2002
    - `schema_version` '2.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event.
    - `event_type` string — Event type identifier.
    - `sent_at` string, date-time — Timestamp when the event was sent.
    - `data` object
      - `resource` object
        - `type` string — Transfer resource type (always `transfer`).
        - `id` integer — ID of the transfer.
        - `profile_id` integer — Identifies the Wise profile associated with this refund.
        - `account_id` integer — ID referring to the initial beneficiary of the payment. The ultimate beneficiary is the sender the funds are being refunded to.
        - `refund_amount` number, double — The total amount that was refunded to the customer. Includes any applicable fees.
        - `refund_currency` string — The three-letter ISO currency code representing the currency in which the refund was issued.
      - `occurred_at` string, date-time — The date and time the refund was triggered.

## Acknowledgement `200`

Return any `2xx` status to acknowledge receipt of the event.

- object
  - `status` string

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)