Skip to content
User manual · ECO Subscriptions 1.2

ECO Subscriptions user manual

Sell recurring products in WooCommerce: memberships, boxes, retainers and services. Renew by card or M-Pesa, remind customers before they’re charged, and see your recurring revenue at a glance.

Contents
  1. Getting started
  2. Where everything is
  3. Creating a subscription product
  4. Payments and renewals
  5. M-Pesa renewals
  6. Failed payments and retries
  7. Managing subscriptions
  8. What customers see
  9. Pause and skip
  10. Upgrades and downgrades
  11. Coupons
  12. Synchronised renewals
  13. Family subscriptions
  14. Gift subscriptions
  15. Emails and reminders
  16. SMS reminders
  17. Revenue dashboard
  18. Licence, plans and updates
  19. Troubleshooting

1. Getting started

What you need

  • WordPress 6.2 or newer, PHP 7.4 or newer and WooCommerce 8.0 or newer.
  • For automatic card renewals: a payment gateway that saves cards, such as the official WooCommerce Stripe Gateway.
  • For M-Pesa renewals: a Paybill or Till number with Daraja (Lipa na M-Pesa Online) access from Safaricom.

ECO Subscriptions is a complete subscriptions engine. Don’t run it alongside WooCommerce Subscriptions: if that plugin is active, ECO Subscriptions switches itself off to avoid conflicts.

Install

  1. Download the zip from your order email or your account on easyclickon.com.
  2. Go to Plugins → Add New → Upload Plugin, choose the zip, click Install Now, then Activate.
  3. Go to Settings → Permalinks and click Save Changes once. This switches on the Subscriptions pages in My Account.
  4. Open the licence screen under WooCommerce, paste your key and click Activate licence to switch on one-click updates and your plan’s features.

Moving from the “WCS Family Subscriptions” add-on? Deactivate it. ECO Subscriptions includes it and keeps your existing family members and subscriptions.

3. Creating a subscription product

  1. Go to Products → Add New and give the product a name and description.
  2. In Product data, choose Simple subscription (one price) or Variable subscription (for example Monthly, Quarterly and Yearly as variations).
  3. Fill in the subscription fields below, then click Publish.
FieldWhat it does
Subscription priceAmount charged each billing cycle.
Billing interval and Billing periodHow often, for example every 1 month or every 3 months.
Expire after (cycles)Stop after a set number of payments. Leave empty to run until cancelled.
Sign-up feeA one-off charge with the first payment.
Free trial length and periodFor example a 14-day trial before the first charge.
Synchronize renewals to dayBill everyone on the same day. See Synchronised renewals.

Use a variable subscription when the same product comes in different plans. Customers can then move between them later (see Upgrades and downgrades).

4. Payments and renewals

Automatic renewals

With a gateway that saves cards (such as WooCommerce Stripe Gateway), ECO Subscriptions creates a renewal order on the renewal date and charges the saved card. The customer gets a receipt and nothing else to do.

Manual renewals

With other gateways, or when the customer has no saved card, a renewal order is created and the customer is emailed a link to pay it. Under WooCommerce → Settings → Subscriptions → Renewals:

  • Accept manual renewals: allow subscriptions that are paid by link each time.
  • Turn off automatic payments: force every renewal to be manual, for example while testing.

5. M-Pesa renewals

Customers pay the first order with an M-Pesa PIN prompt on their phone, and get a fresh prompt on every renewal day.

  1. Create an app on the Safaricom Daraja portal with Lipa na M-Pesa Online for your shortcode.
  2. Go to WooCommerce → Settings → Payments → M-Pesa and tick Accept M-Pesa.
  3. Choose the Environment: Sandbox (testing) first, then Live.
  4. Enter the Consumer key, Consumer secret and Passkey.
  5. Choose the Account type: Paybill or Till (Buy Goods). Enter the Business shortcode, and for a till the Till number if it’s different.
  6. Save. The STK callback address is shown on the same screen and is sent automatically with every prompt.

