Skip to content

Mobile app entitlements

Applies to: Owner, staff, instructors and students who use DriveFlow Mobile; developers. Last reviewed: 2026-11-18.

The DriveFlow mobile app is a plan feature. This page explains which plans include it, what each kind of user sees when the plan does not, and how access is checked.

Which plans include the mobile app

The app is the feature MOBILE_APP.

Plan Mobile app
Free Trial No
Starter No
Professional Yes
Enterprise Yes
Enterprise Plus Yes
Enterprise Custom Yes

Important

The app is not an add-on and cannot be bought separately. The plan must also be running: an expired Professional plan gives no app.

When the plan includes the app, every user of the school can use it according to their role: owner, staff, instructors and students. A mobile session gives no more rights than the same user has on the web.

DriveFlow SuperAdmin users can always sign in to the app.

What happens at sign-in

The app signs in through its own endpoint (api/mobile/auth/login). The password, lockout and "remember me" rules are the same as on the web. The plan is only looked at after the password is correct, so the plan is never revealed to someone guessing passwords.

School's plan User can manage the subscription (Subscription.Manage, by default the Owner) Other users (staff, instructors, students)
Includes the app and is running Signed in normally Signed in normally
Does not include the app, or has ended Signed in to a restricted session that can only look after the subscription and the user's own account Refused: "Your school's DriveFlow plan doesn't include the mobile app. Please contact your school." No session is created.

The restricted session

An owner on a plan without the app sees:

Upgrade to use DriveFlow Mobile The mobile app is included with the Professional plan and higher. Your school is on the Starter plan (active).

with the button View plans and upgrade and a Sign out link.

From there the owner can:

  • see the current plan and its status,
  • see the plans that include the app (Professional and the Enterprise tiers),
  • choose Monthly or Yearly and tap Choose Plan, which opens the PayFast payment page in the phone's browser,
  • return to the app and tap I've paid, check again,
  • tap Open full subscription settings on the web,
  • manage their own account security (for example change their password).

Nothing else in the app works in a restricted session. The API refuses every other request.

Enterprise Custom is shown as "Priced by quote" with a Contact DriveFlow button.

A user who may see the subscription but not manage it sees the plans with the note "Only your school's owner can change the subscription."

Screenshot to be added

Screen: Mobile app. Should show: "Upgrade to use DriveFlow Mobile" screen with the View plans and upgrade button.

Screenshot to be added

Screen: Mobile app Subscription screen. Should show: Professional and Enterprise plans with the Monthly/Yearly toggle.

Users who are refused

Staff, instructors and students of a school without the app cannot sign in at all. If they were already signed in when the plan changed, they see:

Mobile app not available Your school's DriveFlow plan doesn't include the mobile app yet. Please contact your driving school to get access.

(For a student the text begins "Your driving school's DriveFlow plan…".) The only option is Sign out.

Upgrading from the app

  1. Sign in as the Owner. The upgrade screen appears.
  2. Tap View plans and upgrade.
  3. Choose Monthly or Yearly.
  4. Tap Choose Professional (or another plan). The button shows "Opening payment…" and PayFast opens in your browser.
  5. Pay on PayFast.
  6. Go back 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.

If the payment has been confirmed you are taken into the app. If not yet: "We haven't received confirmation of the payment yet. PayFast can take a minute; please try again shortly."

If the payment page cannot be opened: "The payment page couldn't be opened. Please pay from the subscription settings on the web."

The same session carries on after the upgrade; there is no need to sign out and in again. If the plan is upgraded on the web instead, the app lets the user in the next time it checks.

How access is checked after sign-in

The app does not rely on the answer it got at sign-in. Three mechanisms keep it honest.

1. The session is marked as a mobile session. The sign-in token carries a signed "client" marker. Because it is signed, it cannot be added, removed or altered; a token that has been edited is rejected. Sending a header that claims to be a different client changes nothing.

2. The app re-checks the plan by asking the API for the school's access (api/subscriptions/access):

  • right after sign-in,
  • every time a saved session is restored when the app starts,
  • after the user changes their password,
  • when the user taps Try again or I've paid, check again.

It then applies the same rule as the API: allowed when the access record has MOBILE_APP; otherwise "upgrade required" for someone with Subscription.Manage, and "contact your school" for everyone else. If the API cannot be reached, the result is "unknown" and the app shows:

We couldn't check your access We couldn't reach DriveFlow to check your school's subscription. Check your internet connection and try again.

3. The API checks every request. For a mobile session, every endpoint except the few listed below requires the plan to include the app. Otherwise it answers HTTP 403:

{
  "message": "DriveFlow Mobile is included with the Professional plan and higher. Upgrade your plan to use it.",
  "code": "MOBILE_APP_NOT_INCLUDED",
  "feature": "MOBILE_APP",
  "planName": "Starter",
  "canManageSubscription": true
}

For a user who cannot manage the subscription the message is "Your school's DriveFlow plan doesn't include the mobile app. Please contact your school." and canManageSubscription is false.

When the app receives this refusal, or a 402 SUBSCRIPTION_EXPIRED, in the middle of a session, it keeps the user signed in and moves them to the upgrade screen or the "Mobile app not available" screen.

Endpoints a restricted mobile session can reach

Only these:

  • current subscription, access, list of plans, upgrade (start a payment) and undo cancellation (api/Subscriptions: get, access, plans, upgrade, resume),
  • the user's own account security (api/Security),
  • sign-in itself.

This list is deliberately shorter than the list of endpoints that stay open on the web after expiry. In particular the Billing endpoints, add-ons, cancellation and the referral code are not available to a restricted mobile session.

What happens when things change

Event Effect on the app
The plan is downgraded to one without the app (for example Professional to Starter) Sessions already signed in are refused on their next request. The owner is moved to the upgrade screen; others to "Mobile app not available".
The plan expires The same. The API answers 402 to most requests; the app treats it like a plan refusal.
The plan is upgraded or renewed The next check lets the session through.
The user's password is changed The session is renewed as the same kind of session (mobile stays mobile).
The user is deactivated They are signed out.

Web sessions are not affected by any of this: on a Starter school the web application works normally within the Starter plan.

Push notifications

Push notifications are only sent to phones of schools whose plan includes the app, and the app only registers a phone for push while its access is "allowed". What triggers a push is described in the notifications documentation.

Example

A school on Starter has an Owner, two instructors and 60 students. An instructor installs the app and tries to sign in: "Your school's DriveFlow plan doesn't include the mobile app. Please contact your school." The Owner signs in on her phone, sees the upgrade screen, chooses Professional monthly and pays R 999 in the browser. She taps I've paid, check again and enters the app. The instructor signs in again and now gets his lessons.

Limitations and notes

  • The Free Trial does not include the mobile app, so a new school cannot try the app during its trial without paying for Professional or higher.
  • The app can start a plan payment but cannot buy add-ons, cancel a subscription, show invoices or apply a referral code. Those are done on the web.
  • Paying from the app always sends the auto-renew value as "on"; as explained in Renewals, nothing is collected automatically either way.
  • The app's wording "renews or ends dd MMM yyyy" does not mean the plan renews by itself.
  • An account that is not linked to any school is not treated as unrestricted on mobile (on the web such an account is).