Receiver design
Your webhook endpoint should:- Accept
POSTJSON payloads - Verify signatures before processing
- Return
2xxquickly - Process events idempotently
Delivery model
Webhook systems can produce retries and replayed events. Build handlers so the same event can be received more than once without double fulfillment.Recommended architecture
- Verify signature and timestamp.
- Persist raw event and delivery metadata.
- Acknowledge quickly (
200/204). - Process asynchronously in a job queue.