Skip to main content
Webhooks deliver real-time HTTP POST notifications when events occur in your account, eliminating the need to poll for status changes.

Events

Payload Structure

session.completed

Signature Verification

Every webhook includes an X-Verilock-Signature header with an HMAC-SHA256 signature.
Always verify signatures before processing webhook data. Your webhook secret is available in Dashboard > Settings > Webhooks.

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.