Setup
Subscribe to wallet action events from the Configuration > Webhooks page in the Privy Dashboard. For general webhook setup instructions, payload verification, and retry behavior, see the webhooks overview.Webhooks can be tested at no cost in development environments. To enable webhooks in production,
upgrade to the Enterprise plan in the Privy Dashboard.
Statuses
Every wallet action moves through a predictablestatus lifecycle. Privy emits a webhook at each status update.
Action-specific payloads
All wallet action webhook payloads include the following fields. Beyond these, each payload includes fields specific to that action, such as its assets and amounts.
View the payloads for specific wallet actions below. Click the webhook event name to be redirected to its payload schema.
Transfer
Swap
Payout
Payouts move crypto out of the wallet on-chain and then settle fiat at the provider, sosucceeded means the fiat settled, not just that the crypto moved.
failed spans several outcomes that call for different handling, depending on whether the crypto had already left the wallet. See payout failure modes for how to tell them apart, and for the payload fields.

