Skip to content
Last updated

Webhooks for multi-currency accounts

Wise provides several webhooks for you to receive notifications about multi-currency account-related events.

Event type Description
transfers#state-changeMonitor state change of a transfer and trigger updates in your UI or other user notifications.
profiles#verification-state-changeMonitors and notifies if the user/profile is not verified initially and becomes verified.
transfers#active-casesMonitors and alerts for any issues with a transfer.
balances#updateMonitors and alerts if any credits or debits are applied to a balance. Useful for when a payin may take time to complete or if being paid from another source.

See our Webhooks guides for details on how to subscribe to webhooks and manage event payloads.

Example payloads

{
  "data": {
    "resource": {
      "type": "transfer",
      "id": 111,
      "profile_id": 222,
      "account_id": 333
    },
    "current_state": "processing",
    "previous_state": "incoming_payment_waiting",
    "occurred_at": "2020-01-01T12:34:56.789Z"
  },
  "subscription_id": "01234567-89ab-cdef-0123-456789abcdef",
  "event_type": "transfers#state-change",
  "schema_version": "4.0.0",
  "sent_at": "2020-01-01T12:34:56.123Z"
}

See the transfer state change event reference for the full schema and details. When subscribing, do so at the application-level.