Withdrawal webhook events

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`

{
  "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`

{
  "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

Get Started

Wallets

Exchange

Webhooks

WebSocket

Withdrawal webhook events

`withdrawal.success`

`withdrawal.failed`

​withdrawal.success

​withdrawal.failed

`withdrawal.success`

`withdrawal.failed`