> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stabyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Withdrawal webhook events

> Payloads for withdrawal.success and withdrawal.failed.

Withdrawal events are terminal notifications. A newly submitted or pending
withdrawal does not produce a Partner webhook event.

| Event                | When it is sent                                       |
| -------------------- | ----------------------------------------------------- |
| `withdrawal.success` | The withdrawal reached its successful terminal state. |
| `withdrawal.failed`  | The withdrawal reached its failed terminal state.     |

Both events contain a public wallet transaction snapshot under
`data.transaction`.

## `withdrawal.success`

```json theme={null}
{
  "id": "b5be9fe7-f602-5dcc-9f28-985b324c3d39",
  "type": "withdrawal.success",
  "version": 1,
  "occurred_at": "2026-07-17T10:08:12Z",
  "data": {
    "transaction": {
      "id": "019bd2d1-7893-7cda-8944-528b5e9e3318",
      "rail": "fiat",
      "currency": "NGN",
      "tx_type": "withdrawal",
      "status": "success",
      "amount": "75000.00",
      "reference": null,
      "description": null,
      "failure_reason": null,
      "created_at": "2026-07-17T10:04:20+00:00",
      "updated_at": "2026-07-17T10:08:12+00:00",
      "settlement_details": {
        "type": "bank_transfer",
        "rail_reference": "019bd2d1-7893-7cda-8944-528b5e9e3318",
        "confirmed_at": "2026-07-17T10:08:12+00:00",
        "failed_at": null
      }
    }
  }
}
```

## `withdrawal.failed`

```json theme={null}
{
  "id": "886a7af0-c0d9-573d-a42e-1580b2f3184e",
  "type": "withdrawal.failed",
  "version": 1,
  "occurred_at": "2026-07-17T10:11:44Z",
  "data": {
    "transaction": {
      "id": "019bd2d1-846f-727d-9c04-9d2ea226f344",
      "rail": "crypto",
      "currency": "USD",
      "tx_type": "withdrawal",
      "status": "failed",
      "amount": "50.00",
      "reference": null,
      "description": null,
      "failure_reason": "withdrawal_failed",
      "settlement_rail": "USDC",
      "created_at": "2026-07-17T10:10:06+00:00",
      "updated_at": "2026-07-17T10:11:44+00:00",
      "settlement_details": {
        "type": "crypto",
        "rail_reference": "019bd2d1-846f-727d-9c04-9d2ea226f344",
        "blockchain_tx_hash": null,
        "explorer_url": null,
        "sender_address": null,
        "destination_address": null,
        "beneficiary_nickname": null,
        "network": null,
        "network_display": null,
        "principal_amount": null,
        "network_fee": null,
        "block_number": null,
        "confirmations": null,
        "confirmed_at": null,
        "failed_at": "2026-07-17T10:11:44+00:00"
      }
    }
  }
}
```

The webhook snapshot does not expose recipient bank details, destination wallet
addresses, rail references, network fees, or raw failure messages. Use
`data.transaction.id` with
`GET /v1/partner/wallets/transactions/{id}` for the latest public resource.

[Return to the webhook overview](/docs/webhooks)