Skip to content

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

  1. The subscription is running. An expired, ended or lapsed subscription has no features at all, including this one.
  2. 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:

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

  1. You tap something.
  2. The server answers with a refusal: code MOBILE_APP_NOT_INCLUDED (plan no longer includes the app) or SUBSCRIPTION_EXPIRED (the subscription has ended).
  3. The app moves you to Upgrade to use DriveFlow Mobile if you can manage the subscription, otherwise to Mobile app not available.
  4. 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.

  1. 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.
  2. Under "DriveFlow Mobile is included with these plans." choose Monthly or Yearly.
  3. 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.
  4. Tap Choose <plan name>. The button shows Opening payment….
  5. For a paid plan, the PayFast checkout page opens in the phone's browser. Pay there.
  6. 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."
  7. Tap I've paid, check again.
  8. If the payment has been confirmed, your dashboard opens.
  9. 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.