10mShop

Managing subscriptions

The list, the detail page, invoices per period, credit notes, and the one cancellation there is.

Subscriptions in the sidebar lists the recurring product subscriptions your customers hold. (Not to be confused with Newsletter, and not with your own 10mShop plan under Subscription & AI Credits in the account menu.)

The list

The page opens on two views, the tabs over the filters: Subscriptions, one row per subscription, and Invoices / credit notes, one row per document issued over a subscription payment (see Invoices per period). They are views like those of the orders list. Columns adds fields — the product with its variant, the amount per month, what was invoiced and credited, the number of invoices, the next renewal, the last invoice and more —, + Filter filters by nearly every one of them, a click on a heading sorts by that column, and Save keeps what you changed. New view adds views of your own, each listing one of the two kinds of row. See Views of the subscriptions list.

Search, filters and sorting are applied in the database, so they cover every subscription the shop has rather than a recent slice. Export and, in a view of subscriptions, the four stat cards follow what the open view shows — every matching row, not just the page on screen.

Sorting by status follows the lifecycle — active, trialing, past due, unpaid, incomplete, paused, expired, canceled — rather than the alphabet of the current language.

Two of the cards are money, both gross — Stripe's transaction fees are deducted later on your own Stripe account, not here:

  • Revenue adds up the documents over the filtered subscriptions: every invoice over their payments minus every credit note over them. A yearly subscription paid in full counts its whole invoice from day one.
  • Avg. month is what the running (active and trial) subscriptions come to per month at their price — a yearly one divided by twelve. A rate, not a sum of payments, so a credit note leaves it untouched.

Every subscription has a human-readable number, SHOP-ABO-YYYYMMDD-XXXX, and the list leads with it. Clicking it opens the detail page; the customer opens the customer, the product opens the product.

The detail page

Built like the order detail page:

The same detail page is linked from the subscriptions table on a customer's page.

Invoices per period

Every paid subscription payment automatically gets an invoice, drawn from the same per-year number sequence as your order invoices. A subscription with extras lists the ones the period was charged for under it, as the detail page's card Subscription does.

The Invoices / credit notes view on the subscriptions page lists them all — one row per document with the type badge, number (linking to the PDF), issue date, customer (linked), subscription number (linked) with the product and the billing period it covers, net, VAT, gross, whether it was emailed, and a PDF button. Columns adds the product and the billing period as columns of their own, the payment method, the invoice a credit note corrects, the reason for a credit note, the customer's email, the VAT rate and the currency.

Every view of invoices and credit notes has the same Export Documents (ZIP) button as the orders side: every document the view lets through, all pages, as PDFs plus a journal.csv, at most 2000 per ZIP.

Over a view of invoices and credit notes, the four stat cards count every subscription.

Credit notes on a subscription

Each paid payment row offers issuing a credit note over any amount up to what is left of that payment — crediting one month a service was down, for example — with an optional reason.

The amount is refunded to the customer in full via Stripe out of your own balance, a numbered credit note from the same yearly sequence is issued referencing that payment's invoice (issuing it first if the payment never got one), emailed to the customer as a PDF, and listed next to the invoice.

If Stripe has to wait for funds to cover the refund, the credit note follows automatically once the refund completes. Several partial credit notes per payment are possible until its total is reached.

Cancelling

There is exactly one action: cancel at period end.

  • The customer keeps access until the period they paid for runs out.
  • Nothing is refunded.
  • The scheduled cancellation can be undone right there until then — the page shows Ends on instead of a renewal date while it is scheduled.

Customers can do the same themselves in their account under Subscriptions, with a confirmation and the same undo.

Immediate cancellation is deliberately not offered anywhere.

What the customer's Stripe portal shows

Next to the cancel action, customers have a Manage button that opens Stripe's billing portal. For shop customers it is limited to what belongs there: updating the payment method, their name, address and phone, and cancelling at period end.

It deliberately does not show Stripe's own invoice list — those documents name 10mShop as the issuer and carry Stripe's numbering. Your shop's real invoices and credit notes are listed and downloadable in the customer account under Subscriptions instead, and every period's invoice is emailed as a PDF from your sender identity.

Your own portal for your 10mShop plan is configured separately and does show its invoice history, since Stripe is the only place those invoices exist.

When a payment fails

Switch on Failed subscription payment under Settings → Notifications and you get an email with the amount, Stripe's next automatic retry date and a link to the subscription's detail page. Failed payments also sort first in the subscriptions card on Overview.

On this page

Managing subscriptions — 10mShop