Skip to main content

Scoring

Zyphe includes a generalized scoring engine that turns the signals collected during a verification flow into one or more normalized scores. Every score is an integer percentage from 0 to 100, paired with a categorical level (Low, Medium, High, or Critical), and is computed per flow result.

Out of the box, every organization has a default Risk score that consolidates AML screening results, form answers, workflow actions, and manually assigned tags. On top of that, you can define your own custom scores — for example a supplier_risk or onboarding_quality score — each fed by its own set of weighted tags.

A common use of scores is grading form answers: in the form builder you can assign weights to a question's options and answers, and those weights feed the scores computed for the flow result. See Form scoring for how to set it up.

Where score signals come from

Form answers

Weighted score tags and contextual factors attached to form fields in the form builder — see Form scoring

Workflow actions

Tags assigned by the Assign Risk Tags action node in the flow builder

AML screening

The AML risk score computed from sanctions, PEP, and adverse media matches

Manual reviewScore tags assigned or retracted by reviewers directly on a flow result

Score levels

Each score percentage maps to a level using fixed thresholds:

Score rangeLevel
025Low
2650Medium
5175High
76100Critical

In the dashboard, the default Risk score is rendered as a color‑coded badge with its level; custom scores are displayed neutrally as a percentage.

How scoring fits together

  1. Configure — define custom scores and their tags on the Score Definitions page, and attach score weights to form questions in the form builder.
  2. Collect — as the end user completes the verification flow, their answers and the flow's actions emit tags and contextual factors onto the flow result.
  3. Compute — when the flow completes (or is re‑evaluated), each enabled score is calculated from its matched tags, factors, and source scores. See How Scores Are Computed.
  4. Review — reviewers see every computed score on the flow result detail page, can assign or retract tags manually, and can trigger a re‑evaluation. See Reviewing Scores.