Managing subscriptions

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 same filter bar as the orders list: search (customer, email, product), status and billing interval (monthly / yearly) as checkbox dropdowns, a start-date range and a reset button — plus sortable columns.

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.

The CSV export carries the gross amount per subscription.

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.

The Invoices / Credit Notes tab 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.

It has the same Export Documents (ZIP) button as the orders side: every document the filters let through, all pages, as PDFs plus a journal.csv, at most 2000 per ZIP.

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.

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.

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.