Skip to content

Payment problems

Applies to: Owner, Administrator, Finance, Receptionist; students for the portal entries. Last reviewed: 2026-11-18.

DriveFlow has two separate kinds of payment. Keep them apart when investigating:

Students paying the school The school paying DriveFlow
For Student invoices The plan, add-ons, SMS bundles
PayFast account used The school's own DriveFlow's
Where it shows FINANCE > Payments and FINANCE > Invoices Settings > Billing
Reference starts with DFS- DF-

Important

In both cases a payment counts only when PayFast itself confirms it to DriveFlow, server to server. The browser returning from PayFast is never treated as proof of payment.

Detail pages: Online payments · Payments · Invoicing · Outstanding balances · Payment history · Refunds and voids · PayFast · Subscription management

Contents

Students paying the school

  1. A student cannot pay online
  2. The student's payment was not completed
  3. PayFast payment received but the invoice is not updated
  4. A payment cannot be recorded by hand

Invoices and balances

  1. The invoice status is not updating, or not becoming Overdue
  2. Balances differ between screens
  3. Payment history is not showing
  4. An invoice cannot be cancelled or edited

Refunds

  1. Refunds: what is and is not possible

The school paying DriveFlow

  1. Payment made but the subscription is not activated
  2. An add-on or SMS bundle was paid but is not active
  3. A plan or add-on cannot be paid for
  4. The subscription invoice was not received

1. A student cannot pay online

Possible cause

What the student sees Cause
No Make payment item; the banner reads "Please contact your driving school to arrange payment." Online payments are switched off, or the school's PayFast details are not saved.
"Online payments aren't available at your driving school. Please contact them to pay." As above, or the saved PayFast details can no longer be read by the server.
"This invoice doesn't need paying." The invoice is Draft, Cancelled, Credit or already Paid.
"This balance is too small to pay online. Please contact your driving school." / "The smallest amount you can pay online is 5.00." PayFast's minimum is R 5.00.
"You can pay at most ... on this invoice." The amount is above what is still payable.
"A payment for this invoice is already in progress. If you didn't finish it, please try again in an hour." A checkout started in the last 60 minutes is still unfinished and covers the balance.
No Amount to pay field Allow part payments is off: the whole balance is paid.

Walk-in invoices cannot be paid online. Only PayFast is supported.

How to investigate

  1. Settings > Payments, section Online Payments (PayFast): is the switch at the top On? Is a Merchant ID shown, and does the Merchant key helper say a key is saved?
  2. FINANCE > Invoices: search the invoice and read its Status and Balance.

Recommended resolution

  • Enter the Merchant ID and Merchant key (and the Passphrase, only if one is set in PayFast), switch On, click Save online payments. You see "Online payments saved. Students can now pay from the portal."
  • "Enter your PayFast merchant ID and merchant key before switching online payments on.": both values must be saved first. The merchant ID is digits only.
  • Payment in progress: the student waits an hour, or returns from PayFast by cancelling there, which releases the invoice at once.
  • A balance under R 5.00: take the payment at the school and record it with Receive Payment.

When to contact support

When the details are saved, the switch is on, and students still see "Online payments aren't available at your driving school." after you re-entered the merchant key and passphrase.


2. The student's payment was not completed

Possible cause

  • Payment not completed - "Nothing was paid. You can try again whenever you're ready.": the student cancelled at PayFast, or the payment failed there.
  • PayFast shows a signature error on its payment page: the Passphrase saved in DriveFlow differs from the one on the school's PayFast account.
  • Test mode (PayFast sandbox) is on. The page warns: "Test mode is on: students won't be charged, and nothing is paid into your account. Switch it off before students start paying for real."

How to investigate

  • In the portal, Invoices > ⋮ > View payments lists the attempt as "Online (PayFast)" with the status Not finished, Failed or Cancelled.
  • Settings > Payments: check Test mode and whether a passphrase is saved.
  • In your PayFast dashboard, Settings > Integration: compare the merchant ID and whether a passphrase is set.

