Skip to main content
← All apps

Payments & sales

Subscriptions (core)

This manual is a draft and may change.

What it does

Subscriptions (core) keeps the list of recurring plans you sell and each customer's subscription to one of them. It tracks whether a subscription is waiting for its first payment, active, behind on payment or cancelled, and it updates that automatically when your payment provider reports a payment.

Who uses it

  • Staff and owners (admin, commerce manager or commerce viewer role) look at who is subscribed; plans are set up through your 1vsM contact.
  • Members and customers hold subscriptions, and are given or lose access depending on the status.
  • Your 1vsM contact connects the payment provider that reports payments.

Setup

  1. Ask your 1vsM contact to install Subscriptions (core) on your site.
  2. It installs these first, automatically: Checkout.
  3. Decide your plans: a name, a price, a currency and how often it bills (every so many days, weeks, months or years).
  4. Give each plan a short key made of letters and numbers (for example "gold-monthly").
  5. Make sure Checkout has a payment method connected that supports repeating payments.
  6. Ask your 1vsM contact to add the plans. Each plan key must be unique on your site.
  7. Test with one test subscription and confirm it becomes active after its first payment.

Admin tasks

Subscriptions (core) adds a read-only Subscription records tab to the admin menu for staff with the admin, commerce manager or commerce viewer role. It lists the subscription records (plan, price, customer, provider, status, period end), can be filtered by status, and shows each record's Billing events and the list of Plans. It cannot create plans or change anything: plan creation and subscription actions are in the Subscriptions tab of the Subscriptions app, and otherwise your 1vsM contact does them.

What the statuses mean

  1. Pending - created, waiting for the first payment.
  2. Active - paid and in good standing.
  3. Past due - a payment failed. It returns to active when a payment succeeds.
  4. Canceled - finished. A cancelled subscription never comes back; start a new one instead.

Cancelling

  1. Cancelling is not possible from the Subscription records tab. Ask your 1vsM contact, or use the Subscriptions app.
  2. Note that this ends the record on your site. Check that billing is also stopped with your payment provider.

Member view

Members see nothing from this app on its own. If your site shows a subscription page, it uses the status held here. Members do not see this app directly.

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

  • "Plan amount must be greater than zero." A plan price must be above zero.
  • "Invalid billing interval." Choose day, week, month or year, with a count from 1 to 365.
  • "A plan with that key already exists." Each plan key can be used once. Pick another key.
  • "Unknown plan." The plan is missing or switched off.
  • "provider and provider_subscription_id are required." A subscription cannot be created without the payment provider's own reference. Ask your 1vsM contact.
  • A subscription stays pending. The first payment has not been reported by the provider yet.

FAQ

Does cancelling here stop the card being charged? Not by itself. It changes your record only, so also cancel it with your payment provider.

What if my provider sends the same notice twice? The change is made once.

Can a cancelled member rejoin? Yes, with a new subscription. The old one stays cancelled.

Does this send emails? No. This app only tracks plans and statuses.

What to connect

Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.