PUQ Sanctions Checker WHMCS Module

PUQ Sanctions Checker is an enterprise-grade WHMCS addon module designed to automate compliance, prevent fraud, and secure your hosting business. It screens clients against international sanctions lists, national blocklists, and fraud databases in real time or via a background queue.

The module is built with a full-AJAX administrative interface and integrates directly into WHMCS admin workflows (such as client profiles and ticket creation) without requiring page reloads or interrupting the customer registration process.

Key Features & Capabilities

1. Intelligent Three-Method Matching Engine

To prevent evasion while minimizing false positives, the module features a sophisticated, configurable matching engine:

• Trigram Matching: Compares name subsequences to handle typos, spelling differences, and transliteration variations (e.g., matching Дмитрий to Dmitriy or Dmitry).
• Per-Word Matching: Analyzes individual words in names to catch middle names, reverse name orders, and surname-only lists.
• Exact Matching: Fast lookup of exact spelling matches.
• Adjustable Thresholds: Custom percentage scores can be defined for trigram and per-word matching methods to fine-tune the screening sensitivity.

2. Multi-Source Sanctions Screening

Clients are matched against multiple authoritative databases simultaneously:

• US Consolidated Screening List (CSL): Direct, real-time API queries combining 11 US government lists (including OFAC SDN, State Department, and BIS Entity Lists).
• EU Financial Sanctions Files (FSF): Synced daily and mirrored locally into the WHMCS database from OpenSanctions.
• Canada DFATD-SEMA List: Canada's Special Economic Measures Act sanctions, mirrored locally.
• Country Blocklist: Customizable country blocklist matching against ISO-2 country codes.

3. Integrated Fraud Check (FraudRecord & IPQualityScore)

In addition to sanctions screening, the module performs real-time fraud checks:

• Live lookup of client details against FraudRecord and IPQualityScore.
• Injects live fraud scores, IP risk ratings, and email compromise alerts directly into the WHMCS client profile page.
• Direct Abuse Reporting form within the WHMCS admin card to submit reports to fraud services with one click.

4. Background Queue & Cron Automation

To ensure that client checkouts, registration, and profile edits remain fast, the module utilizes a background queue:

• Asynchronous Execution: Instead of waiting for external APIs during checkout, checks are enqueued and processed asynchronously by the background cron.
• Scheduled Mass Re-checks: Set the module to automatically re-screen your entire active client base on a daily, weekly, or monthly schedule.
• Real-time Fallback: If the background queue ever fails, the module falls back to real-time screening to guarantee that no screening is missed.

5. Verification (Whitelist) Workflow

Manage false positives easily with a structured verification system:

• Mark checked clients as Verified to bypass subsequent automated checks during orders or mass cron sweeps.
• Admin Audit Trail: The module records a snapshot of the verifying administrator (ID, username, email, time) and displays it inside the verification badges.
• Automatic Reset: If a verified client edits their profile, their verified status is automatically reset and they are re-queued for checking.

6. Interactive Admin Console

• Dashboard Overview: Live counter cards showing total checks, matching records, whitelist statistics, and sync states.
• List Entries Browser: Full-featured search and filtering tool to inspect exact names and raw entities mirrored from OpenSanctions.
• Direct Entity Links: All matching results link directly to the corresponding OpenSanctions entity profiles for rapid manual audit.
• Database Schema Verification: Built-in declarative schema validator checks and updates missing DB tables and columns non-destructively in one click.

Important Links

• https://puqcloud.com/whmcs-addon-puq-sanctions-checker.php](https://puqcloud.com/whmcs-addon-puq-sanctions-checker.php
• https://doc.puq.info/books/sanctions-checker-whmcs-addon](https://doc.puq.info/books/sanctions-checker-whmcs-addon
• https://github.com/puqcloud/WHMCS-Addon-PUQ-Sanctions-Checker](https://github.com/puqcloud/WHMCS-Addon-PUQ-Sanctions-Checker
• https://puqcloud.com/submitticket.php?step=2&deptid=1](https://puqcloud.com/submitticket.php?step=2&deptid=1