Subscription eligibility for the mobile app¶
Applies to: Owner and other school staff, Instructor, Student. Last reviewed: 2026-11-18.
The mobile app is a plan feature. A school's staff and students can use it only while the school's subscription is running and its plan includes the Mobile App feature (feature code MOBILE_APP). This page explains which plans qualify, what each person sees when the school's plan does not, and how an owner can upgrade from the phone.
For plan prices, billing and how upgrades are charged, see Subscription plans.
Which plans include the app¶
| Plan (code) | Mobile App included? | Source |
|---|---|---|
Free Trial (FREE) |
No | Covered by the automated tests: owner restricted, everyone else refused |
Starter (START) |
No | Covered by the automated tests |
Professional (PRO) |
Yes | Plan seed data and automated tests |
Enterprise (ENT) |
Yes | Plan seed data and automated tests |
Enterprise Plus (ENTPLUS) |
Yes | Plan seed data |
Enterprise Custom (ENTCUSTOM) |
Yes, priced by quote | Plan seed data |
The app itself says: "The mobile app is included with the Professional plan and higher."
Two conditions must both be true
- The subscription is running. An expired, ended or lapsed subscription has no features at all, including this one.
- The plan includes Mobile App.
Platform SuperAdmins are never restricted.
Where and when the check happens¶
The rule is enforced on the server. The app mirrors it only so that it can show the right screen.
| When | What is checked | Where |
|---|---|---|
| At sign-in | After the password is accepted, the server looks up the plan of the school on your account. If the app is not included and you cannot manage the subscription, no session is issued | Server, api/mobile/auth/login |
| Straight after sign-in | The app asks what the school's subscription allows and decides which screen to show | App, GET api/subscriptions/access |
| When a saved session is restored at start-up | The same check again. The plan may have changed since you last used the app | App, GET api/subscriptions/access |
| After changing your password | The same check again, for the new session | App |
| On every request the app makes | The server refuses mobile sessions on every endpoint (except a short list for account and renewal) when the plan no longer includes the app | Server, global subscription filter |
| When you tap Try again or I've paid, check again | The check is repeated | App |
Because the server checks every request, a downgrade or an expiry takes effect on phones that are already signed in. The next thing the user taps is refused and the app moves to the plan screen. Nobody needs to sign out for this to happen.
Note
Web sessions are not affected by this rule. A school on Starter can keep using the website exactly as before.
flowchart TD
A[Password accepted] --> B{Plan includes Mobile App and subscription is running?}
B -- Yes --> C[Full mobile session]
B -- No --> D{Can this user manage the subscription?}
D -- Yes --> E[Restricted session: account and renewal only]
D -- No --> F[Sign-in refused: no session]
E --> G[Upgrade to use DriveFlow Mobile]
F --> H[Message on the Sign in screen]
What each person sees¶
"Can manage the subscription" means the account's role has the Subscription.Manage permission. By default that is the Owner.
At sign-in, when the plan does not include the app¶
| Who | What happens |
|---|---|
| Someone who can manage the subscription | Signs in. Goes to Upgrade to use DriveFlow Mobile |
| Anyone else (instructor, student, receptionist, manager...) | Stays on the Sign in screen with the yellow message "Your driving school's DriveFlow plan doesn't include the mobile app yet. Please contact your school to get access." Nothing is saved on the phone |
Screen: Upgrade to use DriveFlow Mobile¶
Shown to someone who can manage the subscription.
Upgrade to use DriveFlow Mobile The mobile app is included with the Professional plan and higher. Your school is on the Starter plan (active).
The second sentence names your current plan and its status in lower case (free trial, active, cancelled, expired, suspended, awaiting payment). If the school has no subscription at all it reads "Your school doesn't have a subscription yet."
Buttons:
- View plans and upgrade opens the Subscription screen.
- Sign out.
Screenshot to be added
Screen: Upgrade to use DriveFlow Mobile. Should show: the card with the plan sentence and the "View plans and upgrade" button.
Screen: Mobile app not available¶
Shown to someone who was already signed in when the plan changed, and who cannot manage the subscription.
Mobile app not available Your driving school's DriveFlow plan doesn't include the mobile app yet. Please contact your driving school to get access.
For staff the sentence starts "Your school's" instead of "Your driving school's". The only button is Sign out.
Screen: We couldn't check your access¶
Shown when the app is signed in but could not reach DriveFlow to check the plan, for example when a saved session is restored with no internet connection.
We couldn't check your access We couldn't reach DriveFlow to check your school's subscription. Check your internet connection and try again.
Buttons:
- Try again (shows Checking…). If the check now succeeds and the plan includes the app, your dashboard opens.
- Sign out.
You are not signed out in this situation. Your session is kept and tried again.
When the plan changes while you are using the app¶
- You tap something.
- The server answers with a refusal: code
MOBILE_APP_NOT_INCLUDED(plan no longer includes the app) orSUBSCRIPTION_EXPIRED(the subscription has ended). - The app moves you to Upgrade to use DriveFlow Mobile if you can manage the subscription, otherwise to Mobile app not available.
- Your session is kept. If the plan is upgraded later, the same session works again: open the app, or tap Try again where it is offered.
When the subscription has ended¶
An ended subscription is treated the same way as a plan without the app. The owner signs in to the restricted session and sees the upgrade screen; everyone else is refused at sign-in. The server's own message for an ended subscription is "Your subscription has ended. Renew it under Settings > Subscription to continue using DriveFlow."
What a restricted session can do¶
A session issued to an owner whose plan does not include the app reaches only these parts of the API:
| Allowed | Purpose |
|---|---|
api/security/* (profile, change password) |
Account |
GET api/subscriptions and GET api/subscriptions/access |
Seeing the current subscription |
GET api/subscriptions/plans |
Listing plans |
POST api/subscriptions/upgrade |
Choosing a plan |
POST api/subscriptions/resume |
Resuming (available to the session; the app has no button for it) |
Everything else, including lessons, students, the dashboard, billing, add-ons and cancelling the subscription, answers "DriveFlow Mobile is included with the Professional plan and higher. Upgrade your plan to use it."
Upgrading from the phone¶
Who can do this: viewing the screen needs Subscription.View or Subscription.Manage. Choosing a plan needs Subscription.Manage (the Owner by default). Others see "Only your school's owner can change the subscription."
How to get there: from Upgrade to use DriveFlow Mobile › View plans and upgrade, or from the Owner workspace menu under ADMINISTRATION › Subscription.
- The Subscription screen opens. At the top, CURRENT PLAN shows your plan's name, its status, and "renews or ends" or "ended" with a date.
- Under "DriveFlow Mobile is included with these plans." choose Monthly or Yearly.
- Each plan that includes the app is listed with its name, description and price, for example
R 1 499 / month. A plan with no yearly price shows "Monthly billing only" under Yearly and cannot be chosen for yearly billing. Your present plan is tagged Current plan. The plan marked as popular is tagged Popular. - Tap Choose
<plan name>. The button shows Opening payment…. - For a paid plan, the PayFast checkout page opens in the phone's browser. Pay there.
- Return to the app. It shows "Complete the payment on PayFast in your browser. When you're done, come back and tap the button below."
- Tap I've paid, check again.
- If the payment has been confirmed, your dashboard opens.
- If not yet, you see "We haven't received confirmation of the payment yet. PayFast can take a minute; please try again shortly." Wait a moment and tap the button again.
A plan priced by quote (Enterprise Custom, or any plan with no monthly price) shows Priced by quote and a Contact DriveFlow button that opens the DriveFlow website.
Other buttons on this screen:
- Open full subscription settings on the web opens the website's subscription settings in the browser.
- Back returns to wherever your session belongs (your dashboard, or the upgrade screen).
| Message | Why |
|---|---|
| "The plans couldn't be loaded. Check your internet connection and try again." with Try again | The plan list could not be fetched |
| "Only your school's owner can change the subscription." | You can view the subscription but not change it, or the server refused the change |
| "The payment page couldn't be opened. Please pay from the subscription settings on the web." | No browser could be opened on the phone |
| "The subscription couldn't be changed. Please try again." or a message from the server | The server refused the change |
| "Your session has ended. Please sign in again." | The session ran out; you are sent to Sign in |
| "Subscription updated successfully." | The change needed no payment |
Example¶
Sipho owns a school on the Starter plan. He installs the app and signs in. He sees Upgrade to use DriveFlow Mobile with "Your school is on the Starter plan (active)." He taps View plans and upgrade, leaves Monthly selected and taps Choose Professional. PayFast opens in Chrome; he pays and switches back to DriveFlow. He taps I've paid, check again. The first time he is told the confirmation has not arrived; twenty seconds later he taps again and the Owner Dashboard opens. His instructors and students can now sign in on their own phones.
Other plan features that affect the app¶
The Mobile App feature opens the app. Individual screens also depend on the same plan features as the website, because they call the same API:
| Feature (code) | What needs it in the app |
|---|---|
Student Portal (STUDENT_PORTAL) |
Every student screen |
Online Booking (ONLINEBOOKING) |
A student seeing free times, sending a lesson request and asking to change a lesson. The pending-request list on the owner dashboard |
Bookings (BOOKINGS) |
Every instructor screen under My Lessons, My Students and Sign-off |
Payments (PAYMENTS) |
A student starting an online payment |
Fleet (FLEET) |
The Kilometre Log menu item and screen |
Reports (REPORTS) |
The Reports screens |
SMS (SMS) and WhatsApp (WHATSAPP) |
Switching those channels on in Notification Settings |
When a feature is missing the server's message is shown on the screen, for example "Online Booking is not included in your Starter plan. Upgrade your plan under Settings > Subscription to use it." For a paid add-on that has lapsed: "<Feature> is a paid add-on. Activate or renew it under Settings > Billing to use it."
Limitations and notes¶
Auto-renew is always on
When a plan is chosen from the phone, auto-renew is always on. The app sends AutoRenew = true and has no switch for it. Change it on the web.
- Auto-renew is always on when a plan is chosen from the phone (see above).
- Only plans that include the app are listed. You cannot downgrade to Starter from the phone.
- No cancel, no add-ons, no billing history on the phone. Use Open full subscription settings on the web.
- A saved "remember me" session is not a way round the rule. The plan is checked again every time the app starts and on every request.
- Sessions from the web sign-in are not accepted by the app. If the phone holds a session that is not marked as a mobile session (possible only from very early builds), the app discards it and shows the Sign in screen.
Related articles¶
- Mobile app entitlements - the Mobile App plan feature
- Subscription plans - plans and prices
- Authentication - sign-in messages
- Session management - what happens to your session
- Feature access - how plan features are checked