{
  "id": "evt_wth002",
  "type": "withdrawal.updated",
  "data": {
    "sideshiftAccountId": "user_a1b2c3d4",
    "externalId": "ext_user_456",
    "amountCents": 25000,
    "feeCents": 0,
    "netAmountCents": 25000,
    "currency": "usd",
    "paymentId": "wdrl_abc123",
    "status": "in_transit",
    "metadata": {
      "withdrawalId": "wdrl_abc123",
      "speed": "standard",
      "traceCode": "TRACE12345",
      "estimatedAvailability": "2026-05-13T05:00:00.000Z",
      "destinationInfo": "Chase Bank •••1234",
      "previousStatus": "requested"
    }
  },
  "timestamp": "2026-05-11T12:00:00.000Z"
}

Withdrawalupdated

Sent each time a withdrawal’s status field transitions.

Mirrors the upstream withdrawal.updated event from the underlying payment processor.

Pure metadata refreshes (no status delta) are persisted internally but not relayed — you will only receive an event when the status field actually changes. The previous status is included in metadata.previousStatus.

Lifecycle

requested → awaiting_payment → in_transit → completed
                                          ↘ failed | canceled | denied

Terminal states: completed, failed, canceled, denied. If you only care about terminal success, subscribe to withdrawal.completed instead (derived alias).

WEBHOOK

withdrawal.updated

{
  "id": "evt_wth002",
  "type": "withdrawal.updated",
  "data": {
    "sideshiftAccountId": "user_a1b2c3d4",
    "externalId": "ext_user_456",
    "amountCents": 25000,
    "feeCents": 0,
    "netAmountCents": 25000,
    "currency": "usd",
    "paymentId": "wdrl_abc123",
    "status": "in_transit",
    "metadata": {
      "withdrawalId": "wdrl_abc123",
      "speed": "standard",
      "traceCode": "TRACE12345",
      "estimatedAvailability": "2026-05-13T05:00:00.000Z",
      "destinationInfo": "Chase Bank •••1234",
      "previousStatus": "requested"
    }
  },
  "timestamp": "2026-05-11T12:00:00.000Z"
}

Authorizations

x-api-key

string

header

required

Your SideShift Connect API key (sk_live_* or sk_test_*). Generate from Settings → Connect.

Body

application/json

string

type

string

Example:

"withdrawal.updated"

data

object

Show child attributes

timestamp

string<date-time>

Response

200

Webhook acknowledged

⌘I