> For the complete documentation index, see [llms.txt](https://docs.shredpay.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shredpay.xyz/developers/webhooks/overview.md).

# Overview

Outline:

* Why webhooks (push vs. poll for transaction state).
* How to register a URL in the Agent Console.
* Delivery semantics: at-least-once, ordered per-resource, retried with exponential backoff.
* Required HTTP response (`2xx` within 5 seconds).
* Best practices: respond fast, queue work, dedupe by `event_id`.

See [Signature Verification](/developers/webhooks/signature-verification.md) for security and [Events](/developers/webhooks/events.md) for the catalog.