# Simulate transfer payout failure

Triggers transfers#payout-failure webhook for the transfer.
The available payout failure reason codes are listed in the [transfers#payout-failure webhook guide](/guides/product/send-money/tracking/payout-failures).
- Simulation requires transfer to be in `bounced_back` state.
- While payout failure simulation call will respond with 200 in real time, the payout failure webhook is asynchronous.

Request body is optional; omit it or send {} to trigger a random failure reason.

Endpoint: POST /simulation/transfers/{transferId}/payout-failure
Security: UserToken

## Path parameters:

  - `transferId` (integer, required)
    The ID of the transfer to simulate.

## Header parameters:

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. [Learn more](/guides/developer/headers/correlation-id).

## Request fields (application/json):

  - `failure_reason_code` (string)
    Failure reason code to trigger for payout failure. When not provided, a failure code is selected at random and returned.

