Webhooks

Receive real-time events to update your core, enable payouts or apply limits.

---

Common events

• case.created
• artifact.uploaded
• case.review_required
• case.approved
• case.denied

Example payload

{
  "event": "case.approved",
  "case_id": 12345,
  "tenant_id": 3,
  "score": 86,
  "reasons": ["OCR_OK","AML_CLEAR"],
  "ts": "2026-02-17T22:00:00Z"
}

Signature verification

HMAC signature (example): compute HMAC-SHA256 of the body and compare against X-Verione-Signature header.

// PHP
$body = file_get_contents('php://input');
$sig  = $_SERVER['HTTP_X_VERIONE_SIGNATURE'] ?? '';
$calc = hash_hmac('sha256', $body, getenv('VERIONE_WEBHOOK_SECRET'));
if (!hash_equals($calc, $sig)) { http_response_code(401); exit; }