Recommended resolution

  • The student tries again. Nothing was charged for a cancelled attempt.
  • Passphrase mismatch: type the PayFast passphrase again in DriveFlow, exactly, and save. If PayFast has no passphrase, tick Remove the saved passphrase.
  • Switch Test mode off for real payments. Test mode must match the kind of PayFast account whose details are entered.

There is no "test connection" button. To check the set-up, use test mode with sandbox details and a small invoice.

When to contact support

Contact PayFast when the student's card or bank payment itself is declined. Contact DriveFlow when the details match and every student payment fails.


3. PayFast payment received but the invoice is not updated

Possible cause

  • PayFast has not confirmed yet. The portal says: "PayFast hasn't confirmed this payment yet. That can take a few minutes, for example with EFT. It will show on your invoices once confirmed, and you'll get a receipt by email."
  • PayFast's notification was rejected. DriveFlow rejects a notification when the merchant ID in it is not the school's, when the signature does not match the school's passphrase, when test mode does not match the kind of PayFast account, or when the amount differs from the amount requested by more than one cent. Nothing is recorded, and the rejection is written only to the server log.
  • The payment status at PayFast is not COMPLETE.

Known limitation

There is no screen that lists online transactions or rejected notifications. If a notification was rejected and the student was charged, the money is in the school's PayFast account but no payment shows in DriveFlow.

How to investigate

  1. Wait a few minutes. PayFast retries its notification, so a temporary problem does not lose a payment.
  2. FINANCE > Payments: set Method to Online / Mobile and Payment date to the day. A confirmed payment is listed as Successful with the notes "Online payment via PayFast" and a reference starting DFS-.
  3. FINANCE > Invoices > ⋮ > View Payments on the invoice.
  4. Your PayFast dashboard: was the money received, and for which amount?
  5. Settings > Payments: passphrase and Test mode, as in entry 2.

Recommended resolution

  • Not in PayFast: the student was not charged. They pay again.
  • In PayFast and not in DriveFlow after waiting: correct the passphrase or test mode setting so that later payments confirm, then record this payment by hand: FINANCE > Invoices > ⋮ > Record Payment, Payment Method = MobilePayment, with the PayFast reference in Reference Number. Check first that it has not appeared in the meantime, to avoid counting it twice.

When to contact support

When payments reach your PayFast account and never appear in DriveFlow although the merchant ID, passphrase and test mode are correct. Give the invoice number, the amount, the date and time, and the PayFast payment ID.


4. A payment cannot be recorded by hand

Possible cause

Message Cause
"This student has no outstanding invoices." Nothing is Pending, PartiallyPaid or Overdue for the student. Every payment needs an invoice.
"Payment cannot exceed the outstanding invoice balance." The amount is more than the balance. Over-payments and deposits are not supported.
"Student is not active." The student's status is Inactive or Licensed.
"Payments cannot be recorded against a cancelled invoice."
"Invoice does not belong to this student." / "This invoice belongs to a student. Record the payment from the student." Student and invoice do not match.
"Payment amount must be greater than zero."
No Receive Payment button Your role lacks Create Payments, or the plan lacks Payments.

How to investigate

FINANCE > Invoices: search the student and read Status and Balance. Check the student's status in the Student Directory.

Recommended resolution

  • No invoice: create one first (FINANCE > Invoices > Create Invoice), then record the payment.
  • Money for two invoices: record two payments. One payment cannot be split.
  • Inactive student: Activate Student, record the payment, deactivate again if needed. Payments cannot be recorded for a Licensed student at all; record them before licensing.
  • A walk-in invoice: use ⋮ > Record Payment on the invoice itself.
  • Wrong amount, date or method on a saved payment: a payment cannot be edited. Void it and record it again; the new payment gets a new receipt number.

When to contact support

When a payment must be recorded for a Licensed student.


5. The invoice status is not updating, or not becoming Overdue

Possible cause

  • Overdue is set once a day. A job at 08:00 UTC marks an unpaid invoice Overdue on the first day after the due date plus the school's grace period. That is 10:00 South African time: the job is scheduled without a time zone, so Hangfire uses UTC.
  • The invoice has no due date. It never becomes overdue.
  • A grace period is set.
  • A payment was recorded on an Overdue invoice with a balance left. It becomes PartiallyPaid at once and is marked Overdue again at the next daily run.
  • All payments on the invoice were voided or refunded: it returns to Pending.
  • The invoice was edited: saving recalculates the status and marks it Overdue when the due date is before today, without applying the grace period.
  • The online payment was never confirmed (entry 3).
  • The daily job is not running on the server. Payment reminder emails then stop as well.

How to investigate

  1. FINANCE > Invoices: the invoice's Due Date, Balance and Status.
  2. Settings > Payments > Overdue Invoices > Grace period. Overdue from = Due Date + grace period + 1 day.
  3. FINANCE > Invoices > ⋮ > View Payments: which payments are Successful? Voided (Cancelled) and Refunded payments no longer count.

Recommended resolution

  • Wait for the next daily run, or lower the grace period ("0 marks an invoice overdue the day after its due date.").
  • Add a due date: ⋮ > Edit, set Due Date, save.
  • Record the missing payment.

When to contact support

When no invoice at all has become Overdue for more than a day although due dates and the grace period have passed. That means the daily job is not running, which only DriveFlow can fix.


6. Balances differ between screens

Possible cause

This is how the product works today. "Outstanding" is not calculated the same way everywhere:

Screen What it counts
FINANCE > Invoices, Outstanding card Invoices with status Pending, PartiallyPaid or Overdue
Dashboard and Financial Report, Outstanding Every invoice that is not Paid and not Cancelled, so Draft and Credit invoices are included. A Credit invoice is negative and lowers the figure.
Financial Report, Overdue By due date, not by status, so an invoice can appear there earlier than on the Invoices page
Student profile > Payments tab, Outstanding and Total Invoiced All of the student's invoices, including cancelled ones. For a student with a cancelled invoice these cards are overstated.
Student portal, Invoices Leaves out Cancelled, Credit and Draft
Student portal, Overview Adds up every invoice
Profile > Overview, Balance Only the invoices linked to the active course
A reprinted receipt The invoice's balance at the moment the PDF is generated, not at the time of payment

Other reasons: a branch-tied user sees one branch only; the Financial Report can be filtered by branch; a receptionist without View Payments sees only the payments they recorded (the card reads Paid (recorded by you)).

How to investigate

FINANCE > Invoices, search the student, and read the Balance column of each invoice. Look for a Cancelled or Credit invoice.

Recommended resolution

To state what a student owes, use the invoice list on FINANCE > Invoices filtered by the student, or Reports > Financial Report > Student Balances. Do not rely on the Outstanding card of the profile's Payments tab when the student has a cancelled invoice. There is no setting to change these calculations and no statement of account.

When to contact support

When the Balance of a single invoice does not equal its Total minus its Successful payments.


7. Payment history is not showing

Possible cause

  • You have Create Payments without View Payments (the default for a Receptionist). The page reads "Payments you have recorded, with their receipts." and lists only your own. Any other payment is reported as not found.
  • No Payments menu item: your role has neither payments permission, or the plan lacks Payments.
  • A filter is set. Payment date shows one day only; there is no date range.
  • You searched by invoice number. Known defect: the search box says "Search receipt, student or invoice..." but does not match the invoice number.
  • You are tied to one branch and the payment belongs to another.
  • Download Receipt and Email Receipt are missing: they are offered only for Successful payments, not for voided or refunded ones.
  • The profile's Payments tab is missing: it needs View Payments or Create Payments.
  • A student expects to download an invoice or receipt in the web portal: there is no download button there. Students receive these documents by email (the mobile app can open them).

How to investigate

FINANCE > Payments: clear the search and set Status, Method and Payment date back to all. Then search by receipt number, bank reference, student name or student number.

Recommended resolution

  • To see the payments on one invoice: FINANCE > Invoices > ⋮ > View Payments (needs View Payments).
  • For a period: Reports > Financial Report, table Payment Transactions. It lists Successful payments only.
  • To see everyone's payments, ask for a role with View Payments.
  • To give a student proof: FINANCE > Payments > ⋮ > Email Receipt.

When to contact support

When a payment you recorded yourself, with a receipt number you still have, cannot be found with all filters cleared.


8. An invoice cannot be cancelled or edited

Possible cause

Message Cause
"Invoices with payments cannot be cancelled. Refund the payments first." Money is recorded on the invoice.
"A fully paid invoice cannot be edited." / "A cancelled invoice cannot be edited." Edit is only offered while the invoice is not Paid and not Cancelled.
"Invoice total cannot be less than the amount already paid." The edit lowers the total below what was paid.
"Only draft invoices can be deleted. Cancel an issued invoice instead." No route creates a Draft invoice, so in practice nothing can be deleted.

How to investigate

FINANCE > Invoices > ⋮ > View Payments to see what is recorded on the invoice.

Recommended resolution

To withdraw an invoice that has payments: void or refund every payment (entry 9). The invoice returns to Pending. Then ⋮ > Cancel Invoice. A cancelled invoice keeps its number and cannot be un-cancelled.

If the invoice was raised for a paid extra lesson, cancelling it also removes that extra lesson from the student's package. The system does not check whether the lesson was already booked; if it was, the student shows a lesson booked beyond the package.

When to contact support

Not normally needed.


9. Refunds: what is and is not possible

Possible cause

Users expect DriveFlow to send money back. It does not. Refund and Void correct the school's records only.

Possible Not possible
Void a payment captured in error (needs Edit Payments). Status becomes Cancelled. Sending a refund to a card or bank account from DriveFlow
Refund a payment after you gave the money back yourself (needs Refund Payments). Status becomes Refunded. Partial refunds
Cancel Invoice when nothing is paid on it Credit notes
Applying a Credit invoice to another invoice
Un-voiding or un-refunding
Entering a reason in the Refund or Void dialog

Messages: "Only successful payments can be refunded."; "Payment is already cancelled."; "Refunded payments cannot be cancelled."

Known defect for online payments

When Refund is clicked on a payment that came in through PayFast, the system tries to refund it at the gateway. No refund connection to PayFast exists, so the attempt fails and the payment stays Successful.

How to investigate

FINANCE > Payments: the payment's Method and Status. Online payments show Online / Mobile.

Recommended resolution

  • Cash, card machine or EFT payment: give the money back outside DriveFlow, then FINANCE > Payments > ⋮ > Refund and confirm.
  • Online (PayFast) payment: refund it in your PayFast dashboard, then use Void (not Refund) on the payment in DriveFlow. Note the PayFast refund in the invoice's Notes (⋮ > Edit).
  • Part refund: refund the whole payment, then record a new payment for the part the school keeps.
  • Captured against the wrong invoice: Void, then record it against the right one.

Both void and refund remove the payment from every revenue figure for its original date. A payment received in March and refunded in May disappears from March's revenue. Neither action notifies the student.

Tip

Export the Financial Report at month end before making corrections if you need period-accurate figures.

Refunds of what the school paid DriveFlow are not available on any school screen: "Nothing is refunded" when a plan or add-on is cancelled, and there is no proration.

When to contact support

For a refund of a subscription, add-on or SMS bundle payment made to DriveFlow.


10. Payment made but the subscription is not activated

Possible cause

  • PayFast has not confirmed yet. After about 30 seconds the page says: "PayFast hasn't confirmed the payment yet. This can take a few minutes; your subscription updates automatically once it does."
  • PayFast's notification has not reached DriveFlow, or failed a check (merchant, signature, PayFast's own confirmation, or an amount that does not match). The payment then stays Pending. PayFast retries.
  • The payment was abandoned or cancelled on PayFast: Payment cancelled - "No payment was taken. You can choose a plan again whenever you're ready." An abandoned checkout stays Pending in Payment History for good; nothing marks it Cancelled or Failed later.
  • The plan is active, but a colleague's browser has not refreshed. Other signed-in users see the change within about five minutes.

How to investigate

  1. Settings > Billing > Payment History: find the row by date and description (for example "Professional - Monthly"). Status is Pending or Successful. Note the Reference (DF-...).
  2. Settings > Subscription: the current plan card's status chip and date line.
  3. Your bank or card statement: was the amount actually taken?

Recommended resolution

  • Successful but a user still sees "Subscription ended": that user clicks Check again or refreshes the browser.
  • Pending and the money was taken: wait some minutes; nothing more is needed from you while PayFast retries. Do not pay a second time.
  • Pending and no money was taken: the checkout was not completed. Start again from Settings > Subscription. The old Pending row can be ignored.

When to contact support

When the money has left your account and the row is still Pending after an hour. Give DriveFlow the Reference from Payment History, the amount, and the date and time. A SuperAdmin can activate a period by hand.


11. An add-on or SMS bundle was paid but is not active

Possible cause

  • The same confirmation delay as entry 10. The add-on is activated, or the SMS credits added, only when PayFast confirms.
  • The plan does not include the feature. An add-on only unlocks a feature the plan already includes: on Starter the card shows Not in your plan. After a downgrade a paid add-on stops working, its paid time keeps running, and nothing is refunded.
  • Colleagues' menus have not refreshed yet (about five minutes).
  • WhatsApp or SMS is active but switched off in Settings > Notifications.
  • The add-on is active but the user lacks the permission (for example Leads permissions).

How to investigate

Settings > Billing: the add-on card's chip (Active until dd MMM yyyy, N credits left) and the Payment History row for the payment.

Recommended resolution

  • Pending: as entry 10.
  • Successful: refresh the browser. For WhatsApp and SMS, also switch the channel on and tick it for the messages wanted under Settings > Notifications.
  • Not in your plan: upgrade the plan first.

Cosmetic defect: the confirmation page offers an Open Leads button after every add-on payment, whichever add-on was bought. Use View billing.

When to contact support

As entry 10.


12. A plan or add-on cannot be paid for

Possible cause

Message Cause
Buttons greyed out Only users with Manage Subscription (by default the Owner) can pay.
"You are already subscribed to this plan." Same plan and cycle, and more than 14 days of the period remain.
"The free trial is only available when a school first registers. Please choose a paid plan." The trial cannot be chosen again.
"Enterprise Custom is priced by quote. Please contact DriveFlow and we'll set it up for you." Not sold online.
"Add-on needs the Professional or Enterprise plan." The plan lacks the feature.
"Add-on is free during your trial. Once you're on the Professional or Enterprise plan, activate it here to keep using it." Add-ons cannot be bought on the trial.
"Add-on is paid until date. You can pay for the next month from date." More than 14 days are still paid.
"Add-on is cancelled and ends on date. Undo the cancellation to keep it." Cancelled but still paid up.
"Your subscription has ended. Renew it under Settings > Subscription first." The plan must be running before an add-on can be bought.
"PayFast is not configured." / "Unable to start the payment." DriveFlow's own PayFast details are missing, or the checkout could not be created.
"The salesperson code is invalid or inactive." A referral code was typed and refused; the payment does not start.

How to investigate

Settings > Subscription (plan card, date line) and Settings > Billing (add-on cards). Each card says where you stand.

Recommended resolution

Follow the message: wait for the 14-day window, click Undo cancellation, renew the plan first, or upgrade. For a refused referral code, check the spelling with the salesperson or clear the field to continue without one. A code can only be applied before the school's first plan or add-on payment.

When to contact support

For "PayFast is not configured.", "Unable to start the payment." that repeats, and Enterprise Custom.


13. The subscription invoice was not received

Possible cause

DriveFlow does not send an invoice to pay. The invoice is created when the payment is confirmed, is marked paid, and is also the receipt. It is always emailed to the organisation's email address, not to the person who paid. It will not arrive when:

  • the organisation has no email address, or the address is wrong;
  • the email went to spam;
  • the payment is still Pending, so no invoice exists yet.

A failed invoice email never undoes the activation.

How to investigate

Settings > Billing > Invoices: is the invoice listed? Settings > Organisation: which email address is set?

Recommended resolution

  • Download it: Settings > Billing > Invoices, the PDF icon.
  • Send it again: the envelope icon (needs Manage Subscription). "Your organisation has no email address. Add one under Settings > Organisation and try again." tells you to add the address first.
  • To show your registration and VAT numbers on it, fill them in under Settings > Organisation; the PDF uses the current details each time it is generated.

When to contact support

When Payment History shows Successful and no invoice is listed for that payment.