provider_deposit_id.
| Event | Fires when |
|---|---|
wallet.deposit_account.deposit_started | Privy can confirm receipt of the deposit in the account, and has initiated the conversion. |
wallet.deposit_account.deposit_completed | Conversion finished and the crypto settled on-chain in the wallet. |
wallet.deposit_account.deposit_failed | Conversion failed and the fiat was refunded to the sender. |
Webhooks can be tested at no cost in development environments. To enable webhooks in production,
upgrade to the Enterprise plan in the Privy Dashboard.
wallet.funds_deposited event when the crypto lands in the wallet.
Every deposit event shares the same envelope, with the stage-specific details under data:
Hide shared attributes
Hide shared attributes
The deposit’s ID in the provider’s system, not a Privy ID. Stable across every event for the
same deposit. Omitted on
deposit_failed when the provider never assigned one.- Deposit started
- Deposit completed
- Deposit failed
Hide data attributes
Hide data attributes
The fiat that was received.
{
"type": "wallet.deposit_account.deposit_started",
"event_id": "evt_xxxxx",
"provider_deposit_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"deposit_account_id": "da_xxxxx",
"wallet_id": "dk3kud7kfo2jcnc5anoovdim",
"deposit_type": "fiat",
"provider": "bridge",
"environment": "production",
"data": {
"source": {
"amount": "1970.00",
"currency": "usd",
"payment_rail": "ach_push",
"sender_name": "John Doe"
},
"destination": {
"asset": "usdc",
"chain": "tempo"
},
"created_at": "2026-08-03T14:30:00Z"
}
}
The completed event carries the same
source as deposit_started, and its destination adds the
delivered crypto amount and the settlement transaction.Hide data attributes
Hide data attributes
The fiat that was deposited, containing
amount, currency, and optionally payment_rail
and sender_name.{
"type": "wallet.deposit_account.deposit_completed",
"event_id": "evt_xxxxx",
"provider_deposit_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"deposit_account_id": "da_xxxxx",
"wallet_id": "dk3kud7kfo2jcnc5anoovdim",
"deposit_type": "fiat",
"provider": "bridge",
"environment": "production",
"data": {
"source": {
"amount": "1970.00",
"currency": "usd",
"payment_rail": "ach_push",
"sender_name": "John Doe"
},
"destination": {
"asset": "usdc",
"chain": "tempo",
"amount": "1968.40",
"transaction_hash": "0xabc123..."
},
"created_at": "2026-08-03T14:32:00Z"
}
}
Hide data attributes
Hide data attributes
The fiat that was refunded, containing
amount, currency, and optionally payment_rail and
sender_name.{
"type": "wallet.deposit_account.deposit_failed",
"event_id": "evt_xxxxx",
"provider_deposit_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"deposit_account_id": "da_xxxxx",
"wallet_id": "dk3kud7kfo2jcnc5anoovdim",
"deposit_type": "fiat",
"provider": "bridge",
"environment": "production",
"data": {
"source": {
"amount": "1970.00",
"currency": "usd",
"payment_rail": "ach_push",
"sender_name": "John Doe"
},
"destination": {
"asset": "usdc",
"chain": "tempo"
},
"reason_code": "conversion_failed",
"reason": "Unable to convert funds — refund initiated",
"refunded_at": "2026-08-03T14:35:00Z",
"created_at": "2026-08-03T14:35:00Z"
}
}
Next steps
Handling webhook events
Configure an endpoint to receive Privy webhook events
Create a deposit account
Provision bank details for a wallet

