Skip to main content

Advanced Configuration

Risk Scoring Matrix​

Customize how risk scores are calculated based on different failure modes.

options.RiskScoring = new RiskScoringConfig
{
    Weights = new Dictionary<string, int>
    {
        { "DocumentValidity", 40 },
        { "FaceMatch", 30 },
        { "WatchlistHit", 100 } // Instant fail
    },
    Thresholds = new RiskThresholds
    {
        AutoApproveBelow = 10,
        ManualReviewBetween = new Range(10, 80),
        AutoRejectAbove = 80
    }
};

Webhook Integration​

Receive real-time updates when verification status changes.

options.Webhooks.CallbackUrl = "https://api.yourdomain.com/callbacks/kyc";
options.Webhooks.Secret = "whsec_...";
options.Webhooks.Events = new[] { "verification.completed", "verification.failed" };

Payload Example​

{
  "event": "verification.completed",
  "sessionId": "KYC-123456",
  "referenceId": "USER-789",
  "status": "Verified",
  "riskScore": 5,
  "timestamp": "2026-01-12T10:00:00Z"
}