=== Brilliant Fraud Checker ===
Contributors: brilliantsofts
Tags: woocommerce, fraud, courier, checkout, shipping
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://www.brilliantsofts.com/

Detect high-risk WooCommerce COD orders. Prevent failed shipping costs by checking customer courier delivery success rates before shipping.

== Third-Party Service Disclosure ==

This plugin integrates with the Brilliant Fraud Checker SaaS service (https://fraudchecker.brilliantsofts.com/) to perform courier history and risk analysis. The plugin transmits the customer's billing phone number to the Brilliant Fraud Checker API to retrieve their delivery success rate.

* Brilliant Fraud Checker Service: https://fraudchecker.brilliantsofts.com/
* Terms of Service: https://fraudchecker.brilliantsofts.com/terms
* Privacy Policy: https://fraudchecker.brilliantsofts.com/privacy
* Refund & Cancellation Policy: https://fraudchecker.brilliantsofts.com/refunds

== Description ==

Brilliant Fraud Checker is a WooCommerce plugin designed to help store owners evaluate Cash-on-Delivery (COD) shipping risks. It integrates into your WooCommerce orders list and order details to display a buyer's historical courier shipping records (including delivered vs returned parcel ratios) in real-time based on their billing phone number.

Directly inside your WooCommerce dashboard, the plugin displays:
* Total historical shipping records.
* Completed/Delivered parcel rates.
* Returned/Canceled parcel rates.
* A visual dynamic Risk Profile indicator (Low Risk, Medium Risk, High Risk).
* Complete granular historical courier shipping logs with partner tracking codes.

== Installation ==

1. Upload the `brilliant-fraud-checker` folder to the `/wp-content/plugins/` directory, or upload the zipped plugin file directly via **Plugins > Add New > Upload**.
2. Activate the plugin through the **Plugins** menu in WordPress. Note: WooCommerce must be installed and active!
3. Navigate to **WooCommerce > Brilliant Fraud Checker** to configure your credentials.
4. Input your Account API Key Token.
5. Click **Save Settings**, then click **Test Connection** to verify connection.

== Frequently Asked Questions ==

= How does the plugin fetch courier data? =
The plugin intercepts the WooCommerce Order billing phone number when an admin views the order details or quick-previews the order. It securely communicates with your configured API via a standard real-time `GET` request.

= Is the API query cached? =
Yes! To ensure excellent page speed and protect your WooCommerce admin dashboard from slowdowns, successful API lookup results are cached securely as WordPress Transients for 12 hours. Admins can click the **Refresh Records** button on the order dashboard to instantly bypass the cache and query live, real-time data from the API.

= How does the query transport credentials? =
The API key is securely appended inside the URL query arguments as a parameter named `token` (e.g. `?phone={phone}&token={api_key}`) server-to-server.

== Screenshots ==

1. WooCommerce Order details showing real-time customer risk profile, completed/returned parcel statistics, and detailed courier shipment log history.
2. Plugin settings page showing custom API credentials setup and live API test connection utility.

== Changelog ==

= 1.0.0 =
* Initial premium release of Brilliant Fraud Checker. Fully optimized for WooCommerce HPOS, transient-cached API lookup queries, and custom manual reloads.

== Upgrade Notice ==

= 1.0.0 =
Initial premium release of Brilliant Fraud Checker. Fully optimized for WooCommerce HPOS, transient-cached API lookup queries, and custom manual reloads.
