# Selling plans: subscriptions and recurring orders

SELLING PLANS: SUBSCRIPTIONS AND RECURRING ORDERS

Selling plans turn a one-time product into a recurring purchase. Whether you
sell coffee that ships every month, a fitness membership billed weekly, or a
service paid up-front for a quarter, a selling plan defines the cadence, the
discount, and the trial — so a single product can be offered both as a one-off
and as a subscription.


HOW SELLING PLANS ARE ORGANISED

Everything starts with a selling plan group. A group is the user-facing choice
your shopper sees on the product page (for example, "Subscribe & save"). Inside
the group sit one or more plans — the individual cadences ("Every 30 days",
"Every 60 days", "Every 90 days").

Each plan carries:

 * A name (shown to the shopper).
 * A category: Subscription, Prepaid, or Try Before You Buy.
 * A billing interval: Day, Week, Month, or Year.
 * An interval count, so "every 2 weeks" or "every 3 months" is possible.
 * Trial days (optional).
 * Up to two price adjustments — a percentage off, a fixed amount off, or a
   fixed price — optionally kicking in after a number of completed orders.


CREATING A SELLING PLAN GROUP

 1. Open Products → Selling Plans in your admin.
 2. Click Create Selling Plan Group.
 3. Give the group a Group Name (for example, "Subscribe & save"). The Merchant
    Code is auto-filled from the name and can be edited.
 4. Under Plans, fill out the first plan: name, category, billing interval,
    interval count, and trial days.
 5. If you want to give subscribers a discount, click Add Adjustment, pick
    Percentage / Fixed Amount / Price, and enter the value. You can add a second
    adjustment that applies after a set number of orders (for example, an extra
    5% off after the third delivery).
 6. Click Add Plan to add more cadences inside the same group.
 7. On the right-hand Products panel, click Attach and pick the products this
    group should apply to.
 8. Click Save.


PLAN CATEGORIES

CategoryWhat it does SubscriptionShopper is billed every interval (e.g. monthly)
and can cancel between cycles. PrepaidShopper pays up-front for a set number of
cycles, then receives deliveries across that span. Try Before You BuyShopper
starts with a trial; the regular billing kicks in after the trial period ends.


ATTACHING PLANS TO PRODUCTS

A product can sit inside more than one group, which is how a single item can be
offered as a one-off purchase and as a subscription, or as both a 30-day and a
90-day cadence. From the group's edit page, use the Products panel to attach or
detach products at any time — changes apply to new sign-ups immediately.


HOW THE STOREFRONT SHOWS THE CHOICE

Once a product is attached to a group, the product page renders a
purchase-options selector with each plan as an option. Picking a plan updates
the displayed price (including any discount you set), and the choice carries
through cart and checkout. The customer's selected plan is recorded on the
order, which is what kicks off the recurring billing.


MANAGING SUBSCRIPTION ORDERS

Subscription orders appear in their own list at Orders → Subscriptions, separate
from one-off orders. The page header shows live analytics:

 * Active Subscriptions — how many are currently billing.
 * Monthly Revenue (MRR) — recurring revenue across active subscriptions.
 * Paused — how many are on hold.
 * Churn Rate — cancellations in the selected period.

From here you can search, filter by status (Pending, Confirmed, Paid, Shipped,
Delivered, Canceled), and open any subscription order to see its details,
invoices, and renewal history.


HOW CUSTOMERS MANAGE THEIR OWN SUBSCRIPTIONS

On the order details page for a subscription, your customer sees a Manage
Subscription button. Clicking it opens a secure billing-portal session where
they can:

 * See the next billing date and cadence.
 * Update the card on file.
 * Update the billing or shipping address.
 * Pause, resume, or cancel the subscription.
 * Download past invoices.

Because changes go through the secure portal, you never handle card details
yourself, and the subscription state stays in sync with the payment provider.


RENEWALS

When a subscription's next billing date arrives, a new order is created
automatically and charged against the saved payment method. If the charge fails,
the subscription is flagged and the customer is notified by email so they can
update their card before the next attempt.


FAQ


CAN ONE PRODUCT BE IN MORE THAN ONE GROUP?

Yes. Attach the same product to multiple groups and the product page will render
each group as a separate purchase option, with its plans listed underneath.


HOW ARE SUBSCRIPTION DISCOUNTS APPLIED?

Each plan can carry up to two price adjustments — Percentage, Fixed Amount, or
fixed Price. The discount is applied automatically when the shopper picks the
plan and continues to apply on every renewal. You can configure a second
adjustment to kick in only after a set number of completed orders, which is
useful for loyalty bumps ("an extra 5% off after the third box").


CAN I OFFER A FREE TRIAL?

Yes — set Trial Days on the plan. The shopper isn't charged for the first cycle
until the trial expires.


WHAT PAYMENT METHODS WORK FOR SUBSCRIPTIONS?

Any card-based gateway that can store the customer's payment method for
re-charging. Pay-on-delivery and other one-shot methods are not supported for
recurring billing, because there is no token to charge on the next cycle.


CAN A CUSTOMER SWITCH CADENCE?

If a single group has multiple plans (for example, 30, 60, or 90-day options),
the customer can switch between them from the billing portal. Switching to a
plan in a different group means cancelling the current subscription and signing
up to the new one.