Guided implementation
From the boundary to a verifiable result.
- 01
Register the endpoint
Use a dedicated HTTPS route. Local, private and insecure targets are rejected.
- 02
Verify raw bytes before parsing
Verify the timestamp and HMAC over the unchanged request body before accepting JSON.
- 03
Process idempotently
Store the event ID. A retry must not create duplicate records or duplicate external effects.
- 04
Test the failure mode
Deliberately test 401, 422, timeout and retry. Sandbox tests are not approval for real production events.
Complete when …
- The signature is verified before JSON
- The event ID is deduplicated
- Retries are bounded
- Monitoring contains no secrets
