=== SecureHold Security Deposit Holds with Stripe for WooCommerce ===
Contributors: secureholdwp
Tags: stripe, woocommerce, deposit, security deposit, pre-authorization
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.4.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Stripe security deposit holds for WooCommerce.

== Description ==

SecureHold WP allows you to **place security deposit holds (pre-authorizations)** on your customers' cards using Stripe - without charging them at checkout.

Perfect for:

* rentals (equipment, vehicles, accommodations)
* events and bookings
* services requiring a damage deposit

### How it works

1. Customer places an order in WooCommerce
2. SecureHold places a **Stripe hold (not a charge)**
3. You can later:

   * **capture** the deposit (take the money)
   * **release** it (no charge)

### Important

* A **hold is NOT a charge**
* Funds are only reserved temporarily
* You have **7 days to capture or release** the hold (Stripe limitation)

### FREE Features

* Stripe security deposit holds (authorize only)
* Global deposit amount (fixed or percentage)
* Manual or immediate hold creation
* Per-order and per-item aggregated deposit calculation
* Priority Chain and Highest Deposit Wins conflict resolution
* Automatic release after a configurable number of days (1–7)
* Deposits list & detail view
* WooCommerce order integration (metabox)
* Basic email notifications
* Setup Wizard
* Health check tools
* Checkout deposit notice

### PRO Features

Upgrade to PRO to unlock:

* Advanced rule engine (product & category rules)
* Customer My Account deposits page
* Advanced email customization & branding
* Analytics dashboard & full logs
* Diagnostic tools & simulation engine

### Requirements

* WordPress 6.0+
* WooCommerce
* WooCommerce Stripe Gateway plugin
* Stripe account (test or live mode)

== Installation ==

### Automatic installation

1. Go to Plugins -> Add New
2. Search for "SecureHold WP"
3. Click Install and Activate

### Manual installation

1. Upload the plugin files to `/wp-content/plugins/securehold-stripe-deposits`
2. Activate the plugin through the Plugins screen

### After activation

Run the **Setup Wizard** to:

* connect your Stripe account
* configure webhook
* verify your environment

== Frequently Asked Questions ==

= What is a security deposit hold? =

A hold (pre-authorization) temporarily reserves funds on your customer's card without charging them.

= Does SecureHold WP charge my customers? =

No. It only places a hold. You decide later to capture or release it.

= What happens after 7 days? =

Stripe automatically cancels the hold if it is not captured.

= Does this work with guest checkout? =

Yes. SecureHold supports guest checkout.

= Do I need a specific Stripe plan? =

No. Any standard Stripe account works.

= Is WooCommerce required? =

Yes. SecureHold WP works on top of WooCommerce.

= Can I use it in test mode? =

Yes. You should always test in Stripe test mode before going live.

== Screenshots ==

1. Deposits list
2. Deposit details
3. Order metabox
4. Settings - connection
5. Settings - deposit rules
6. Checkout notice
7. Setup wizard
8. Health check

== External Services ==

This plugin connects to the Stripe API to create and manage payment authorization holds (pre-authorizations) on behalf of the store owner.

**Stripe API**

* Service: Stripe payment processing
* Endpoint: https://api.stripe.com
* Data transmitted: payment method data is collected and processed by Stripe.js and Stripe's servers. This plugin stores the following Stripe object IDs locally in the WordPress database for authorization hold management: PaymentIntent ID, Customer ID, and PaymentMethod ID. Order amount, currency, and order ID are also transmitted to Stripe as PaymentIntent parameters.
* Stripe Terms of Service: https://stripe.com/tos
* Stripe Privacy Policy: https://stripe.com/privacy

**Deactivation feedback (optional)**

When the plugin is deactivated, an optional feedback form appears in the WordPress admin. If the form is submitted, the following data is sent by email to support@secureholdwp.com: site URL, plugin version, deactivation reason, and any additional details provided. Submission is entirely optional. Clicking "Skip and Deactivate" deactivates the plugin without sending any data.

== Changelog ==

= 3.4.2 =

* Maintenance release. Improved compatibility with WordPress 6.8 and WooCommerce 9.x.

= 1.0.0 =

* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial version of SecureHold WP
