Skip to main content

FraudCheckResult

Real-time fraud detection analysis result

blockedboolean

Whether the transaction was blocked (risk_score >= 0.8)

Example: false
risk_scorenumber<double>

Cumulative risk score from all detected signals

Possible values: >= 0 and <= 1

Example: 0.25
risk_levelstring

Risk classification based on score thresholds

Possible values: [low, medium, high, critical]

Example: low
signals object[]

Individual fraud signals detected

  • Array [
  • typestring

    Signal type identifier

    Possible values: [velocity_abuse, velocity_suspicious, impossible_travel, suspicious_travel, bulk_fraud, new_customer, manual_entry, off_hours]

    Example: new_customer
    severitystring

    Signal severity level

    Possible values: [low, medium, high, critical]

    Example: low
    descriptionstring

    Human-readable explanation of the signal

    Example: First verification for this customer
    scorenumber<double>

    Contribution to total risk score

    Example: 0.1
  • ]
  • recommendationstring

    Human-readable action recommendation

    Example: Approve transaction
    FraudCheckResult
    {
    "blocked": false,
    "risk_score": 0.25,
    "risk_level": "low",
    "signals": [
    {
    "type": "new_customer",
    "severity": "low",
    "description": "First verification for this customer",
    "score": 0.1
    }
    ],
    "recommendation": "Approve transaction"
    }