Subscription management¶
Applies to: SuperAdmin only. Last reviewed: 2026-11-18.
Schools normally pay for DriveFlow online through the payment gateway. Some pay by EFT or under a quote. The Subscriptions page lets the SuperAdmin do by hand what the gateway does automatically: put a school on a plan, record its payment, and manage its add-ons and SMS bundles.
Menu: Subscriptions, in the PLATFORM section (/settings/subscription)
The page heading is Subscription, with the line "Activate or upgrade a school's DriveFlow subscription." A school user who opens the same address sees their own school's subscription page instead.
Important
Every action on this page is refused by the server for anyone who is not a SuperAdmin.
The page at a glance¶
- Manage School Subscription: the School box. Type a name or email address and choose the school.
- School Details: the school's current plan, status and dates, and any Payments pending.
- Upgrade Subscription: the form for activating or changing a plan.
- Add-ons: one row per add-on, with its price, its status for this school, and buttons.
Screenshot to be added
Screen: Subscriptions page. Should show: a school chosen, showing School Details, the Upgrade Subscription form and the Add-ons table.
Amounts on this page are shown as currency by the server's regional settings (rand on a South African server). All manual payments are recorded in ZAR.
Activating or upgrading a subscription¶
Use this when a school has paid, or agreed to pay, outside the online checkout.
- Open Subscriptions and choose the school.
- If a salesperson referred the school and it has never paid, enter the code in the Salesperson code row and click Apply. See Customer Referrals. This must be done before the payment is recorded.
- Fill in the Upgrade Subscription table (see the fields below).
- Read the blue summary line under the table. It shows the plan, the period and the amount.
- Click Activate Subscription.
- Confirm. The box reads, for example: "Put Kagiso Driving Academy on Professional (18 Nov 2026 to 18 Nov 2027) for R 9 990,00, payment paid?" Click Activate.
The message "{school} is now on {plan}." appears and the School Details refresh.
Fields¶
| Setting | Required | Rules | Meaning |
|---|---|---|---|
| Subscription plan | Yes | Any active plan. The form starts on Professional. | The plan the school will be on |
| Billing period | Yes | Annual or Monthly. Starts as Annual. | How the price is worked out |
| Start date | Yes | Starts as today | First day of the period |
| Duration | Yes | 1 to 60 months. Annual must be a multiple of 12 (12, 24, 36, 48 or 60). Starts at 12. | Length of the period |
| Agreed amount | Only for Enterprise Custom | 0 to 10 000 000 | The total for the whole period. Empty means the plan's list price is charged. |
| Salesperson code | No | See Customer Referrals | The referral code, only before the first payment |
| Payment status | Yes | Paid or Pending. Starts as Paid. | Whether the money has been received |
| Payment reference | Required when Paid | Must never have been used before for any subscription payment | The reference on the bank payment. When Pending and left empty, one is generated in the form MANUAL-yyyyMMddHHmmss-XXXXXX. |
When you switch Billing period to Annual, the duration is rounded up to whole years. When you switch to Monthly, the duration is set to 1.
How the amount is worked out¶
| Situation | Amount |
|---|---|
| An agreed amount is entered | The agreed amount, rounded to cents |
| Annual, no agreed amount | The plan's annual price x number of years. If the plan has no annual price: monthly price x 12 x number of years. |
| Monthly, no agreed amount | The plan's monthly price x number of months |
For the Enterprise Custom plan there is no list price. The Agreed amount is required and its helper text reads "The quoted total for the whole period (from R5 000 a month)." Without it the field shows "Required: this plan is priced by quote" and the button stays disabled.
Example: Professional costs R 999 a month or R 9 990 a year. Annual for 24 months, no agreed amount: R 19 980. Monthly for 3 months: R 2 997. Annual for 12 months with an agreed amount of 8 500: R 8 500.
What happens when you activate¶
| Record | What happens |
|---|---|
| The school's subscription | The school's current subscription is changed in place (a new one is created only if the school never had one). Plan, billing period, start and end dates are set. Status becomes Active. Any cancellation is cleared. Auto-renew is switched off. A note "Activated manually on {date}, reference {reference}." is stored. |
| A subscription payment | Created with gateway Manual, the amount, currency ZAR, and status Successful (Paid) or Pending |
| An invoice | Only when Paid: a paid invoice is created with the next number in the series DF-{year}-000001 and emailed to the school |
| A commission | Only when Paid, and only if the school has a referral inside its commission period. See Commission management. |
| The school's access | Refreshed at once. The school does not need to sign in again. |
The summary line tells you which applies: "A paid invoice is emailed to the school." or "The school gets access now; mark the payment as paid when it arrives."
Activating replaces the current period
Because the existing subscription is changed in place, activating replaces the current period. It does not add time to what the school already has. To extend a school that is paid up to 1 March, set the start date to 1 March yourself.
Validation messages¶
| Message | Cause |
|---|---|
| School not found. | The school no longer exists |
| Select an active subscription plan. | No plan, or the plan is not active |
| Duration must be between 1 and 60 months. | Duration out of range |
| An annual subscription runs in whole years (12, 24, 36... months). | Annual with a duration that is not a multiple of 12 |
| {Plan} is priced by quote. Enter the agreed amount for the period. | Enterprise Custom without an agreed amount |
| Enter an agreed amount between R0 and R10 000 000. | Agreed amount out of range |
| That start date and duration end in the past. | Start date plus duration is not in the future |
| Enter the payment reference. | Paid, but no reference |
| That payment reference has already been used. | The reference exists on another subscription payment, of any school |
Pending payments and "Mark as paid"¶
Choose Pending when you want the school to have access before its money arrives. The school gets the plan immediately. No invoice is created and no commission is earned yet.
The payment then appears in the School Details panel under Payments pending, with its amount, reference and date.
When the money arrives:
- Open Subscriptions and choose the school.
- Under Payments pending, click Mark as paid next to the payment.
- Confirm: "Record payment {reference} ({amount}) as received? A paid invoice is emailed to the school." Click Mark as paid.
The message "Payment marked as paid." appears. The payment becomes Successful, the paid invoice is created and emailed, any setup fee in the payment is recorded as paid, and a referred school's commission is created with today as its payment date.
Messages: "Payment not found." and "This payment is not pending."
Notes:
- Only manual payments are listed here. A gateway checkout that the school abandoned is not shown.
- There is no button to cancel a pending payment. If the money never arrives, the pending line stays, and the school keeps its access until the period ends or you activate a different period.
- A school with a pending payment is not blocked or reminded automatically.
Add-ons¶
An add-on unlocks an extra feature for a monthly price. The Add-ons panel explains the rule: "On a paid plan an add-on's feature only works while the add-on is active. The plan must include the feature first."
The Add-ons table¶
| Column | Meaning |
|---|---|
| Add-on | Name |
| Price | Monthly price, or for a prepaid add-on the list of bundles. A green line shows a bundle discount. A grey line "+ {amount} setup" shows a setup fee that has not been paid yet. |
| Status | See the next table |
| Buttons | Deactivate (active monthly add-ons only) and Activate, Extend or Add bundle |
| Status text | Meaning |
|---|---|
| Active until | Paid up to that date |
| Cancelled, ends | The school cancelled it. It works until that date. |
| Not active | In the school's plan, but not paid for |
| Not in plan | The school's plan does not include this feature. The Activate button is disabled. Upgrade the plan first. |
| {N} credits left / No credits | Prepaid add-on (SMS) |
Activating or extending a monthly add-on¶
- Open Subscriptions and choose the school.
- In the Add-ons table click Activate (or Extend when it is already active) on the add-on's row. A form opens below the table.
- Fill it in:
| Row | Meaning |
|---|---|
| Start date | Starts as today. When extending, starts as the date the add-on is paid up to, so the new period follows on. |
| Duration | 1 to 60 months. Starts at 1. |
| Together | Only for Leads and WhatsApp, when the plan includes both: "Also activate {other add-on}, same dates: 30% off everything, setup fees included" |
| Setup fee | "Charge the {amount} setup fee". Ticked automatically when the setup fee has not been paid. Shows "(already paid)" when it has. With Together ticked, a second box covers the other add-on's setup fee. |
| Payment status | Paid or Pending |
| Payment reference | Required when Paid. Generated when Pending and left empty. |
- Check the blue summary line with the dates and the amount.
- Click Activate Add-on or Extend Add-on, then confirm.
The message "{add-on} is active for {school} until {date}." appears.
How the amount is worked out:
| Situation | Amount |
|---|---|
| One add-on | Monthly price x months, plus the setup fee if ticked |
| Leads or WhatsApp while the school already has the other one active | The monthly price is 30% lower. The setup fee is charged in full. |
| Leads and WhatsApp activated Together | (Both monthly prices x months + the setup fees ticked) less 30% |
What happens: the school gets the add-on until the end date straight away, whether the payment is Paid or Pending. A cancellation by the school is cleared. A payment record is created. When Paid, a paid invoice is emailed and the setup fee is recorded as paid. When Pending, the payment appears under Payments pending and the setup fee counts as paid only once you mark it paid.
Tip
The end date you give replaces the add-on's current paid-up date. It is not added to it. Use the suggested start date when extending.
Messages:
| Message | Cause |
|---|---|
| Select an add-on. | The add-on is not active in the catalogue |
| The school has no subscription yet. Activate a plan first. | The school has no subscription |
| {Add-on} isn't included in the {plan} plan. Upgrade the plan first. | The plan lacks the feature |
| {Add-on} isn't sold together with another add-on. | Together was sent for an add-on with no partner |
| Duration must be between 1 and 60 months. | Duration out of range |
| That start date and duration end in the past. | The period is already over |
| Enter the payment reference. / That payment reference has already been used. | As for a plan |
Deactivating an add-on¶
- In the Add-ons table click Deactivate on an active monthly add-on.
- Confirm: "Switch {add-on} off for {school} now? Nothing is refunded or invoiced." Click Deactivate.
The message "{add-on} switched off for {school}." appears.
Warning
The add-on stops working immediately. Its paid-up date is set to now. No refund, credit note or invoice is created. The school's data for that feature is kept.
If the add-on is not active the server answers "That add-on is not active for this school."
Prepaid add-ons (SMS) cannot be deactivated. They stop when the credits run out.
SMS bundles¶
SMS is a prepaid add-on. The school buys credits in bundles and each SMS part uses one credit.
- Open Subscriptions and choose the school.
- On the SMS row click Add bundle.
- Choose the Bundle.
- Setup fee: tick "Charge the {amount} setup fee" if the school has not paid the SMS setup fee yet.
- Set Payment status and Payment reference.
- Click Add Bundle, then confirm with Add bundle.
The message "{bundle} added for {school}." appears.
The credits are added to the school's balance immediately, whether the payment is Paid or Pending. The summary line says: "The credits are given now; mark the payment as paid when it arrives." Credits already given are not taken back if a pending payment is never paid.
If no bundle is chosen the server answers "Choose a SMS bundle."
Things that do not happen automatically¶
| Renewal | A manually activated subscription has auto-renew off. When it ends, the school must pay again or you must activate a new period. |
| Reminders for pending payments | None |
| Pro-rata credit when upgrading | None. Enter an agreed amount if you owe the school a credit. |
| Refunds | DriveFlow never refunds. Refund at the bank, then record it under Sales Management > Sales Commissions if the school was referred. |
Limitations and notes¶
Warning
A manual activation cannot be undone. To correct a mistake, activate again with the right values and a new payment reference. The earlier payment and invoice stay on record.
- A subscription cannot be ended, suspended or cancelled from this page. See Stopping a school's access.
- A pending payment cannot be cancelled or edited.
- An invoice that was emailed cannot be withdrawn or credited from this page.
- The page records who did what only in the server log ("Subscription for company ... activated manually ...") and in the created-by field of the payment record. There is no audit screen.
- If the school's invoice email fails to send, the activation still succeeds. The school can download the invoice under Settings > Billing.
Related articles¶
- Subscription plans and add-ons - plans, prices and add-ons
- Customer Referrals - applying a salesperson code
- Company management - finding schools and stopping access
- Subscription settings reference - what a school can set itself
- Commission management - commissions earned by manual payments