# Track a withdrawal

Follow withdrawal processing with signed events and current API state.

Product: Account API
Guides follow API reference 0.3.0 and event reference 0.2.0.
Canonical page: https://docs.axiym.io/account-api/integration-guide/track-a-withdrawal

Use webhooks for prompt notification and `GET /withdrawals/{withdrawalId}` for
authoritative current state.

A newly created withdrawal remains `PENDING_CONFIRMATION` until you call the
confirmation endpoint. After confirmation returns `PENDING`, track the
withdrawal until it reaches a terminal outcome.

## Processing pattern

1. Verify and deduplicate the event.
2. Persist the notification and acknowledge it promptly.
3. Fetch the withdrawal using its `withdrawalId`.
4. Update your workflow from the current resource.
5. Preserve `reasonCode`, `transactionHash`, payment `code`, and other outcome
   details needed for support and reconciliation.

Do not infer completion from successful withdrawal creation or confirmation.
Continue until the current resource reaches a terminal outcome supported by
your workflow.