Expiry, suspension and reactivation¶
Applies to: all staff and students of a school; Owner to reactivate. Last reviewed: 2026-11-18.
This page describes what happens when a trial or paid period ends, what each kind of user sees, and how to get the school working again.
When a subscription expires¶
A subscription ends at the exact date and time of its end date. That applies equally to:
- a Free Trial reaching day 14,
- a paid period that was not renewed,
- a cancelled subscription reaching the end of its paid period.
Two things then happen:
- Access stops at once. Every check compares the end date with the current time, so a subscription that is still stored as Trial or Active is treated as Expired as soon as its end date has passed. This check is cached for at most one minute on the server.
- The stored status is updated within the hour. A background job (
subscription-expiry, running hourly) sets the status of every ended Trial or Active subscription to Expired and switches its auto-renew value off. This is bookkeeping; access has already stopped.
There is no grace period and no read-only mode¶
Access stops at the end date
Once the end date has passed, the school cannot view or change its operational data. There are no extra days of grace, and there is no "look but don't touch" mode. The only things that remain available are the pages needed to sign in, see the subscription, pay and manage your own account.
What users see after expiry¶
In the web application¶
DriveFlow re-checks the subscription when a page is opened and at least every five minutes while you work. When it finds that the subscription has ended:
| User | What happens |
|---|---|
| Has Subscription.View (by default Owner, Administrator) | Is sent to Settings > Subscription, which shows the red banner "Your subscription ended on dd MMM yyyy." |
| Does not have Subscription.View | Is sent to the Subscription ended page (/subscription-expired): "Your school's subscription has ended … Please ask your administrator to renew it. You'll have full access again as soon as it is paid." with the buttons Check again and Logout. |
The left menu shrinks to a SUBSCRIPTION section with only:
- Renew Subscription (only for users with Subscription.View)
- My Profile
The header's search and alerts are switched off.
The pages that still open are:
- Settings > Subscription (
/settings/subscription) - Settings > Billing (
/settings/billing) - The subscription payment result pages (
/payment/subscription/...) - Subscription ended (
/subscription-expired) - My Profile (
/profile) - Change password (
/account/change-password)
Typing the address of any other page sends you back to the Subscription page (or the Subscription ended page).
Screenshot to be added
Screen: Subscription ended page. Should show: message with the Check again and Logout buttons.
Screenshot to be added
Screen: Left menu after expiry. Should show: SUBSCRIPTION section with Renew Subscription and My Profile only.
In the API¶
Every API request from a signed-in user of the school is refused with HTTP 402 Payment Required and this body, except the endpoints listed below:
{
"message": "Your subscription has ended. Renew it under Settings > Subscription to continue using DriveFlow.",
"code": "SUBSCRIPTION_EXPIRED"
}
Endpoints that keep working without a running subscription:
- Sign-in, registration and the other authentication endpoints (
api/Auth,api/mobile/auth) api/Subscriptions(current subscription, access, plans, upgrade, cancel, resume, referral code)api/Billing(payment history, invoices, invoice PDF, email invoice)api/billing/add-ons(list; a checkout is refused with "Your subscription has ended. Renew it under Settings > Subscription first.")api/Security(the user's own account security)- Two endpoints of
api/Organisationsthat the layout needs to show the school's details - Anonymous endpoints such as the PayFast and Meta callbacks
Students¶
Students use the same school subscription. After expiry the student portal's requests are refused in the same way, so students cannot see lessons or invoices or pay online until the school renews.
In the mobile app¶
The API answers 402 to the app as well. The app moves the user to its upgrade screen (for someone who can manage the subscription) or to "Mobile app not available" (for everyone else). See Mobile app entitlements.
Things that keep running in the background¶
- Facebook and Instagram leads keep arriving. The Meta lead import does not check the subscription, so leads sent by Meta while the school is expired are still stored and are there when the school returns.
- Add-on clocks keep running. An add-on's paid-until date is not paused while the plan is expired.
- Notifications stop for most purposes, because they are raised by actions that staff can no longer perform. Scheduled reminders are covered in the notifications documentation.
Reactivating¶
Any payment for a plan reactivates the school.
- Sign in as a user with Subscription.Manage (by default the Owner). You land on Settings > Subscription.
- Click Renew Plan name to continue on the same plan, or Choose Plan on a different one.
- Choose the billing cycle and click Continue to Payment.
- Pay on PayFast.
When the payment is confirmed:
- The status becomes Active.
- The new period starts today (the days without access are not charged and not made up).
- The full menu returns. Other signed-in users get access back within about five minutes, or immediately by clicking Check again on the Subscription ended page or refreshing the browser.
- All data is as you left it.
Note
A school that expired from the Free Trial cannot go back to the trial; it must choose a paid plan.
Add-ons are separate: if an add-on ran out while you were away, activate it again on Settings > Billing. Only the month is charged; a setup fee already paid is not charged again.
Suspension¶
DriveFlow has no working suspension feature for subscriptions. The status value "Suspended" exists in the code and has a label and colour on the Subscription page, but nothing ever sets it and there is no screen to suspend a school's subscription.
What does exist is the organisation's own Active/Inactive indicator shown under the school name in the left menu. That belongs to organisation management, not to subscription billing; see the SuperAdmin guide.
Example¶
A school's Professional plan ends on Friday 28 August at 14:20. At 14:21 the receptionist clicks on Students and is taken to the "Subscription ended" page. She phones the Owner. The Owner signs in on Monday, is taken straight to the Subscription page, clicks Renew Professional, pays R 999 and sees "Payment received". The receptionist clicks Check again and is back on the dashboard. The new period runs from Monday 31 August to 30 September.
Limitations and notes¶
- No email or other notification is sent to the school before or when the subscription expires.
- There is no grace period setting.
- The web application relies on its periodic check, so a user who is in the middle of a page at the moment of expiry may only notice on the next page change or the next failed save.
- If the web application cannot reach the API to check the subscription, it does not block the user; the API still refuses the actual requests.
Related articles¶
- Subscription management: the Subscription page and paying for a plan.
- Renewals: renewing before the end date.
- Feature access: how access is decided.
- Mobile app entitlements: what the mobile app does after expiry.
- Cancellations: cancelling ends access at the period end.