Skip to main content

Prevention KPIs

GET /api/v1/merchant/prevention-stats returns aggregated metrics for the assess → case recommendation → outcome loop:
  • assessments — decision counts and block rate
  • case_recommendations — recommendation events, pending without case, auto-created cases
  • outcomes — feedback reported via POST /api/v1/assess/outcome
Requires a secret key (clm_sk_*) with stats:read.

PSP submerchant filter

PSPs can scope KPIs to one child merchant:

Explainability export

For chargebacks, regulatory requests, or internal audit:
CSV export:
The package includes SHA-256 integrity metadata for archival workflows.

Read-only replay

Compare today’s rule set against a historical session without persisting:
Response includes diff.decision_changed, diff.score_delta, and signal codes added/removed.

Operations

Production SQL order and cron monitoring: see docs/PRODUCTION_CORE_LOOP_CHECKLIST.md in the repository.