ClocknextClocknextHelp
DocumentationAPI ReferenceMCP Tools
Dashboard
What is Clocknext?Getting started

Customers

CustomersCustomer detail

Billing

PurchasesSubscriptionsPackagesInvoicesPaymentsCredit NotesRefunds

Tracking

SignalsRevenue dashboardCustomer Portal

Settings

Profile settingsOrganisation settingsTeam MembersModelsTaxesIntegrationsAPI KeysWebhooks

Documentation

Subscriptions

See every billing period of your Customers' Plans, open one to see its Invoices and Payments, change its plan, or cancel it with or without a refund.

A subscription is one billing period of a Purchase. Each period has its own number (SUB-001, SUB-002, …) and its own page. When a Purchase renews, the period that ended stays in the list as Renewed, under the number it had, and the new period gets the next number. A period's page address never changes, so a link to it keeps working after the renewal.

This page lists every period of every subscription in the workspace. A Free Plan grant, or a Purchase from before subscriptions ran in periods, isn't a subscription, so it isn't listed here. Owners and admins can also change a subscription's plan or cancel it from here.

What you can do here

  • Browse every period, filter by status, or search by subscription number or Customer name.
  • Open a subscription to see that period's Invoices and Payments.
  • Change plan — move a Customer to another Plan.
  • Cancel Subscription — stop a Customer's subscription, and give back the unused time if you want to.
  • Complete Cancellation — end a subscription that is marked for cancellation now, instead of when its paid period ends (owners and admins).

On this page

Four stat cards head the page. All of them count periods, over all time.

CardWhat it shows
Total subscriptionsEvery period, with how many are renewed and how many are scheduled.
Active subscriptionsPeriods running now.
Marked for cancellationsRunning periods whose cancellation was asked for; they end with their paid period.
CancelledPeriods that have ended.

Renewed and scheduled periods have no card of their own; they only count towards the total.

Below the cards, a searchable, paginated table, newest Purchase first. Search matches the subscription number or the Customer's name. The status tabs narrow the rows to All, Active, Renewed, Scheduled, Marked for Cancellation or Cancelled.

ColumnDescription
SubscriptionThe subscription number (links to its page).
CustomerThe subscribed Customer.
PlanThe Plan being billed.
Billing cycleBilling cadence (Monthly, Yearly, …).
CostPrice per cycle.
Start dateWhen this period started, or will start.
StatusSee below.
ActionThe row menu (owners and admins).

Until a Customer is given a Plan the page reads No subscriptions yet, with a Go to Purchases button.

Statuses

StatusMeaning
ActiveThe period running now.
ScheduledNot started yet. It starts once its first Invoice is paid and its start date has come.
Marked for CancellationCancellation was asked for. The subscription keeps running and ends with its paid period.
RenewedA past period. The Purchase renewed into the next one.
CancelledEnded.

Hover a status to see more. A Marked for Cancellation row shows the date it ends. A Cancelled row shows how it ended: Cancelled, Not paid in time, Moved to a new plan (the Customer changed Plan) or Never started.

Changing the plan or cancelling

Each row ends in a ⋯ menu. Open it on:

  • an Active or Scheduled row for Change plan and Cancel Subscription;
  • a Marked for Cancellation row for Complete Cancellation.

On Renewed and Cancelled rows the menu is greyed out, because there is nothing left to change or cancel.

Change plan on an Active row opens the pro-rata Change plan dialog: see Changing a Customer's plan. On a Scheduled row, which hasn't been paid yet, it records another Purchase instead. Both stay open, and when either is paid the other is cancelled and its unpaid Invoice is voided.

Cancel Subscription and Complete Cancellation open the same dialog. It asks three things, then the Customer's name to confirm:

FieldChoices
WhenImmediately, or At end of period (with its date).
RefundNo proration (nothing is refunded), or Create proration (refund the unused days of this period).
Refund toInvoice balance, or Card. Used only with Create proration.

The dialog starts on At end of period when that is allowed, so clicking straight through never ends a Customer's service today. When you pick Immediately, Refund starts on No proration.

