Go to app →
Help Center/Scoring & risk rules/Creating rules
Scoring & risk rules

Creating rules

Country, MCC, and NAICS rule types, match values, priority, and reason templates.

Rules are what turn a raw country, MCC, or NAICS value into a risk tier. Each rule ties one match value to one risk category — the category's color is what gets fed into worst-tier-wins scoring whenever that value shows up on a record.

You need at least one risk category before you can create a rule — a rule always points at a category, it doesn't carry a color of its own.

Steps

1
Go to Rules and choose a type

Open the Rules tab and switch between the Country, MCC, and NAICS sub-tabs. Each type is managed separately.

2
Enter the match value

For a country rule, that's a country (e.g. Iran). For MCC, a merchant category code (e.g. 7995 for gambling). For NAICS, an industry code. This is compared exactly against the value on the scored record.

3
Pick the risk category

Choose which of your risk categories this rule maps to. Its color is what the rule contributes to scoring.

4
Set a priority

Priority is a tie-breaker. If more than one rule of the same type could apply to a given value, the rule with the higher priority wins and is the one whose category and reason are used. If you only ever have one rule per value, priority doesn't matter — it exists for organizations with broader, overlapping rules (e.g. a regional rule and a country-specific override).

5
Write a reason template (optional)

Free text shown as the explanation whenever this rule matches and drives the result — e.g. "High-risk jurisdiction per FATF list". Reps see this on the CRM record, and it's recorded in the Audit log. If you leave it blank, a generic reason is shown instead.

6
Save

The rule takes effect immediately for any new score — it doesn't retroactively re-score existing CRM records.

Adding many rules at once

Typing rules in one at a time doesn't scale if you're loading an existing risk list. See Bulk-importing rules to upload a CSV or XLSX file instead.

Checking your work

After creating or changing a rule, use the Score tester to confirm it produces the tier and reason you expect before relying on it for real records.