> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.shimi.cash/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.shimi.cash/_mcp/server.

# Payout Failed (PAYOUT)

POST 

Sent when the bank definitively rejects a payout. **The amount and fee have already been refunded** to your settlement balance when you receive this.

`data.narration` carries the bank's reason. Same fields as **Payout Succeeded**, with `status` = `failed`.

Reference: https://docs.shimi.cash/api-reference/shimi-api/webhooks-youll-receive/payout-failed-payout

## Request

### Payload

- `status` (string, optional)
- `data` (WebhooksPayoutFailedPayoutPayloadContentApplicationJsonSchemaData, optional)

## Types

### WebhooksPayoutFailedPayoutPayloadContentApplicationJsonSchemaData

- `reference` (string, optional)
- `amount` (integer, optional)
- `type` (string, optional)
- `status` (string, optional)
- `narration` (string, optional)
- `source` (string, optional)