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

# Transfer payout failure

`POST transfers#payout-failure` (webhook)

Triggered every time a payout fails. Use this event to get further information about a failed payment.

* Event type: `transfers#payout-failure`
* Profile level subscriptions: Supported
* Application level subscriptions: Supported

**Additional info**:

The [transfers#state-change](/api-reference/webhook-event/eventtransfersstatechange) event provides high level information about the state of transfers, but it doesn't provide details about payout failures.

While a transfer is in `outgoing_payment_sent` state, the payout could fail for certain reasons. Additionally, not every payout failure will trigger a change in transfer state. For example a payout might fail with `MANDATE_NOT_FILLED_IN`, but the corresponding transfer might stay in the same state.

We recommend processing both event types(`transfers#payout-failure` and `transfers#state-change`) separate from each other.

For available failure reason codes and descriptions, see the [Payout failures guide](/guides/product/send-money/tracking/payout-failures). Note that Wise can add new failure codes so your system should be able to handle the events even if the failure reason code is not recognised.

{% admonition type="info" %}
To simulate payout failure in sandbox, use the [payout failure simulation endpoint](/api-reference/simulation/simulationtransferpayoutfailure).
{% /admonition %}

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
  - V4003
    - `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
      - `transfer_id` integer — ID of the transfer.
      - `profile_id` integer — ID of the profile that initiated the transfer.
      - `failure_reason_code` string — Code of the failure error. See [Payout failures](/guides/product/send-money/tracking/payout-failures) for available codes.
      - `failure_description` string — Description of the failure code. See [Payout failures](/guides/product/send-money/tracking/payout-failures) for available descriptions.
      - `occurred_at` string, date-time — When the state change occurred.
  - V2003
    - `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
      - `transfer_id` integer — ID of the transfer.
      - `profile_id` integer — ID of the profile that initiated the transfer.
      - `failure_reason_code` string — Code of the failure error. See [Payout failures](/guides/product/send-money/tracking/payout-failures) for available codes.
      - `failure_description` string — Description of the failure code. See [Payout failures](/guides/product/send-money/tracking/payout-failures) for available descriptions.
      - `occurred_at` string, date-time — When the state change occurred.

## 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)