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
- Getting started
- Where everything is
- Creating a subscription product
- Payments and renewals
- M-Pesa renewals
- Failed payments and retries
- Managing subscriptions
- What customers see
- Pause and skip
- Upgrades and downgrades
- Coupons
- Synchronised renewals
- Family subscriptions
- Gift subscriptions
- Emails and reminders
- SMS reminders
- Revenue dashboard
- Licence, plans and updates
- 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
- Download the zip from your order email or your account on easyclickon.com.
- Go to Plugins → Add New → Upload Plugin, choose the zip, click Install Now, then Activate.
- Go to Settings → Permalinks and click Save Changes once. This switches on the Subscriptions pages in My Account.
- 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
- Go to Products → Add New and give the product a name and description.
- In Product data, choose Simple subscription (one price) or Variable subscription (for example Monthly, Quarterly and Yearly as variations).
- Fill in the subscription fields below, then click Publish.
| Field | What it does |
|---|---|
| Subscription price | Amount charged each billing cycle. |
| Billing interval and Billing period | How 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 fee | A one-off charge with the first payment. |
| Free trial length and period | For example a 14-day trial before the first charge. |
| Synchronize renewals to day | Bill 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.
- Create an app on the Safaricom Daraja portal with Lipa na M-Pesa Online for your shortcode.
- Go to WooCommerce → Settings → Payments → M-Pesa and tick Accept M-Pesa.
- Choose the Environment: Sandbox (testing) first, then Live.
- Enter the Consumer key, Consumer secret and Passkey.
- Choose the Account type: Paybill or Till (Buy Goods). Enter the Business shortcode, and for a till the Till number if it’s different.
- 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.
| Status | Meaning |
|---|---|
| Pending | Waiting for the first payment. |
| Active | Paid up and renewing. |
| On hold | A renewal hasn’t been paid yet, or the subscription is paused. |
| Pending cancellation | Cancelled by the customer, but running until the end of the period they’ve paid for. |
| Cancelled | Stopped. The customer can resubscribe. |
| Expired | Reached 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).
- The buyer ticks Buy this as a gift, adds the recipient’s name, email, an optional message and an optional delivery date.
- 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.
- 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.
- 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:
| Sent when | |
|---|---|
| New subscription (to you) | Someone subscribes. |
| Renewal reminder | A few days before each renewal. |
| Renewal receipt | A renewal is paid. |
| Payment problem | A renewal fails, with a link to pay. |
| Card about to expire | The saved card expires before the next renewal. |
| Subscription on hold | A renewal is unpaid. |
| Subscription paused | The customer pauses. |
| Subscription cancelled | The subscription is cancelled. |
| Subscription expired | It 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.
- Choose the Provider and enter its keys: for Africa’s Talking the username (use
sandboxto test), API key and optional Sender ID; for Twilio the account SID, auth token and “from” number. - Choose which messages to send: Before renewal (with the reminder), After payment (a receipt) and Failed payment (a pay link).
- 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.
| Plan | Websites | Includes |
|---|---|---|
| Starter | 1 | The full subscriptions engine, M-Pesa, reminders, pause and skip, family and gift subscriptions |
| Studio | 5 | Everything in Starter, plus SMS reminders and the revenue dashboard |
| Wakala | Unlimited | Everything 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.
