Events
Payload Structure
session.completed
Signature Verification
Every webhook includes anX-Verilock-Signature header with an HMAC-SHA256 signature.
Retry Policy
Failed deliveries (non-2xx response within 10 seconds) are retried with exponential backoff:
After 3 failed retries, the delivery is marked as failed. View and retry failed deliveries from your dashboard.
Best Practices
Respond immediately
Return
200 as soon as you receive the webhook. Process events asynchronously via a job queue.Idempotency
Store processed
webhook_id values and skip duplicates to ensure exactly-once processing.Verify signatures
Always validate
X-Verilock-Signature using timing-safe comparison before processing any data.