If a prompt is missed

Tick Paybill fallback to include Paybill details in the renewal emails, with the order number as the account number. Click Register Paybill confirmation URL with Safaricom once, and Paybill payments are matched to the right order automatically.

M-Pesa only takes Kenyan shillings, so set your store currency to KES for M-Pesa products. At checkout customers enter their Safaricom number, for example 0712 345 678. Renewal prompts go to that same number.

6. Failed payments and retries

When a renewal fails, the subscription goes On hold and the customer gets a “Payment problem” email. With Enable automatic retries on, the payment is tried again on a schedule: after 12 hours, then 1, 2, 3 and 5 days.

  • Maximum retries: how many times to try.
  • Cancel after final retry fails: otherwise the subscription stays on hold until the customer pays.

Failed or cancelled M-Pesa prompts follow the same schedule. A successful payment at any point puts the subscription back to Active.

7. Managing subscriptions

WooCommerce → Subscriptions lists every subscription. Open one to see its items, schedule, related orders, notes, and any family member or gift details.

StatusMeaning
PendingWaiting for the first payment.
ActivePaid up and renewing.
On holdA renewal hasn’t been paid yet, or the subscription is paused.
Pending cancellationCancelled by the customer, but running until the end of the period they’ve paid for.
CancelledStopped. The customer can resubscribe.
ExpiredReached its set number of cycles, or a gift term ended.

8. What customers see

Under My Account → Subscriptions, customers see each subscription’s status, next payment and total. Opening one shows the start date, trial end, end date, recurring total, payment method, items and related orders, with buttons to:

  • Cancel or Reactivate
  • Resubscribe to a cancelled or expired subscription in one click
  • Upgrade or downgrade, when switching is on
  • Pause, Resume now or Skip next renewal, when allowed

Family subscriptions also add My Account → Family Members, and gift buyers see the gifts they’ve sent.

9. Pause and skip

Under Settings → Subscriptions → Pause and skip:

  • Allow pausing: customers choose 1 to 3 billing periods. Set the Longest pause (days), or 0 for no limit. Time they’ve already paid for is kept and given back when they resume.
  • Allow skipping a renewal: the next payment is skipped and the following one becomes the next renewal. Skips in a row limits how many can be skipped back to back.

Paused subscriptions resume automatically on the chosen date, or earlier when the customer clicks Resume now. Every pause, resume and skip is added to the subscription’s notes.

10. Upgrades and downgrades

Set Allow switching to Between variations of a variable subscription. Customers can then move between plans from My Account. Tick Prorate upgrades to charge the price difference for the rest of the current cycle straight away.

11. Coupons

Under Marketing → Coupons, four extra discount types work with subscriptions:

  • Recurring product discount or Recurring product % discount: off every payment, renewals included.
  • Sign-up fee discount or Sign-up fee % discount: off the sign-up fee only.

12. Synchronised renewals

Use Synchronize renewals to day on the product to bill every customer on the same day of the month (for example the 1st) or the same weekday. It’s useful for boxes that ship on a fixed date, or memberships that run by calendar month.

13. Family subscriptions

Customers can buy and manage subscriptions for family members, all billed to one payment method.

  • On the product page, Who is this subscription for? lets them tick themselves and any family members, or type several new names at once.
  • Each member gets their own subscription at checkout, so each can be renewed or cancelled separately.
  • Members are managed under My Account → Family Members (name and relationship). They don’t need their own WordPress accounts.
  • The member’s name appears in the cart, checkout, emails and My Account, and in a Family member column in the admin.
  • A member with an active or on-hold subscription can’t be removed until that subscription is cancelled.

14. Gift subscriptions

