# Notifications and tracking

Combine signed events with API reads for reliable state handling.

Product: Account API
Guides follow API reference 0.3.0 and event reference 0.2.0.
Canonical page: https://docs.axiym.io/account-api/concepts/notifications-and-tracking

Register webhooks before moving production funds. The Events reference
defines withdrawal, deposit, account, and address-book-entry event payloads. After
confirming a withdrawal, use a resource read as the authoritative state before
advancing a dependent workflow.

For each delivery:

1. verify the Ed25519 signature against the raw request body;
2. deduplicate by event `id`;
3. persist or enqueue the notification;
4. return `2xx` promptly; and
5. fetch the related resource when current state matters.

Use polling and periodic reconciliation as recovery mechanisms. Webhook
delivery is at least once and is not a substitute for authoritative resource
reads.
