Documentation · Cartnorm Subscriptions

Getting started

Cartnorm Subscriptions is not on WordPress.org yet. These pages describe version 1.0.0, the version that will be published. Pro features are planned and marked as such.

Cartnorm Subscriptions lets you sell any simple or variable WooCommerce product as a subscription, or as “buy once or subscribe & save”. Renewals are charged automatically through the official WooCommerce Stripe Gateway (cards and SEPA Direct Debit). With any other payment gateway, such as PayPal, the customer gets a pay link for each renewal. Customers manage their subscriptions themselves in My Account.

Requirements

  • WordPress 6.4 or newer, PHP 7.4 or newer
  • WooCommerce 9.0 or newer
  • WooCommerce Stripe Gateway 11.1.1 or newer for automatic renewals. Without it, renewals are paid by link.
  • Block and classic checkout both work. HPOS is supported.
  • HTTPS on the live shop (Stripe requires it).

1. Install and activate

Install WooCommerce and WooCommerce Stripe Gateway first and connect your Stripe account in WooCommerce › Settings › Payments › Stripe. Then go to Plugins › Add New, search for Cartnorm Subscriptions, then click Install and Activate.

The plugin adds WooCommerce › Subscriptions with four tabs: Overview, Subscriptions, Settings and Safe mode.

2. Make a product a subscription

Open a product. Next to Virtual and Downloadable, tick Subscription. A Subscription plan section appears:

  • Customers can: Only subscribe, or Buy once or subscribe (customers choose on the product page).
  • Bill every: a number and a period: days, weeks, months or years (for example every 4 weeks).
  • Subscription discount (%): the price reduction for subscribers compared to a one-time purchase. 0 = same price.
  • Free trial: length of the free trial. 0 = no trial. Customers get a reminder before the first payment.
  • Sign-up fee: charged once with the first payment.
  • Ends after (payments): number of payments including the first. 0 = until cancelled.

For variable products, each variation has its own plan. SEPA Direct Debit is offered only for intervals of 14 days or longer, because a bank debit takes about 6 business days to settle.

In the cart, a line Recurring payment shows what the customer will pay and how often. Customers who subscribe need an account; it is created for them at checkout if they do not have one.

3. Set up Stripe webhooks

Renewals work without webhooks, but late SEPA results and disputes then reach the shop only through a periodic check (up to 6 hours later). Configure the webhook in the Stripe plugin’s settings as described by WooCommerce Stripe Gateway.

Wallets and Stripe Link cannot be charged again for renewals. For subscriptions, these payment types are refused at checkout and the customer is asked to pay by card or SEPA.

4. Check the setup and health checklist

Open WooCommerce › Subscriptions › Overview. Besides the key numbers (active subscriptions, monthly recurring revenue, renewals in the next 30 days, subscriptions that need attention) you see Setup and health:

  • Stripe is connected (version and mode),
  • Stripe webhooks are set up,
  • a product is sold as a subscription,
  • scheduled tasks run on time (renewals, retries and reminders run in the background through WP-Cron),
  • safe mode or live site confirmed,
  • cancellation and withdrawal buttons are online,
  • HTTPS.

Each problem has a Fix it link.

5. Test a renewal

Switch the Stripe plugin to test mode and buy your subscription product with a Stripe test card. Then use the Test tools on the Overview tab (only available in Stripe test mode or on a test site):

  • Run its next renewal now for a subscription number: creates the renewal order, charges the saved card and sends the emails, without waiting a month.
  • Send due reminders now
  • Process due renewals now

The result appears in the subscription’s history (WooCommerce › Subscriptions › Subscriptions, open the subscription). Stripe’s test cards also let you test a declined payment and a payment that needs the customer’s confirmation.

Next steps

Something unclear or missing? Write to [email protected].