When. Immediately stops the Customer's future billing, voids any open Invoice and bills the usage so far. This can't be undone. At end of period marks a running subscription for cancellation: it keeps working until its paid period ends, then stops and doesn't renew. It is greyed out, with the reason, when there is no paid period to run out (the subscription hasn't started yet, or it is a Free Plan), when it is already marked, or while a plan change of the subscription is being made. A subscription that hasn't started is cancelled at once. Complete Cancellation is the same dialog for a marked subscription, with Immediately chosen.

Refund. Create proration is available only with Immediately, and only when there is something to refund. Otherwise it is greyed out and the dialog says why: the subscription hasn't started and nothing was paid for it, the renewal is unpaid, nothing was paid for the period, no unused days are left, everything paid has been credited already, or a plan change of the subscription is being made. What goes back is what the Customer paid for the days of the current period still ahead, tax included. A subscription that is paid but hasn't started yet gets all of it back, tax included: every day is unused. The day you cancel counts as used, and usage billed after the period is never refunded. The dialog shows Unused time before tax, Tax given back and the total.

Refund to. Invoice balance adds the money to the Customer's invoice balance, ready for their next Invoices. Card asks the payment gateway to send it back to the card, and works only when the card paid the whole refund. Otherwise it is greyed out, with the reason.

While a plan change of the subscription is being made, it can't be cancelled in any way, and the dialog says "A plan change for this subscription is being made. Try again in a few minutes." Once the change is done, cancel as usual.

Confirm. Type the Customer's name exactly. The button always reads Cancel Subscription, even when you complete a cancellation.

A refund is made as a credit note on that period's Invoice, with the reason Subscription cancelled: unused time. The paid Invoice itself doesn't change: a paid Invoice is a final record, so its total, Paid from invoice balance and Paid by the customer stay as they were. The credit note is its own record, linked to the Invoice: it shows in the Invoice's credit notes and on the Customer's Credit Notes tab. A refund to a card follows the statuses on the Refunds page. If the gateway can't complete it, the money stays in the invoice balance, and the message says so. The same cancel is available over the API: see Cancel a subscription.

Subscription page

Opening a subscription (/subscriptions/{id}) shows that one period, not the whole Purchase.

  • Header — a breadcrumb, Subscriptions › SUB-…. Owners and admins also get two icon buttons beside it: Change plan, on an Active or Scheduled period (greyed out when the period is marked, and left out on a renewed or cancelled one), and Cancel Subscription (greyed out when the period is marked, renewed or cancelled). A marked period shows Marked for Cancellation in the header, with the date it ends on hover, and a red Complete Cancellation button at the right corner.
  • Stat cards — Price / cycle (with the billing cadence), Customer (with the status, except for a marked period, whose status is in the header, and a link to the Plan), Cycle start (with a hint: Current cycle, Starts on, Past cycle or Cancelled) and a countdown card that follows the status.
  • Tabs — Invoices and Payments for this period only. The Payments tab loads on first open. When a Plan bills a period's usage on the next period's Invoice, a note above the Invoices says which Invoice bills this cycle's usage.

The countdown card follows the status:

StatusCardCounts down to
ActiveRenews inThe next renewal.
Marked for CancellationEnds inThe end of the paid period.
ScheduledStarts inThe start date.
Renewed, Cancelled—Nothing is left to count.

If the date has passed but the renewal, end or start hasn't run yet, the card reads Renewal was due, Was due to end or Was due to start.

Where else you will see it

  • Customer detail — the Customer's Subscriptions tab lists that Customer's periods with the same status tabs. A row opens the same page. See Customer detail.
  • Purchase detail — the Current subscription card links to the period running now. See Purchases.

Related

  • Purchases — what a subscription is a period of.
  • Invoices · Payments — raised and settled for each period.
  • Customer detail — a Customer's own Subscriptions tab.
  • Packages — extra entitlements added to a subscription, for one price.
  • Subscriptions API — list, get and cancel subscriptions, and add or remove packages, over the API.

Purchases

Link a Customer to a Plan, then track its billing schedule, Invoices and Payments over time.

Packages

Sell extra entitlements on top of a Customer's Plan — set up a package once, add it to a subscription, and remove it now or at the end of the paid period.

On this page

What you can do hereOn this pageStatusesChanging the plan or cancellingSubscription pageWhere else you will see itRelated