Confidence scoring

Confidence scores indicate the reliability of an automated match on a scale of 0-100. Higher scores mean greater certainty that two transactions represent the same financial event.

Overview

When Matcher identifies a potential match, it assigns a confidence score based on multiple factors. This score defines how Matcher handles the match:

High scores (90+) are auto-approved
Mid-range (60 – 89) scores require review

Matcher Confidence Scoring — Matcher confidence scoring.

Score components

Matcher uses a weighted scoring system with four components. The amount, currency, and date components each score a full match (1.0) or no match (0.0). The reference component does the same for EXACT, TOLERANCE, and DATE_LAG rules. For FUZZY rules, it scores the graded reference similarity, from 0.0 to 1.0.

Component	Weight	Points (match / no match)
Amount match	40%	40 / 0
Currency match	30%	30 / 0
Date proximity	20%	20 / 0
Reference match	10%	10 / 0

On a proposed match, the amount and date components always score their full points. A rule that checks them rejects a pair that fails them. A rule that does not check them scores them as matched. Only the currency and reference components can lower the score.

Amount match (40%)

The amount component has the highest weight because amount discrepancies often indicate different transactions.

Condition	Score
Amounts match (within rule tolerance)	40 points
Amounts do not match	0 points

Amount matching depends on the active rule type. An EXACT rule requires identical amounts. A TOLERANCE rule allows variance within the configured percentTolerance and absTolerance.

Currency match (30%)

Currency verification is binary. Currencies either match or they don’t.

Condition	Score
Same currency	30 points
Different currency	0 points

Date proximity (20%)

Date scoring checks whether the transaction dates fall within the configured window.

Condition	Score
Dates within allowed window	20 points
Dates outside allowed window	0 points

The allowed window depends on the rule. An EXACT rule requires the same date, and it respects datePrecision. A DATE_LAG rule accepts a day difference inside its [minDays, maxDays] band. The inclusive flag controls whether minDays and maxDays themselves count.

Reference match (10%)

For EXACT and TOLERANCE rules, reference comparison is binary, and matchReference is on by default. With matchReference off, an EXACT rule scores the full 10 points and a TOLERANCE rule scores 0.

Condition	Score
References match (exact or case-insensitive)	10 points
Both references absent	10 points (unless the rule sets `referenceMustSet`, which scores any absent reference as 0)
References do not match, or only one is absent	0 points

FUZZY rules score the reference on a continuous scale. For a FUZZY rule, the 10% reference slot carries a graded ReferenceScore between 0.0 and 1.0. This value is a similarity measure, not a strict 0/1. A near-identical reference contributes close to the full 10 points while one that barely clears the fuzzy gate contributes proportionally less. As a result, FUZZY matches can produce non-multiple-of-10 scores such as 97 or 99. See Possible scores below.

DATE_LAG rules do not score references. For DATE_LAG rules the ReferenceScore is always 0.0, so the 10% reference component contributes 0 points regardless of the reference values. The maximum DATE_LAG score is therefore 90 (40 + 30 + 20 + 0), which is the auto-confirm threshold.

Calculation formula

The confidence score formula:

confidence = round(
  (amountMatch × 0.40 +
   currencyMatch × 0.30 +
   dateMatch × 0.20 +
   referenceScore × 0.10) × 100
)

amountMatch, currencyMatch, and dateMatch are each 1.0 (match) or 0.0 (no match). referenceScore is between 0.0 and 1.0. The weights are hardcoded constants and are not configurable per context.

Possible scores

For EXACT, TOLERANCE, and DATE_LAG rules, every component is binary, so a proposed match scores one of these values: 60, 70, 90, 100 A DATE_LAG match scores 60 or 90, because its reference component is always 0. An FX rate-variance match has a fixed score of 75. See Multi-currency matching. For FUZZY rules this does not hold. Because the reference component is a continuous ReferenceScore (0.0–1.0), FUZZY matches can produce intermediate scores such as 97 or 99. Regardless of the resulting score, a FUZZY match is never auto-confirmed. See FUZZY matches never auto-confirm.

Calculation examples

Exact match (score: 100)

Two transactions with identical values on the same day:

Component	Comparison	Points
Amount	$1,000.00 vs$ 1,000.00 ✓	40
Currency	USD vs USD ✓	30
Date	2024-01-15 vs 2024-01-15 ✓	20
Reference	PAY-001 vs PAY-001 ✓	10

Final Score: 100 → Auto-confirmed

High confidence match (score: 90)

