FraudAlert

Persisted fraud alert for high-risk transactions

idstring<uuid>

Unique alert identifier

Example: 550e8400-e29b-41d4-a716-446655440000

user_idinteger

API user who triggered the alert

Example: 42

customer_idstring

Customer identifier from the verification request

Example: CUST-12345

alert_typestring

Type of transaction that triggered the alert

Possible values: [kyc_verification, collection_registration, location_ping]

Example: kyc_verification

risk_scorenumber<double>

Risk score at time of detection

Possible values: >= 0 and <= 1

Example: 0.85

signalsstring

JSON array of fraud signals (stored as JSONB)

Example: [{"type":"velocity_abuse","severity":"critical","description":"Customer verified 5 times in 15 minutes","score":0.8}]

blockedboolean

Whether the transaction was blocked

Example: true

review_statusstring

Admin review status

Possible values: [pending, confirmed, false_positive]

Example: pending

created_atstring<date-time>

When the alert was created

Example: 2024-01-15T14:30:00Z

FraudAlert

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": 42,
  "customer_id": "CUST-12345",
  "alert_type": "kyc_verification",
  "risk_score": 0.85,
  "signals": "[{\"type\":\"velocity_abuse\",\"severity\":\"critical\",\"description\":\"Customer verified 5 times in 15 minutes\",\"score\":0.8}]",
  "blocked": true,
  "review_status": "pending",
  "created_at": "2024-01-15T14:30:00Z"
}