Webhooks

Recibe eventos en tiempo real para actualizar tu core, habilitar pagos o activar límites.

Eventos comunes

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

Payload ejemplo

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

Validación de firma

Firma HMAC (ejemplo): calcula HMAC-SHA256 del body y compara con header X-Verione-Signature.

// 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; }