Amount, currency, and date match. The rule is DATE_LAG, or TOLERANCE with matchReference off, so the reference scores 0:

Component	Comparison	Points
Amount	$1,000.00 vs$ 1,000.00 ✓	40
Currency	USD vs USD ✓	30
Date	2024-01-15 vs 2024-01-15 ✓	20
Reference	PAY-001 vs — ✗	0

Final Score: 90 → Auto-confirmed

Medium confidence (score: 70)

Amount, date, and reference match. The currencies differ, and the rule does not check currency:

Component	Comparison	Points
Amount	1,000.00 vs 1,000.00 ✓	40
Currency	USD vs EUR ✗	0
Date	2024-01-15 vs 2024-01-15 ✓	20
Reference	PAY-001 vs PAY-001 ✓	10

Final Score: 70 → Needs review

Confidence tiers

Matcher categorizes matches into tiers based on score:

Tier (score)	System behavior
Auto-Approved (≥ 90)	Automatically confirmed, except FUZZY matches, which require manual review
Needs Review (60-89)	Queued for manual review

Every proposed match scores at least 60, because the amount and date components always score their full points on a proposal.

How confidence tiers are applied

When Matcher proposes a match, it evaluates the confidence score and applies the following steps:

If the score is 90 or higher, Matcher confirms the match automatically, except for FUZZY matches, which always require manual review.
If the score is between 60 and 89, Matcher queues the match for manual review.

FUZZY matches never auto-confirm

Matches produced by FUZZY rules are never auto-confirmed, regardless of their confidence score. Even a FUZZY match scoring 90 or above is always queued for manual review. A fuzzy reference only contributes the 10% reference slot, so the financial fields (amount + currency + date) alone can already reach the 90 threshold. Capping FUZZY below auto-confirm guarantees that a human reviews the fuzzed reference before the match is committed.

Confidence thresholds

Matcher uses fixed thresholds to determine how it handles matches:

Threshold	Score	Behavior
Auto-confirm	>= 90	Match is automatically confirmed
Match	>= 60	Match is proposed for manual review

These thresholds are not configurable per context.

Weights

The component weights (40/30/20/10) are hardcoded constants. You cannot adjust them per context or per rule.

Component	Weight	Rationale
Amount	40%	Amount is the strongest indicator of a valid match
Currency	30%	Currency mismatch usually means different transactions
Date	20%	Date proximity adds confidence but allows for settlement delays
Reference	10%	References are helpful but often missing or inconsistent

Best practices

Monitor tier distribution

Track the percentage of transactions in each tier. Unusual shifts may indicate data quality issues or rule misconfiguration.

Use dry-run mode to test rules

Since confidence depends on which rules match, always dry-run rule changes before committing. This prevents unexpected increases in manual review volume.

Understand scores as rule outcomes

For EXACT, TOLERANCE, and DATE_LAG rules, scoring is binary. A score of 70 means that amount, date, and reference matched and currency did not. A score of 90 means that the reference scored 0. Use this to diagnose matching issues.FUZZY rules are the exception. Their graded reference component can yield intermediate scores (e.g. 97). Read a FUZZY score as “financial fields matched plus a partial reference similarity.”

Overview

Guides

Matcher UI

MCP Server

Operations

Confidence scoring

Overview

Score components

Amount match (40%)

Currency match (30%)

Date proximity (20%)

Reference match (10%)

Calculation formula

Possible scores

Calculation examples

Exact match (score: 100)

High confidence match (score: 90)

Medium confidence (score: 70)

Confidence tiers

How confidence tiers are applied

FUZZY matches never auto-confirm

Confidence thresholds

Weights

Best practices

Next steps

Match Rules

Multi-Currency

​Overview

​Score components

​Amount match (40%)

​Currency match (30%)

​Date proximity (20%)

​Reference match (10%)

​Calculation formula

​Possible scores

​Calculation examples

​Exact match (score: 100)

​High confidence match (score: 90)

​Medium confidence (score: 70)

​Confidence tiers

​How confidence tiers are applied

​FUZZY matches never auto-confirm

​Confidence thresholds

​Weights

​Best practices

​Next steps

Match Rules

Multi-Currency

Overview

Score components

Amount match (40%)

Currency match (30%)

Date proximity (20%)

Reference match (10%)

Calculation formula

Possible scores

Calculation examples

Exact match (score: 100)

High confidence match (score: 90)

Medium confidence (score: 70)

Confidence tiers

How confidence tiers are applied

FUZZY matches never auto-confirm

Confidence thresholds

Weights

Best practices

Next steps