Skip to main content
Branch on the event name. The tables below group them by resource, which is also how the data payload is shaped.

Sub-client

Subscribe to user.status_changed. It is the one event that fires on every transition. The reasons on user.verification.failed exist nowhere else. No read of the sub-client returns them, so store them when the event arrives. If a delivery to your endpoint failed, you can replay it for 90 days.

Virtual account and deposits

Watch virtual_account.deposit_funds_received rather than the account balance. It is the signal that behaves the same on every rail.

Deprecated deposit events

A refunded deposit used to reach some accounts under one of two other names. Both are still sent, next to virtual_account.deposit_funds_refunded and with an event_id of their own, so a handler that listens for either keeps working. Move it to virtual_account.deposit_funds_refunded. The two below will stop, no earlier than January 15, 2027.
Do not count a refund twice. While the deprecated names are sent, one refund can reach you twice under two different event_id values: on an endpoint subscribed to virtual_account.deposit_funds_refunded and to a deprecated name, and on any endpoint with no event filter. A handler that detects a refund by status: refunded sees both. Act on virtual_account.deposit_funds_refunded only, or key the refund on deposit_id.

Payouts

Subscribe to payout.status_changed. IN_REVIEW and KYT_PENDING reach you on it and on nothing else, so a handler subscribed only to the named events sees a payout leave PROCESSING and never learns where it went.

Requests for information

The item is the unit. A request can carry several, each answered and each returned on its own. Answering one sends you nothing. A URL with no event filter receives rfi.* along with everything else. A URL with a filter receives it only if the filter names these events. Webhooks overview has the subscription rules.

Comparing values

The tables show event names and status values as they arrive. Compare them without case.