Webhooks (coming soon)

The platform will deliver async events (verification completed, liveness verdict, fraud signal) via signed HTTP webhooks. The webhook subsystem is on the roadmap but not yet shipped — see SP3 in the rebuild roadmap.

When it lands, this section will document:

• Event types and payload shapes
• HMAC signature verification on every delivery
• Per-tenant signing-secret rotation
• Retry policy + dead-letter handling
• Configuring endpoints via the dashboard

Polling alternative

Until webhooks ship, you can poll for results using the read endpoints:

• GET /v1/ocr/:id
• GET /v1/liveness/checks/:id
• GET /v1/face/registrations/:id

Stash the id returned by the original POST and poll until created_at is set or you've waited long enough.

For long-running jobs (video KYC, batch processing), consider the async-jobs subsystem (SP5) — also on the roadmap.