=== Veloris Shield ===
Contributors:      veloris
Tags:              fraud prevention, chargeback, woocommerce, payments, security
Requires at least: 6.0
Tested up to:      7.0
Requires PHP:      8.0
Stable tag:        1.0.0
Donate link:       https://veloris.app
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Real-time fraud prevention for WooCommerce. Evaluate every order with Veloris Shield before payment is processed.

== Description ==

Veloris Shield evaluates every WooCommerce order in real time — before the payment processor is invoked — using device fingerprinting, velocity intelligence, and ML-based fraud scoring.

**How it works:**

1. Shield.js passively collects device signals on your checkout page (no visible impact on the customer experience).
2. When a customer clicks Place Order, the order data and device fingerprint are evaluated server-side against the Veloris API.
3. Shield returns a fraud score (0–1000) and a verdict:
   - **APPROVE** — order proceeds normally
   - **FLAG** — order proceeds but is flagged for manual review in your Veloris dashboard
   - **CHALLENGE** — 3DS step-up requested (gateway-dependent)
   - **DECLINE** — order is blocked before payment is attempted

**Key features:**

* Sub-200ms decisions — no added checkout latency
* Device fingerprinting across sessions and browsers
* Cross-merchant velocity intelligence (shared fraud signals across the Shield network)
* Monitor mode — observe scores without blocking any orders
* Evaluation ID stored on every order for dispute evidence
* Works with Stripe, PayPal, Braintree, and all major WooCommerce payment gateways
* GDPR-compliant — see [Veloris Privacy Policy](https://veloris.app/privacy)

**Requirements:**

* A Veloris account — [sign up free](https://dashboard.veloris.app/portal/signup)
* WooCommerce 7.0+
* PHP 8.0+

== Installation ==

1. Upload the `veloris-shield` folder to `/wp-content/plugins/`.
2. Activate the plugin via **Plugins → Installed Plugins**.
3. Go to **Veloris Shield** in the WordPress admin menu.
4. Enter your **Secret Key** (starts with `vsk_`) and **Publishable Key** (starts with `vpk_`) from your [Veloris dashboard](https://dashboard.veloris.app/portal/keys).
5. Set Mode to **Live** when you're ready to enforce verdicts.

== Frequently Asked Questions ==

= Will this slow down my checkout? =
No. Shield.js loads asynchronously and the API evaluation adds under 200ms server-side — imperceptible to customers.

= What happens if the Veloris API is unreachable? =
The plugin fails open — orders proceed normally. You'll see an error in your PHP error log.

= Can I test it without blocking real orders? =
Yes — set Mode to **Monitor** in the plugin settings. All orders will be evaluated and scored but none will be blocked.

= Where do I find my API keys? =
In your [Veloris dashboard](https://dashboard.veloris.app/portal/keys) under API Keys.

= Is this GDPR compliant? =
Yes. Veloris acts as a data processor; you are the controller. A Data Processing Agreement is available in your dashboard. See [Veloris Privacy Policy](https://veloris.app/privacy).

== Screenshots ==

1. Plugin settings page
2. Veloris fraud score and verdict shown on the WooCommerce order detail page
3. Order note added automatically with score and evaluation ID

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release.
