After initiating a transaction from a custodial wallet, the custodian must first conduct transaction screening and other compliance checks before the transaction is executed and then finalized. The transaction status goes through the following states:Documentation Index
Fetch the complete documentation index at: https://docs.privy.io/llms.txt
Use this file to discover all available pages before exploring further.
| Status | Description |
|---|---|
pending | The transaction request has been forwarded to the custodian and is undergoing processing. |
broadcasted | The transaction has been approved by the custodian and broadcasted to the blockchain. The transaction hash gets populated at this point. |
confirmed | The transaction has been confirmed (terminal state). This state follows the broadcasted state. |
provider_error | The transaction was rejected or encountered an error due to the custodian’s restrictions (terminal state). This state would usually follow the pending state. |
transaction_id to query the transaction status or use webhooks to receive status updates.
Next steps
Transaction webhooks
Monitor transaction status and lifecycle events
Authorization controls
Configure policies and multi-party approvals for custodial wallets