How to register an outbound webhook and verify its signature
Register an https endpoint, test it and verify the HMAC signature on the receiving side.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
Register
Admin → Integrations → Webhooks → New Record (Super Administrator): URL, description, events (payment.verified today). Store the signing secret from the banner.
Test
The row icon "Send a signed test event" delivers a webhook.test event and tells you the real result.
Verify on your server
Compute HMAC-SHA256 of "<X-I8-Timestamp>.<raw body>" with the secret and compare, in constant time, with the X-I8-Signature header (format v1=<hex>). Reject timestamps older than five minutes.
Operate
Failures retry after 1, 5, 30, 120 and 360 minutes and then dead-letter; "Re-queue dead-lettered deliveries" replays them. "Rotate signing secret" invalidates the old secret at once.
Your endpoint receives signed events and rejects tampered or stale ones.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation