Skip to content

Student features in DriveFlow Mobile

Applies to: Student. Last reviewed: 2026-11-18.

This page describes every screen a student gets in the app, one task at a time. Students see the Student workspace. Its rules (free times, cancellation notice, school approval of requests) are the same as the student portal on the website, because the app calls the same API (api/student).

Who can use these screens: an account with the Student role, at a school whose plan includes both the Mobile App and the Student Portal features. Students hold no permissions of their own; the menu is fixed.

The student menu

Section Menu item Screen
MY TRAINING Dashboard Student Dashboard
MY TRAINING Book a Lesson Book a lesson
MY TRAINING My Lessons My lessons
MY TRAINING My Requests My requests
MY TRAINING Training Progress Your progress
MY TRAINING Rate Instructor Rate your instructor
BILLING Payments & Invoices Payments and invoices
ACCOUNT Messages Messages from your school
ACCOUNT Profile Profile and settings
ACCOUNT Settings Profile and settings

Student Dashboard

The first screen after signing in.

Screenshot to be added

Screen: Student Dashboard. Should show: greeting, the NEXT LESSON card, the DONE / LEFT / PROGRESS tiles and the YOUR TRAINING card.

What it shows:

  • Hello, <first name>, with your licence code and student number underneath, for example Code B · STU-00042.
  • A red banner for each unpaid invoice that is due soon or overdue: "Invoice INV-0012: R 1 500,00 is due 28 Nov. Tap to pay." (or "was due" when overdue). Tapping it opens Payments & Invoices.
  • NEXT LESSON: date and time, instructor, vehicle and pick-up place. Tapping it opens My Lessons. When nothing is booked the card reads NO LESSON BOOKED / Book your next lesson / See the free times and send a request to your school. and opens Book a Lesson.
  • Three tiles: DONE (completed lessons), LEFT (lessons remaining) and PROGRESS (percentage).
  • YOUR TRAINING: your Instructor ("Assigned per lesson" when you have no fixed instructor), your next Driving test with its testing centre if one is booked, and your Balance.
  • Buttons Book a lesson and My lessons.

If the dashboard cannot be loaded you see the error and a Try again button.

Opening the dashboard also sets the lesson reminders on your phone. See Notifications and reminders.

API: GET api/student/dashboard, GET api/student/invoices/reminders, GET api/student/lessons/upcoming.

Book a lesson

Important

You pick a free time and send a request. The lesson is not booked until your school confirms it.

Needs: the school's plan to include Online Booking, and your school to have online booking switched on for your branch.

  1. Open the menu and tap Book a Lesson.
  2. Under the heading you see who the lesson is with and how many lessons are left, for example "With Sipho Dlamini · 3 lessons left in your package".
  3. Choose the week to look at. The date box starts at tomorrow. Tap ‹ or › to move a week earlier or later, or tap the date to pick one. You cannot go earlier than today.
  4. If you have your own instructor, you can tick Any free instructor (not only <name>) to see times with other instructors as well.
  5. Free times are listed per day as buttons showing the start time, for example 09:00. A day with no times shows the reason the school gave for it, if any.
  6. Tap a time. The YOUR REQUEST card appears with When (day, time and length in minutes) and With (instructor and vehicle).
  7. Optionally type A note for your school (optional).
  8. Tap Send request.
  9. A blue message confirms it: "Lesson requested. You'll be notified once your driving school confirms it." Tap See my lessons to see it under Waiting for your school.

Screenshot to be added

Screen: Book a lesson. Should show: a week of free time buttons with one selected and the YOUR REQUEST card below.

Extra lessons

When you have already booked every lesson in your package, the request card shows "You've booked all the lessons in your package, so this is an extra lesson (R 350,00)." (the price appears when your school has set one). Tick I accept the extra lesson charge. The Send request button stays disabled until you do.

Messages you may see

Message Why
"Online booking isn't available at your driving school. Please contact them to book a lesson." or "Booking lessons online isn't open at your school. Please contact your driving school." Your school has not opened online booking
"Online Booking is not included in your <plan> plan. ..." The school's plan does not include Online Booking
"No free times on these days. Try later dates." Nothing is free in the week shown
"Finding free times…" The list is loading
A red message after Send request, with the free times shown again The time was just taken, or another rule refused it. Pick another time

API: GET api/student/booking/options, GET api/student/booking/slots?date=…&anyInstructor=…, POST api/student/bookings.

My lessons

Everything about your lessons from 30 days back to 31 days ahead.

Screenshot to be added

Screen: My lessons. Should show: the "Waiting for your school" card, an upcoming lesson card with its buttons, and the "Earlier lessons" list.

The screen has these parts:

  • My requests button: opens the full request log.
  • Waiting for your school: requests and change requests the school has not answered yet. Each shows Request or Change, the time asked for, Instead of (for a change), the instructor, and a Withdraw request button.
  • Red notes for requests that were declined: "Your request for Tue 24 Nov, 09:00 wasn't accepted: <the school's reason>".
  • Upcoming: each lesson with date and time, a status badge, Instructor, Vehicle and Pick up.
  • Earlier lessons: past and cancelled lessons with their status. "No lessons in the last 30 days." when empty.

Status badges a student sees:

Badge Meaning
Please confirm Scheduled; the school is waiting for you to confirm
Confirmed You (or the school) confirmed it
In progress The instructor has started the lesson
Awaiting your sign-off The instructor still has to sign (this is the instructor-side wording, shown as it is; the underlying status is never set, so in practice the badge does not appear)
Sign off The instructor has signed; it is your turn
Completed, Cancelled, No show Finished states

Confirm that you will attend

  1. Find the lesson under Upcoming with the badge Please confirm.
  2. Tap I'll be there.
  3. The message "Lesson confirmed." appears and the badge changes to Confirmed.
Message Why
"You've already confirmed this lesson." It was already confirmed
"Only a scheduled lesson can be confirmed." The lesson is in another state
"This lesson has already started." The start time has passed

API: POST api/student/lessons/{id}/confirm.

Ask to change a lesson (reschedule)

Note

You can ask to move a lesson that is Please confirm or Confirmed. The lesson keeps its present time until your school approves.

  1. On the lesson, tap Ask to change. (The button is hidden when a change request for this lesson is already waiting.)
  2. The Choose a new time screen opens with "Your lesson on Tue 24 Nov at 09:00 keeps its time until your school confirms the new one."
  3. Pick a week and tap a free time, exactly as for booking. The card is headed NEW TIME.
  4. Optionally add a note, then tap Ask to change.
  5. You see "Change requested. Your lesson keeps its current time until your driving school confirms the new one."
Message Why
"This lesson can't be changed here. Please contact your driving school." The lesson could not be found in the next 60 days
"Only a scheduled or confirmed lesson can be changed." The lesson is in another state
"This lesson has already started." The start time has passed
"You've already asked to change this lesson. Wait for your school, or withdraw that request first." A change request is already waiting
"Choose a different time for the lesson." You picked the time it already has
"Please keep the note to 500 characters." The note is too long

API: GET api/student/lessons/calendar, GET api/student/booking/slots, POST api/student/lessons/{id}/change. Needs the Online Booking feature.

Cancel a lesson

  1. On a lesson that is Please confirm or Confirmed, tap Cancel lesson.
  2. A box appears: Why are you cancelling? Type your reason. A reason is required.
  3. Tap Cancel the lesson (red text).
  4. You see "Lesson cancelled." and the lesson moves to Earlier lessons. Your school and instructor are told, with your reason.
Message Why
"Please tell your driving school why you're cancelling." The reason is empty
"Please keep the reason to 500 characters." The reason is too long
"Only a scheduled or confirmed lesson can be cancelled." The lesson is in another state
"This lesson has already started." The start time has passed
A message about the cancellation notice Your branch requires a minimum notice before a lesson can be cancelled. Students cannot override it; phone your school

API: POST api/student/lessons/{id}/cancel.

Withdraw a request

On a card under Waiting for your school (or on My Requests), tap Withdraw request. You see "Request withdrawn." If the school has already answered: "Only a request that is still waiting for the school can be withdrawn."

API: POST api/student/bookings/{id}/cancel. This works even if Online Booking has since been removed from the plan.

Sign off a completed lesson

After a lesson, the instructor signs first. Usually the student then signs on the instructor's phone (see Instructor features). If that did not happen, you can sign on your own phone.

  1. Under Upcoming, the lesson shows the badge Sign off and a button Sign off this lesson. It stays in this list even after its time has passed.
  2. Tap the button. The screen shows the lesson's date and time, instructor and vehicle, and YOUR INSTRUCTOR'S NOTES if there are any.
  3. Sign with your finger in the box under Your signature. Tap Clear to start again. By signing you confirm this lesson took place.
  4. Tap Sign and complete.
  5. You see Lesson signed off and "Thanks! The lesson is now complete." Choose Rate your instructor or Back to my lessons.
Message Why
"Please sign in the box." Nothing has been drawn
"This lesson isn't waiting for your signature." It is already complete, or not yet signed by the instructor
"Your instructor needs to sign off this lesson first." The instructor has not signed yet

Warning

Rotating the phone or resizing the screen clears the signature box; sign again.

API: GET api/student/lessons/calendar, POST api/student/lessons/{id}/sign-off.

My requests

A log of every lesson and change you have asked for, newest first, "and what your driving school said".

  • Use the drop-down to filter: All requests (n), or one state with its count.
  • Each card shows the time asked for, a state badge, Asked or Change asked with when you sent it, Instead of for changes, the Instructor, Extra lesson with its price when it was one, when the state last changed, and the school's reply as: School: "<message>".
  • A request that is still Waiting has a Withdraw request button.
State Meaning
Waiting The school has not answered
Approved The lesson is booked, or the change was made
Declined The school said no; the reason is shown
Withdrawn You withdrew it
Cancelled The school cancelled it afterwards
Expired The requested time passed without an answer

"No requests yet. Book a lesson." is shown when the log is empty.

API: GET api/student/bookings/history.

Training progress

Menu: Training Progress. Shows:

  • Your licence code, a progress bar and "N% of your lessons done".
  • DONE, LEFT and TOTAL tiles.
  • NEXT STEPS: your Next lesson, and your Driving test date and Testing centre when a test is booked. When there is neither: "Nothing booked yet. Book a lesson."

The figures are for your current course. API: GET api/student/dashboard.

Rate your instructor

Menu: Rate Instructor. The heading is How did it go? with "Rate your recent lessons. Your school sees the ratings; your name is only shown to the owner."

  1. Each completed lesson that has no rating yet is shown with its date and instructor.
  2. Tap one to five stars.
  3. Optionally type A comment (optional).
  4. Tap Send rating. The button is disabled until you choose a star.
  5. You see "Thanks for your review." and the lesson leaves the list.

"Nothing to rate right now." means every completed lesson has been rated.

API: GET api/student/reviews, POST api/student/reviews.

Payments and invoices

Menu: Payments & Invoices. The heading shows what you owe in total, for example R 1 500,00 owing.

Screenshot to be added

Screen: Payments & Invoices (student). Should show: an invoice card with Total / Paid / Balance, the payment lines and the Pay, Invoice PDF and Payments and receipts buttons.

Each invoice card shows the invoice number, its status, a description, Date, Due, Total, Paid and Balance.

Open an invoice as a PDF

  1. On the invoice, tap Invoice PDF.
  2. The PDF is downloaded and opened in the phone's PDF viewer.

"The document couldn't be opened. Is there a PDF viewer on this device?" means no app on the phone could open it.

See payments and open a receipt

  1. On the invoice, tap Payments and receipts.
  2. Each payment is listed with its date, amount and method. "No payments yet." when there are none.
  3. Tap Receipt next to a successful payment to open the receipt PDF.

An online payment that failed is listed with "Online payment didn't go through." and has no receipt.

Pay online

The button appears only when the invoice has a balance and your school accepts online payments.

  1. Tap Pay R … online.
  2. The PayFast page opens in the phone's browser. The payment goes into your school's own PayFast account.
  3. Pay, then switch back to the app. It shows "Finish paying on PayFast in your browser, then come back."
  4. Tap I've paid, refresh. The list reloads with "Updated. A payment can take a minute to show once PayFast confirms it." Tap it again a little later if the balance has not changed.
Message Why
"Online payments aren't available at your driving school. Please contact them to pay." The school has not set up online payments
"This invoice doesn't need paying." Nothing is owing
"The payment page couldn't be opened." No browser could be opened

API: GET api/student/invoices, GET api/student/invoices/{id}/payments, GET api/student/invoices/{id}/pdf, GET api/student/payments/{paymentId}/receipt, GET api/student/payments/options, POST api/student/payments (needs the Payments feature).

Messages

Menu: Messages. The heading is From your school: "Booking updates and reminders your school has sent you by email, SMS or WhatsApp."

  • Messages are listed newest first with subject, date and the channel they were sent by.
  • SMS and WhatsApp messages show their text straight away.
  • Emails start closed. Tap the subject to open one: you see its text, and a Show email button that displays the email as it was designed, inside a sealed frame (Hide email closes it).
  • "No messages yet." when there are none.

This is a read-only history. You cannot reply. API: GET api/student/notifications.

Limitations and notes

  • No documents screen. There is no screen for uploading or viewing student documents (ID copy, learner's licence) in the app.
  • Requests, not bookings. A student can never book a lesson directly; the school approves every request and change.
  • Online payments are for the full balance only. The API lets a school allow part payments with a minimum amount, and the app loads those options, but the app always asks to pay the whole balance of the invoice. Part payments must be made on the web portal.
  • No payment result screen. After PayFast the app does not check the payment's outcome itself and does not report a cancelled payment back; you tap I've paid, refresh and look at the invoice. The API endpoints for that (GET api/student/payments/{reference} and POST .../cancelled) are not used by the app.
  • Ratings already given are not shown. The API returns them, but the app only lists lessons still waiting for a rating. A rating cannot be edited in the app.
  • Lesson window. My Lessons covers 30 days back and 31 days ahead. Lessons outside that window are not listed. A lesson to change must fall within the next 60 days, and a lesson to sign must be from the last 60 days.
  • School contact details. The API can return the school's contact details for the portal (GET api/student/school); the app does not show them.
  • The badge "Awaiting your sign-off" on a student's lesson uses the instructor's wording. It means the instructor has not signed yet.