Payments & sales
Subscriptions (portal, dunning, pause/trial, MRR)
This manual is a draft and may change.
What it does
Subscriptions gives your customers control over their own recurring plan, and gives you the tools to manage it. Customers can cancel at the end of the period, change plan for next time, and (if you allow it) pause. If a payment fails, reminder messages are prepared for you. You can also see monthly recurring revenue and how many people have left.
Who uses it
- Customers and members manage their own subscription from the My subscriptions tab.
- Staff (admin or commerce manager role) start trials, pause or resume, change plans, and review failed-payment reminders.
- The owner reads the revenue and churn figures and decides which self-service options are on.
Setup
- Ask your 1vsM contact to install Subscriptions (portal, dunning, pause/trial, MRR) on your site.
- It installs these first, automatically: Subscriptions.
- Ask your 1vsM contact to switch Subscriptions on for your site. It is off until they do.
- Decide whether members may pause their own subscription. This is off by default.
- Decide your failed-payment reminder days. The usual days are 1, 3 and 7 after the failure.
- Decide whether a subscription should be cancelled automatically after some number of days without payment. This is off unless you ask.
- Check that "update payment method" links to your payment provider's own page, since your site never stores card details.
- Ask your 1vsM contact how often the daily sweep runs. It resumes paused plans, ends cancelled plans at the right moment and prepares reminders.
Admin tasks
Subscriptions adds a Subscriptions tab to the admin menu for staff with the admin or commerce manager role. It shows the revenue tiles, Subscribers, Plans (with a Create plan form) and the Dunning queue. Open a subscriber to act on it.
Start a trial
- Open a subscription that has not started billing and press Start trial, with Trial days (1 to 365).
Pause or resume
- Press Pause on a live subscription. You may give a future date for it to resume by itself.
- Press Resume at any time.
Cancel at the end of the period
- Press Cancel at period end (or Cancel now if it has no period yet). The customer keeps access until the period ends.
- Members can undo their own cancel with Keep my subscription.
Change plan at the next period
- Press Change plan next period and pick the New plan. It must be a different active plan in the same currency.
- The change happens at the next period. Press Cancel plan change to stop it.
Failed-payment reminders
- When a payment fails, reminder messages are written for each reminder day and saved with the subject, text and recipient.
- They are listed in the Dunning queue and are not sent automatically. Send them yourself through your approved channel.
Revenue figures
- The top of the Subscriptions tab shows active, past due, paused and trialing counts, MRR (monthly recurring revenue) per currency, and Churn this month.
Member view
Members see, on the My subscriptions tab, their own subscriptions with plan, price, status, renewal date, trial end, and a Billing history of payments, failures and cancellations. They can press Cancel at period end (and undo it with Keep my subscription), cancel a scheduled plan change, and follow an Update payment method link. Changing plan is not offered on the My subscriptions tab yet; staff make plan changes for them. Pause and Resume appear only if you allowed them. Members never see another member's subscription.
Styling it to your brand
This app takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake. That one profile applies to every app automatically, so there is nothing to set up here.
Troubleshooting
- "Subscription lifecycle is not enabled on this site." Subscriptions is switched off. Ask your 1vsM contact to turn it on.
- "Subscription not found." The subscription is not yours or does not exist. Members can only see their own.
- "That action is not available." For members, pause and resume are off unless you allowed them, or the action is not valid for the state.
- "Only a billed, live subscription can change plan." A cancelled or never-billed subscription cannot change plan.
- "Unknown plan." or "A plan change cannot change currency." Pick an active plan in the same currency.
- "The payment provider did not confirm the change." Nothing was changed. Try again, or ask your 1vsM contact to check the provider link.
- "Busy" Another change is in progress. Try again in a moment.
FAQ
Does a cancel end billing at once? No. The member keeps access until the end of the paid period, then it ends.
Is the plan change prorated? No. The new plan starts at the next period.
Are reminder messages sent for me? No. They are written and stored for you to send.
Can members update their card here? They follow a link to your payment provider's page. Your site does not store card details.
Does a failed payment cancel the plan? Only if you chose an automatic cancel after a set number of days.
What to connect
These accounts make the app work with your own services. Enter them once in Set up your site in your account.
- Stripe payments — optional. Card checkout through your own Stripe account (only on sites built with Stripe checkout).
- PayPal payments — needed. Checkout, deposits, tickets and donations paid by PayPal or Venmo, into your own PayPal business account.
- Square payments — needed. Checkout, deposits, tickets, donations and in-person sales into your own Square account.