Switch gifting on for one product, or for new products by default under Settings → Subscriptions → Gift subscriptions (Offer gifting by default and Default gift terms).

  1. The buyer ticks Buy this as a gift, adds the recipient’s name, email, an optional message and an optional delivery date.
  2. They pick a prepaid term (for example 3, 6 or 12 cycles) and pay it all upfront. There’s no sign-up fee and no renewals.
  3. The recipient gets an account with a set-your-password link, and the subscription appears in their My Account. Gifts with a future date are delivered on that day.
  4. The gift expires at the end of the term. The recipient can then resubscribe with their own card.

15. Emails and reminders

ECO Subscriptions adds these emails, which you can edit under WooCommerce → Settings → Emails:

EmailSent when
New subscription (to you)Someone subscribes.
Renewal reminderA few days before each renewal.
Renewal receiptA renewal is paid.
Payment problemA renewal fails, with a link to pay.
Card about to expireThe saved card expires before the next renewal.
Subscription on holdA renewal is unpaid.
Subscription pausedThe customer pauses.
Subscription cancelledThe subscription is cancelled.
Subscription expiredIt reaches its end date.

Under Settings → Subscriptions → Reminders, switch on Remind customers before each renewal, choose the Days before renewal, and turn on Card expiry warnings. Reminder emails go out each morning.

For emails to reach inboxes reliably, connect an SMTP plugin (such as FluentSMTP) to a real mailbox for your domain.

16. SMS reminders Studio · Wakala

Text messages through Africa’s Talking or Twilio, set up under Settings → Subscriptions → SMS reminders.

  1. Choose the Provider and enter its keys: for Africa’s Talking the username (use sandbox to test), API key and optional Sender ID; for Twilio the account SID, auth token and “from” number.
  2. Choose which messages to send: Before renewal (with the reminder), After payment (a receipt) and Failed payment (a pay link).
  3. Enter a number in Send a test to and save to check it works.

Messages can use {name}, {site}, {date}, {amount} and {pay_url}. Every SMS sent or failed is noted on the subscription.

17. Revenue dashboard Studio · Wakala

WooCommerce → Subscription revenue shows monthly recurring revenue, active subscriptions, churn, renewals due, and money collected each month over the last 12 months, by currency and payment method.

18. Licence, plans and updates

Your subscriptions keep billing whatever the licence says. A licence adds one-click updates, support and your plan’s extra features.

PlanWebsitesIncludes
Starter1The full subscriptions engine, M-Pesa, reminders, pause and skip, family and gift subscriptions
Studio5Everything in Starter, plus SMS reminders and the revenue dashboard
WakalaUnlimitedEverything in Studio, plus white-label

Activate or move a licence

Paste your key on the licence screen under WooCommerce and click Activate licence. To move to another site, click Deactivate this site first. Deactivating the plugin also frees the slot.

White-label Wakala

Under Settings → Subscriptions → White-label, tick Use white-label and set your own Product name, Author, Author website and Description. Tick Hide the licence screen so only you can see it.

Renew

Licences cover 12 months of updates and support, with no automatic charge. Click Renew next to your licence in My Account → Licences on easyclickon.com, and your existing key gets another 12 months.

19. Troubleshooting

My Account → Subscriptions shows “Page not found”

Go to Settings → Permalinks and click Save Changes once.

Renewals aren’t charging cards automatically

Check the gateway saves cards and supports subscriptions (for example WooCommerce Stripe Gateway), and that Turn off automatic payments is unticked. Without a saved card, renewals fall back to an emailed pay link.

Renewals run late or not at all

Renewals run on WordPress’s scheduled tasks, which need visits to the site. On quiet sites, ask your host to set up a real cron job, and check WooCommerce → Status → Scheduled Actions for anything stuck.

The M-Pesa prompt doesn’t arrive

Check the number is a Safaricom line, the Environment matches your keys, and the store currency is KES. Your site needs https, and Safaricom must be able to reach it. Turn on the Paybill fallback so customers can still pay.

SMS isn’t sending

SMS needs a Studio or Wakala licence and a provider with valid keys. Use Send a test to, and check the subscription notes for the provider’s error message.

Still stuck? Contact plugin support with your site address, plugin version and licence key.