{
"type": "wallet.deposit_account.deposit_failed",
"provider_deposit_id": "dep_abc123",
"deposit_account_id": "dac_xyz789",
"wallet_id": "wlt_abc123",
"deposit_type": "fiat",
"provider": "bridge",
"environment": "sandbox",
"data": {
"destination": {
"asset": "usdc",
"chain": "tempo"
},
"source": {
"amount": "100.00",
"currency": "usd",
"payment_rail": "ach_push"
},
"reason": "Insufficient account balance",
"reason_code": "insufficient_balance",
"refunded_at": "2026-08-25T00:05:00Z",
"created_at": "2026-08-25T00:00:00Z"
}
}Webhooks
Deposit failed
Fired when a fiat deposit into a deposit account could not be processed and the funds were refunded to the sender.
WEBHOOK
wallet.deposit_account.deposit_failed
{
"type": "wallet.deposit_account.deposit_failed",
"provider_deposit_id": "dep_abc123",
"deposit_account_id": "dac_xyz789",
"wallet_id": "wlt_abc123",
"deposit_type": "fiat",
"provider": "bridge",
"environment": "sandbox",
"data": {
"destination": {
"asset": "usdc",
"chain": "tempo"
},
"source": {
"amount": "100.00",
"currency": "usd",
"payment_rail": "ach_push"
},
"reason": "Insufficient account balance",
"reason_code": "insufficient_balance",
"refunded_at": "2026-08-25T00:05:00Z",
"created_at": "2026-08-25T00:00:00Z"
}
}Body
application/json
The type of webhook event.
Available options:
wallet.deposit_account.deposit_failed Available options:
fiat Supported fiat orchestration providers.
Available options:
bridge The Privy API environment.
Available options:
sandbox, production Example:
"sandbox"
Details of a fiat deposit that failed to convert and was refunded to the sender.
Show child attributes
Show child attributes
The deposit's ID in the provider's system (e.g. Bridge), when the provider assigned one.
Response
200
Return a 200 status to indicate that the webhook was received successfully.
Was this page helpful?