Handle Webhooks
LiveA production-ready pattern for receiving, verifying, and processing HeartBadge webhooks.
Webhooks are how HeartBadge pushes state changes to your system. Getting them right means verifying signatures, processing idempotently, and surviving the occasional duplicate or out-of-order event.
This page is being written.
The structure is fixed. The prose is being drafted from the source material and reviewed by HeartChain Labs before publication. If you need this information urgently, email docs@heartbadge.com .
What this page will cover
- Endpoint setup and URL registration
- Signature verification step-by-step
- Idempotent processing pattern
- Queue-first: why not to do work in the handler
- Out-of-order event handling
- Retries, dead-letters, and alerting