# Configuration — Sanctions sources

### PUQ Sanctions Checker module **[WHMCS](https://puqcloud.com/link.php?id=77)**
##### [Order now](https://puqcloud.com/whmcs-addon-puq-sanctions-checker.php) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Sanctions-Checker/) | [Community](https://community.puqcloud.com/)


**Addons → Sanctions Checker → Configuration → Sanctions sources.** All settings are saved with the green **Save Changes** button; only the license key lives in Setup → Addon Modules.

![Sanctions sources tab — local lists, matching engine, CSL API, blocked countries](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-tqxo3shy.png)

## Local lists (OpenSanctions mirrors)

![Local lists — Canada DFATD-SEMA and EU FSF toggles](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-swhdvwff.png)

Official government sanctions lists mirrored by the [OpenSanctions](https://www.opensanctions.org/) project as clean machine-readable files (~2 MB each). No registration or API key required. The files are imported into your database and matching runs **locally** — no client data leaves your server. Synchronized daily by cron.

## Matching engine

![Matching engine — thresholds for the three matching methods](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-prz4xgsf.png)

| Setting | Default | Description |
| --- | --- | --- |
| Full name match threshold | 85% | Similarity of the whole name required to report a match. |
| Enable trigram matching + threshold | on / 65% | 3-letter-chunk comparison, catches typos and letter swaps. |
| Trigram minimum name length | 6 | Trigrams run only when both names have at least this many letters — short names would match randomly. |
| Enable per-word matching + minimum words | on / 1 | Only the **surname** or a **company word** can trigger a match; a first-name-only hit never flags. Minimum 1 flags surname-only matches (with a lower score); 2 requires first + last name. |
| Word similarity threshold | 85% | How similar two words must be to count as a pair (catches Ivanov / Ivanoff). |

The methods are explained in detail in [How the matching engine works](../06-automation-and-cron/01-matching-engine.md).

## US Consolidated Screening List API

![CSL API — key, endpoint, minimum score](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-flgqv9pq.png)

Real-time fuzzy search against 11 US lists (OFAC SDN, BIS Entity List, State Department). Get a free API key at the [ITA API portal](https://api.trade.gov/apps/store/site/pages/sign-up.html); results below **CSL minimum match score** (default 90) are ignored. Client names are sent to trade.gov over HTTPS.

## Blocked countries

![Blocked countries — comma-separated ISO-2 codes](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-a9jjhfeg.png)

Comma-separated ISO-2 country codes (e.g. `RU,BY,IR,KP,SY,CU`). The country from the client profile is compared against this list; a match is reported with score 100.

<!-- sync:4c2ab8a818987684 -->