=== Subscription for WooCommerce by Flexi Subscription ===
Contributors: flexiplugins
Tags: installment payments, Recurring payments, renewals, subscription management, subscriptions
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sell WooCommerce subscriptions, recurring payments, installment plans, free trials, customer subscription pages, automatic renewals, and PayPal or Stripe recurring payment workflows.

== Description ==

[Flexi Subscription](https://flexisubscription.co/) is a WooCommerce subscriptions plugin that helps you sell recurring products, subscription boxes, memberships, maintenance plans, digital access, refill products, and ongoing services. Create subscription products, automate renewals, collect recurring payments, and manage the entire subscription lifecycle directly inside WooCommerce.

Flexi Subscription includes everything you need to build a recurring revenue business with WooCommerce: **simple and variable** subscription products, **signup fees**, **free trials**, flexible billing intervals, automatic renewals via **PayPal and Stripe**, support for **manual renewals** with other payment gateways, customer subscription management, **email notifications**, **analytics**, **automation tools**, and API integrations.

Built for store owners, agencies, service providers, and growing businesses, Flexi Subscription combines subscription billing, automated renewals, customer self-service, payment automation, and subscription management in one WooCommerce-native solution.

Instead of relying on complex external platforms, use a subscription system that works seamlessly within WooCommerce to launch, manage, and grow recurring revenue from your existing store.

[Plugin Home Page](https://flexisubscription.co/?utm_source=wp-repo&utm_medium=listing&utm_campaign=flexisubscription-repo) | [Features List](https://flexisubscription.co/features/?utm_source=wp-repo&utm_medium=listing&utm_campaign=felxisubscription-repo) | [Documentation](https://flexisubscription.co/documentation/?utm_source=wp-repo&utm_medium=listing&utm_campaign=flexisubscription-repo)

[youtube https://www.youtube.com/watch?v=_0REmHN9ZuQ]

= What You Can Do With Flexi Subscription =

* Turn **simple and Variable** WooCommerce products into subscription products.
* Sell recurring products with **daily**, **weekly**, **monthly**, or **yearly** billing periods.
* Configure billing intervals such as every 2 weeks, every 3 months, or every year.
* Offer **free trial** periods before the first renewal payment.
* Show subscription cycle details in the product price, cart, checkout, and customer account.
* Create subscription records automatically after checkout.
* Generate **renewal orders** through the scheduled renewal processor.
* Let customers view their subscriptions from My Account.
* Let customers **cancel subscriptions** when the product setting allows it.
* Let customers renew **cancelled** or **expired** subscriptions.
* Send WooCommerce **email notifications** for key subscription events.
* Use **PayPal** for Flexi Subscription or WooCommerce **Stripe** for automatic recurring payment flows.
* Keep manual renewal workflows available when **automatic payment** capture is not suitable.

= WooCommerce Subscription Features = 
* Create simple and variable subscription products
* Support recurring billing and **automatic renewals**
* Offer **free trials** and one-time **signup fees**
* Manage fixed-term and evergreen subscriptions
* Provide customer self-service inside WooCommerce
* Recover failed renewals automatically
* Track subscription **analytics** and subscriber growth
* Create installment plans and scheduled payment products


= Why Store Owners Choose Flexi Subscription for WooCommerce Subscriptions =

Many WooCommerce stores need recurring revenue but do not need a complex enterprise subscription suite on day one. Flexi Subscription keeps the first setup simple while still covering the core jobs a subscription plugin must handle: recurring product setup, checkout data, subscription records, renewal orders, customer account visibility, scheduled processing, payment gateway integration, and lifecycle emails.

= The plugin is useful when you want to: =

* Launch a subscription product quickly from the normal WooCommerce product editor.
* Keep subscription management inside WordPress and WooCommerce.
* Show customers exactly how often they will be billed.
* Avoid unclear cart and checkout subscription details.
* Support a free trial before recurring billing begins.
* Use PayPal or Stripe for subscription payment workflows.
* Build a subscription setup that can grow into advanced Pro features later.

== Free Plugin Features ==

= Simple Subscription Products =

Create subscription products from standard simple WooCommerce products. Enable the Subscription option, set the billing period and interval, and publish the product like any other WooCommerce item.

= Flexible Billing Cycles =

Choose day, week, month, or year billing periods and combine them with a custom interval. Examples include every day, every week, every 2 weeks, every month, every 3 months, or every year.

= Free Trials =

Offer trial periods before paid renewal begins. Trial length and trial period can be configured per subscription product. The cart and checkout flow can show the trial and set the first checkout amount appropriately for trial-enabled subscriptions.

= Subscription Purchase Limits =

Control whether a customer can buy a subscription more than once. Product-level options include no limit, one active subscription, or one subscription in any status.

= Customer Cancellation Control =

Choose whether customers can cancel a subscription from their WooCommerce My Account area. When enabled, customers can cancel eligible active, pending, or on-hold subscriptions without contacting the store owner.

= Customer Renewal Actions =

Customers can renew cancelled or expired subscriptions from their account. Flexi Subscription creates the renewal order and sends the customer to payment when payment is required.

= My Account Subscription Area =

The plugin adds subscription endpoints to the WooCommerce My Account page. Customers can view their subscriptions, check status, see next payment dates, review billing cycle details, view linked order history, and take available actions.

= Admin Subscription Dashboard =

Manage subscriptions from the Flexi Subscriptions admin area. The list table gives store managers a central place to review subscription records, statuses, customers, products, recurring amounts, start dates, and next payment dates.

= Subscription Details on Orders =

Linked subscription data appears with related WooCommerce orders, helping store admins connect orders, products, customers, and subscription records during support and fulfillment.

= Renewal Scheduler =

Flexi Subscription includes a scheduled renewal processor. It checks active and on-hold subscriptions, creates renewal orders when subscriptions become due, respects manual renewal settings, processes subscription expiry rules, and uses locking to reduce duplicate processing.

= Renewal Order Management =

Renewal orders are linked back to the subscription, and subscription order history is preserved for account and admin review. Paid renewal orders update the subscription schedule for the next billing cycle.

= Expiry Grace Period =

Configure how long pending subscriptions should remain open before expiring. This helps stores give customers a payment window before subscription access is ended.

= Before-Expiry Notifications =

Enable reminder notifications before a pending subscription reaches the expiry cutoff. Store owners can configure the number of days before expiry.

= WooCommerce Email Notifications =

Flexi Subscription registers WooCommerce email classes for important subscription events, including:

* Subscription created
* Subscription activated
* Subscription cancelled
* Subscription expired
* Subscription payment failed
* Subscription trial ended
* Renewal order created

= Cart and Checkout Subscription Summary =

Customers can see subscription details during cart and checkout. The plugin adds billing cycle, trial details, and renewal context to line items so subscription terms are clearer before payment.

= WooCommerce Blocks Compatibility =

Flexi Subscription adds Store API data and frontend scripts for WooCommerce Cart and Checkout Blocks, including subscription summaries and billing-cycle display for block-based checkout flows.

= Product Price Display =

Subscription product prices can include a recurring billing label such as Every Month or Every 2 Weeks. Admin product lists can also show subscription and trial labels for quick product review.

= Subscription Status Lifecycle =

The plugin tracks lifecycle statuses such as pending, active, on-hold, cancelled, expired, and failed, and maps relevant WooCommerce order status changes to subscription status changes.

= Payment Gateway Support =

Flexi Subscription includes a PayPal gateway built for Flexi Subscription recurring payments. It also integrates with WooCommerce Stripe gateway behavior for saving payment methods and processing supported renewal payments.

Payment gateway notes:

* PayPal for Flexi Subscription includes live and sandbox credential fields.
* PayPal webhook configuration is exposed in gateway settings.
* Stripe recurring payment support depends on the WooCommerce Stripe gateway being installed and configured.
* Automatic recurring billing requires a compatible gateway and valid gateway credentials.
* Manual renewal workflows can be used when an automatic payment method is not available.

= Admin Settings =

Store owners can configure renewal processing, customer role transitions, expiry reminders, grace periods, scheduler batch size, and order-to-subscription sync behavior from the Flexi Subscription settings page.

= Support and Setup Page =

The Support page gives store owners a setup checklist, health checks, troubleshooting shortcuts, documentation links, support links, review links, and a clear overview of Pro features.

= Flexi Subscription Pro Add-on =

Flexi Subscription Pro is the premium add-on that extends the free plugin. The free plugin remains required because it owns the core subscription storage, checkout flow, scheduler, renewal order handling, and shared settings. Pro adds advanced subscription controls for stores that need more flexible pricing, delivery, automation, reporting, and customer self-service options.

Pro features are based on the current premium extension codebase and include:

= Variable Product Subscription Options =

Offer subscription options on variable products and variations. Each variation can have its own billing interval, billing period, trial length, trial period, purchase limit, cancellation setting, button text, signup fee, renewal price, early-renewal setting, billing anchor, max billing cycles, and delivery schedule.

= Delivery Schedules =

Create delivery records for paid subscription cycles. Pro supports delivery interval, delivery period, and specific delivery day rules, making it useful for subscription boxes, refills, replenishment products, and physical goods that ship on a recurring schedule.

= Subscription History and Admin Notes =

Track subscription activity and add private admin notes. Store managers can review activity entries, admin notes, and related order counts from the subscription admin screen.

= More Subscription Durations =

Use advanced subscription length controls such as max billing cycles and billing anchor days. This helps stores create fixed-length subscriptions, installment-style plans, and renewal schedules aligned to a preferred day of the month.

= Sign Up Fee =

Charge a one-time signup fee on the initial subscription purchase. The signup fee is separate from the recurring renewal price and is displayed in the cart and checkout flow.

= Early Renewal =

Allow customers to create a renewal order before the next renewal date. Store admins can also create renewal orders manually from the subscription screen or by bulk action when a subscription is eligible.

= Renewal Price =

Set a different recurring price for renewals. This allows stores to use one price for the first purchase and a different price for future subscription renewals.

= Auto-Renew Controls =

Let eligible customers turn automatic renewal on or off from My Account when the store setting allows it. Admins can also enable or disable auto-renew in bulk for supported subscription statuses.

= Payment Retry and Reminder Automation =

Configure retry windows for failed renewals and send reminder emails before renewal, before expiry, and during payment retry workflows.

= Pro Email Notifications =

Pro adds additional WooCommerce email classes for before-renewal reminders, before-expiry reminders, and payment retry reminders.

= Webhook Delivery =

Send normalized JSON payloads for selected subscription lifecycle and automation events to an external HTTPS endpoint, with optional HMAC SHA-256 signing.

= Analytics Dashboard =

Review subscription performance metrics such as active subscriptions, auto-renew share, projected MRR, renewals due, new subscriptions, renewal revenue, failed renewals, trial conversions, churn, product performance, status mix, and subscription snapshots. Pro also includes CSV export for analytics data.

= Read-Only API Tools =

Enable Pro API access for read-only subscription data workflows. The Pro API includes API key validation and is intended for external tools that need subscription visibility.

= Ideal Use Cases =

Flexi Subscription is suitable for many WooCommerce subscription models, including:

* Monthly subscription boxes
* Product refills and replenishment products
* Digital memberships
* Online course access
* Coaching and consulting retainers
* Maintenance plans
* Support packages
* SaaS-style recurring access
* Paid communities
* Warranty or protection plans
* Service contracts
* Donation-style recurring payments
* Content subscriptions
* Wellness and lifestyle subscriptions

= Subscription Models You Can Build =

= Subscribe and Save Products =

Sell products customers need repeatedly, such as supplements, pet products, coffee, skincare, home goods, or other consumables. Use recurring billing labels and customer account pages to keep subscription details visible.

= Memberships and Digital Access =

Use subscription products for recurring access to content, downloads, training, support, or member-only resources. Role transition settings can help connect subscription status to customer access workflows.

= Service Retainers =

Sell recurring services such as consulting, marketing, maintenance, coaching, or support plans. The subscription record helps track renewal dates, order history, and customer status.

= Free Trial Offers =

Offer a trial before the first paid renewal to reduce friction for digital products, service plans, and membership offers.

= Manual Renewal Plans =

Use manual renewal when you want customers to approve or complete each renewal order instead of charging automatically.

= Advanced Pro Subscription Plans =

With Pro, use variation-level subscription plans, signup fees, renewal pricing, fixed billing cycles, early renewals, delivery schedules, payment retry automation, and analytics.

= Integrations =

Flexi Subscription works inside WooCommerce and uses WooCommerce order, product, cart, checkout, email, My Account, and payment gateway systems.

Current payment integrations include:

* PayPal for Flexi Subscription
* WooCommerce Stripe gateway integration

The Pro add-on adds:

* Webhook delivery for subscription lifecycle events
* Read-only API access for subscription data
* Analytics export for subscription reporting

= Developer Notes =

Flexi Subscription is built with an object-oriented PHP architecture and a service container. It uses WooCommerce hooks, WordPress custom post types, lookup tables, order item metadata, scheduled actions, Store API endpoint data, and extension hooks so the free plugin and Pro add-on can share the same subscription foundation.

Developers can extend subscription behavior through available WordPress actions and filters around cart restrictions, subscription status mapping, renewal creation, account actions, scheduler processing, product settings, support URLs, and Pro integration events.

= Privacy and Data =

Flexi Subscription stores subscription, order, customer, product, renewal, and scheduling data in your WordPress and WooCommerce database so the plugin can manage recurring billing workflows. Payment processing data is handled by the configured payment gateway. The plugin does not require sending subscription data to FlexiPlugins servers for core free-plugin subscription management.

When using PayPal, Stripe, webhooks, or external automation endpoints, data may be sent to those configured services as part of payment processing or integration workflows.

== Installation ==

= Automatic Installation =

1. Log in to your WordPress dashboard.
2. Go to Plugins > Add New.
3. Search for "Flexi Subscription for WooCommerce".
4. Click Install Now.
5. Click Activate.
6. Make sure WooCommerce is installed and active.

= Manual Installation =

1. Download the plugin zip file.
2. In WordPress, go to Plugins > Add New > Upload Plugin.
3. Upload the plugin zip file.
4. Click Install Now.
5. Click Activate Plugin.
6. Make sure WooCommerce is installed and active.

= After Activation =

1. Go to Products > Add New or edit an existing simple product.
2. Enable the Subscription product option.
3. Open the Subscription product data tab.
4. Set the billing period, billing interval, trial settings, purchase limit, cancellation setting, and button text.
5. Save the product.
6. Go to Flexi Subscriptions > Integrations and configure PayPal or Stripe if you want automatic recurring payments.
7. Go to Flexi Subscriptions > Settings and review renewal, expiry, scheduler, and role settings.
8. Place a test subscription order before using the workflow on a live store.

== Frequently Asked Questions ==

= Does Flexi Subscription require WooCommerce? =

Yes. Flexi Subscription for WooCommerce requires WooCommerce because it uses WooCommerce products, orders, cart, checkout, payment gateways, emails, and My Account pages.

= Can I create subscription products with the free plugin? =

Yes. The free plugin lets you create subscription products from simple WooCommerce products.

= Does the free plugin support variable subscription products? =

Variable subscription products are part of the Flexi Subscription Pro add-on. The free plugin supports simple subscription products.

= Can I set billing intervals such as every 2 weeks or every 3 months? =

Yes. You can choose a billing period such as day, week, month, or year and set the billing interval.

= Does Flexi Subscription support free trials? =

Yes. The product subscription settings include trial length and trial period fields.

= Can customers cancel their own subscriptions? =

Yes, if the product is configured to allow customer cancellation. Eligible customers can cancel from the My Account subscription view.

= Can customers renew a cancelled or expired subscription? =

Yes. Customers can renew eligible cancelled or expired subscriptions from their account, and Flexi Subscription will create a renewal order.

= Does the plugin create renewal orders automatically? =

Yes, when the renewal process is set to Standard and the subscription is eligible for automatic renewal processing. Manual renewal can also be used when you want customers to complete renewal orders themselves.

= Which payment gateways are supported? =

The plugin includes PayPal for Flexi Subscription and integrates with WooCommerce Stripe gateway behavior. Automatic recurring payment capture requires compatible gateway configuration and valid credentials.

= Does Stripe support require another plugin? =

Yes. Stripe support depends on the WooCommerce Stripe gateway being installed, active, and configured.

= Does PayPal support sandbox testing? =

Yes. The PayPal gateway includes sandbox and live credential fields, plus webhook URL information.

= Does the plugin work with WooCommerce Cart and Checkout Blocks? =

Yes. Flexi Subscription adds Store API data and frontend block scripts for cart and checkout subscription summaries.

= Can I sell regular products and subscription products in the same cart? =

By default, the plugin prevents mixing subscription and non-subscription products to keep checkout and renewal behavior predictable. Developers can change this with filters.

= Can a customer buy more than one subscription at the same time? =

By default, the plugin limits the cart to one subscription item at a time. Developers can change this behavior with filters.

= Can I limit customers to one subscription per product? =

Yes. Product settings include no limit, one active subscription, or one subscription in any status.

= Does the plugin send subscription emails? =

Yes. It registers WooCommerce email notifications for subscription creation, activation, cancellation, expiry, failed payment, trial end, and renewal creation events.

= Does Flexi Subscription Pro require the free plugin? =

Yes. Pro is an add-on. It extends the free plugin and requires the free plugin to remain active.

= What does the Pro add-on add? =

Pro adds variable subscription products, variation-level subscription settings, delivery schedules, signup fees, renewal prices, early renewals, subscription history notes, customer auto-renew controls, payment retry reminders, before-renewal reminders, webhooks, analytics, CSV exports, and read-only API tools.

= Is this plugin suitable for physical subscription boxes? =

Yes. The free plugin can sell recurring products. The Pro add-on is better for physical subscriptions that need delivery schedule tracking.

= Is this plugin suitable for memberships or digital products? =

Yes. Flexi Subscription can be used for memberships, recurring service plans, and digital access products. Depending on your access-control needs, you may connect subscription status to roles or other membership tooling.

= Where can I get support? =

Use the Support page inside the plugin for documentation, WordPress.org support, and review links. You can also visit https://flexisubscription.co/resources/.

== Screenshots ==

1. Flexi Subscriptions admin dashboard with subscription list and lifecycle status.
2. Product editor subscription settings for billing cycle, trial, limits, and customer cancellation.
3. Cart and checkout subscription summary showing billing cycle and trial details.

== Changelog ==

= 1.0.2 =
* New: PayPal gateway integration for Flexi Subscription recurring payment workflows.
* New: Stripe integration helpers for WooCommerce Stripe renewal workflows.
* New: Integrations admin page for PayPal and Stripe setup.
* Enhancement: Improved automatic payment support using PayPal and Stripe gateway flows.
* Enhancement: Updated support page and Pro feature overview.

= 1.0.1 =
* Fix: Various stability and compatibility issues.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.2 =
Adds PayPal and Stripe recurring payment integrations and improves subscription setup visibility. Review payment gateway settings after updating.

= 1.0.1 =
Maintenance release with fixes and stability improvements.
