Transaction states

Deposit states

Deposits represent funds received into a subaccount, either through wire transfers or blockchain transactions.

State	Description
`pending`	The deposit has been detected and is being processed. For wire deposits, the funds are being received. For crypto deposits, the transaction is awaiting blockchain confirmation.
`complete`	The deposit has been fully processed and the stablecoin balance has been credited to the subaccount.
`failed`	The deposit could not be processed. This can occur if a wire transfer is rejected or a blockchain transaction fails.

Withdrawal states

Withdrawals represent funds sent from a subaccount to an external destination, either through wire transfers or blockchain transactions.

State	Description
`pending`	The withdrawal has been initiated and is being processed. The stablecoin amount is held from the available balance.
`processing`	The withdrawal is actively being executed. For wire withdrawals, the stablecoins are being redeemed and the fiat transfer is being initiated. For crypto withdrawals, the blockchain transaction is being broadcast.
`complete`	The withdrawal has been fully processed. For wire withdrawals, the fiat has been sent. For crypto withdrawals, the blockchain transaction has been confirmed.
`failed`	The withdrawal could not be processed. The held funds are returned to the available balance.

Transfer states

Transfers represent outbound crypto movements to external blockchain addresses.

State	Description
`pending`	The transfer has been initiated and is awaiting processing.
`processing`	The blockchain transaction has been broadcast and is awaiting confirmation.
`complete`	The blockchain transaction has been confirmed and the transfer is finished.
`failed`	The transfer could not be completed. The funds are returned to the available balance.

Transfers vs. withdrawals for crypto operations: A transfer sends stablecoins to an external blockchain address without converting to fiat. A withdrawal redeems stablecoins for fiat currency and sends the fiat through a wire transfer. Outbound crypto operations use the transfer endpoint, while outbound fiat operations use the withdrawal endpoint.

Internal transfer states

Internal transfers move funds between subaccounts in the same program.

State	Description
`complete`	The internal transfer completed instantly. Both the source and destination balances have been updated.
`failed`	The internal transfer could not be processed, typically due to insufficient funds.

Terminal states (complete, failed) are final states that transactions cannot transition out of. Set up webhook notifications to receive real-time updates when transactions reach these states.

Notification events

When a transaction transitions to a new state, Digital Asset Accounts sends a webhook notification. To subscribe, see Set up a webhook endpoint.

Category	Notifications
Deposits	Deposit pending, deposit complete, deposit failed
Withdrawals	Withdrawal pending, withdrawal complete, withdrawal failed
Transfers	Transfer pending, transfer complete, transfer failed
Internal transfers	Internal transfer complete
Wire events	Wire deposit received, wire withdrawal initiated

Mint

StableFX

Digital Asset Accounts

End User Onboarding

Deposit states

Withdrawal states

Transfer states

Internal transfer states

Notification events

​Deposit states

​Withdrawal states

​Transfer states

​Internal transfer states

​Notification events

Deposit states

Withdrawal states

Transfer states

Internal transfer states

Notification events