Axiym
Implementation Guides

Track a withdrawal

View Markdown

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.

Create and confirm a withdrawal

Prepare a retry-safe withdrawal, then confirm it to begin execution.

Reconcile activity

Join withdrawals, deposits, account movements, events, and external settlement records.

On this page

Processing pattern