Commission management¶
Applies to: SuperAdmin only. Last reviewed: 2026-11-18.
A commission is what a salesperson earned on one subscription payment of a school they referred. This page explains when a commission is created, how the amount is worked out, the statuses it moves through, and how to approve it or reverse it after a refund.
Menu: Sales Management > Sales Commissions (/sales/commissions)
When a commission is created¶
DriveFlow creates a commission automatically, at the moment a paid invoice is raised for a school's payment. That happens in three situations:
| Situation | When the commission appears |
|---|---|
| The school pays online through the payment gateway | When the gateway confirms the payment |
| The SuperAdmin activates a subscription or add-on by hand with payment status Paid | Immediately |
| The SuperAdmin activates by hand with payment status Pending | Only when the SuperAdmin later clicks Mark as paid |
A commission is created only when all of these are true:
- The school has a referral.
- The payment is of a kind that earns commission (see the next table).
- The payment was received inside the school's commission period.
- The payment does not already have a commission.
- The payment amount, after taking off any setup fee, is more than zero.
Note
There is exactly one commission per payment. If the gateway sends the same confirmation several times, only one commission is created. A new commission always starts with status Pending.
What earns commission and what does not¶
| Payment | Earns commission? |
|---|---|
| A subscription plan (monthly or annual) | Yes |
| A month of a monthly add-on (Leads, WhatsApp, Online Booking) | Yes |
| The once-off setup fee of an add-on | No. When a payment covers a month and a setup fee together, only the month earns commission. |
| A prepaid bundle (SMS credits) | No. It also does not start the commission period. |
| A payment that failed, was cancelled or is still pending | No |
| A payment received on or after the commission expiry date | No. The referral is kept but earns nothing more. |
| A payment from a school with no referral | No |
A manual payment recorded by the SuperAdmin (for example an EFT) earns commission in the same way as a gateway payment. The only difference is that it has no gateway fee.
The commission formula¶
Eligible amount = the commissionable part of the payment, without VAT
Gateway fee = the fee the gateway reported for the payment
or, when it reported none:
charged amount x fee % / 100 + fixed fee
Net eligible revenue = eligible amount - gateway fee
Commission = net eligible revenue x commission % / 100
flowchart TD
A[School payment] --> B[Eligible amount:<br/>payment less setup fee, without VAT]
A --> C{Did the gateway<br/>report a fee?}
C -- Yes --> D[Gateway fee = reported fee<br/>fee type Actual]
C -- No --> E[Gateway fee = charged amount x fee % / 100 + fixed fee<br/>fee type Estimated]
B --> F[Net eligible revenue =<br/>eligible amount - gateway fee]
D --> F
E --> F
F --> G[Commission =<br/>net eligible revenue x commission % / 100]
Details:
- Eligible amount. The payment amount less any setup fee. DriveFlow's prices include VAT. If DriveFlow is registered for VAT (the billing issuer's "VAT registered" server setting), the VAT is taken out, so commission is earned on the amount without VAT. While that setting is off there is no VAT in the price and the eligible amount is the amount paid.
- Actual fee. When the gateway reports its fee, that fee is used on its own. The configured rate is never added on top. The commission shows the fee type Actual. If part of the payment was a setup fee, only the matching share of the gateway fee is counted.
- Estimated fee. When the gateway reports no fee, the rate from Gateway Fee Settings that applied on the payment's date is used. The commission shows the fee type Estimated. The percentage is charged on what the gateway actually processed, which is the amount including VAT.
- Manual payments. A payment recorded by the SuperAdmin went through no gateway. Its fee is R 0.00 and the fee type is Actual.
- No rate configured. If the gateway reported no fee and no rate is set for that gateway, currency and date, the fee is R 0.00.
- The fee can never be more than the payment. If it would be, it is capped at the eligible amount and the commission is R 0.00.
- Commission percentage. The percentage agreed for that school at its first payment, not the salesperson's current percentage.
Rounding¶
Every figure is rounded to cents. A half cent rounds away from zero: R 96.806 becomes R 96.81, R 0.125 becomes R 0.13 and R 0.124 becomes R 0.12. The gateway fee is rounded first, then the commission is calculated on the rounded net amount.
Worked examples¶
These figures come from the system's own tests. PayFast fee 3%, commission 20%, DriveFlow not VAT registered.
| Plan payment | Gateway fee (3%) | Net eligible revenue | Commission (20%) | DriveFlow keeps |
|---|---|---|---|---|
| R 499.00 | R 14.97 | R 484.03 | R 96.81 | R 387.22 |
| R 999.00 | R 29.97 | R 969.03 | R 193.81 | R 775.22 |
| R 2,499.00 | R 74.97 | R 2,424.03 | R 484.81 | R 1,939.22 |
Example 1: Starter plan, fee reported by the gateway. A school pays R 499.00. PayFast reports a fee of R 14.97. Net = 499.00 - 14.97 = R 484.03. Commission = 484.03 x 20% = 96.806, rounded to R 96.81. Fee type: Actual.
Example 2: actual fee differs from the configured rate. A school pays R 499.00. The configured rate is 3% plus R 2.00, but PayFast reports R 17.21. The reported fee is used: Net = 499.00 - 17.21 = R 481.79. Commission = R 96.36. The configured 3% and R 2.00 are still stored on the commission as a record of the rate that applied.
Example 3: no fee reported, percentage plus fixed fee. A school pays R 1,000.00 through a gateway that reports no fee. The rate for that date is 5% plus R 2.00. Fee = 1,000.00 x 5% + 2.00 = R 52.00. Net = R 948.00. Commission = R 189.60. Fee type: Estimated.
Example 4: manual EFT. The SuperAdmin activates a school for an agreed amount of R 500.00, paid by EFT. Fee = R 0.00. Net = R 500.00. Commission at 20% = R 100.00.
Example 5: a different percentage. A salesperson on 15% refers a school that pays R 1,000.00 by EFT. Commission = R 150.00.
Example 6: VAT included. DriveFlow is VAT registered. A school pays R 1,150.00 including VAT, and the gateway reports no fee. The rate is 3%. Eligible amount = R 1,000.00. The gateway took its 3% on the full R 1,150.00, so the fee = R 34.50. Net = R 965.50. Commission at 20% = R 193.10.
Example 7: add-on month with a setup fee. A school pays for the first month of the Leads add-on together with its once-off setup fee: R 1,499.00 + R 1,499.00 = R 2,998.00. PayFast keeps 3% of the whole payment, R 89.94. Only the month counts: eligible amount = R 1,499.00, which is half of the payment. Half of the fee is counted: R 44.97. Net = R 1,454.03. Commission at 20% = R 290.81. The Plan column shows "Add-on".
Example 8: SMS bundle. A school buys a 500 SMS bundle. No commission is created. If it was the school's first purchase, the referral stays "Awaiting first payment".
The commission period and expiry¶
- The period starts at the moment the school's first commission-earning payment is received.
- It lasts the number of months agreed for that school (1 to 12).
- A payment earns commission when it is received on or after the start and before the expiry moment. A payment received exactly at the expiry moment, or later, earns nothing.
Example: first payment on 15 January 2026 at 10:00, period 12 months. Expiry is 15 January 2027 at 10:00. A payment at 09:59:59 on 15 January 2027 earns commission. A payment at 10:00:00 does not.
Example with a shorter period: first payment on 31 January 2026, period 6 months. Expiry is 31 July 2026. A payment on 1 August 2026 earns nothing.
After expiry the referral stays in the list with the agreement Expired. Commissions already created are not affected and can still be approved and paid.
Note
A school that pays annually makes one payment a year. With a 12-month period, the second annual payment normally falls on or after the expiry moment and earns nothing.
Statuses¶
| Status | Meaning | Chip colour |
|---|---|---|
| Pending | Created, waiting for the SuperAdmin's approval | Amber |
| Approved | Approved, waiting to be paid out | Blue |
| Paid | Settled by a recorded payout | Green |
| Reversed | The school's payment was refunded or charged back | Red |
A clawback line (see below) shows the chip text Clawback until it has been settled in a payout, after which it shows Paid.
flowchart TD
P[Pending] -- Approve --> A[Approved]
A -- Record payment --> D[Paid]
P -- Refunded --> R[Reversed]
A -- Refunded --> R
D -- Refunded --> RC[Reversed + a clawback line - Approved]
Warning
There is no way back from any status. An approved commission cannot be un-approved, and a reversed commission cannot be restored.
The Sales Commissions list¶
Screenshot to be added
Screen: Sales Commissions page. Should show: the list with filters, the Approve and Refunded buttons, and the "Approve pending on this page" button.
Columns¶
| Column | Meaning |
|---|---|
| Payment Date | The date the school's payment was received |
| Salesperson | Name, with the referral code underneath |
| Driving School | School name, with a description of what was bought underneath |
| Gateway | PayFast, Paystack, Flutterwave, Stripe or Manual |
| Amount | The eligible amount |
| Gateway Fee | The fee, with Actual or Estimated underneath |
| Net Revenue | Net eligible revenue |
| Commission | The commission, with the percentage underneath |
| Status | The status chip. Under it: "Payout {reference}" once paid, and the reason once reversed. |
| Actions | Approve (Pending only) and Refunded (any commission that is not a clawback and not already Reversed) |
The list opens with the newest payment first.
Filters¶
| Filter | What it does |
|---|---|
| Search box ("Search school, salesperson or code...") | Matches the school name, salesperson name, referral code and the description |
| Salesperson ("All salespeople") | One salesperson's commissions |
| Status ("All statuses") | Pending, Approved, Paid or Reversed |
| Paid from / Paid to | Limits the list by the date the school's payment was received. Despite the wording, these do not filter by the date you paid the salesperson. |
Approving commissions¶
Approval is your check that the payment is real and the figures are right. Only approved commissions can be paid out.
To approve one commission
- Open Sales Management > Sales Commissions.
- Find the commission. Setting the Status filter to Pending helps.
- Click Approve on its row.
The message "Commission approved." appears.
To approve every pending commission on the page
- Filter the list as needed.
- Click Approve pending on this page (N). N is the number of Pending commissions on the page you are looking at.
- Confirm: "Approve the N pending commission(s) on this page? Approved commissions can be paid out."
- Click Approve.
The message "Commissions approved." appears. Only the rows on the current page are approved. If there are more pages, go to the next page and repeat.
Approving sets the status to Approved and records the approval time. A commission that is already Approved, Paid or Reversed is left as it is.
Refunds and clawbacks¶
Use Refunded after you refunded a school's payment outside DriveFlow, or after the gateway charged it back.
Important
DriveFlow does not make the refund. It only records it.
To mark a payment as refunded
- Open Sales Management > Sales Commissions.
- Find the commission earned on that payment.
- Click Refunded. The Payment refunded dialog opens.
- Type the Reason (required, at most 500 characters), for example "refunded by EFT on request" or "PayFast chargeback".
- Click Mark as refunded.
The message "Payment marked as refunded and the commission reversed." appears.
What happens:
| Record | Change |
|---|---|
| The commission | Status becomes Reversed. The reversal time and reason are stored. Its figures are kept as they were. |
| The school's subscription payment | Status becomes Refunded |
| The invoice for that payment | Status becomes Refunded |
| The school's subscription | Not changed. The school keeps its access. The dialog says: "The school's subscription is not changed here. End it under Subscriptions if it should stop." |
| The referral | Not changed. It stays locked. |
If the commission was already paid out, the dialog warns: "This commission was already paid out. A clawback of R ... is added and comes off {salesperson}'s next payout." A clawback is a new line with:
- the same salesperson, school and percentage,
- a negative commission amount equal to the commission that was paid,
- the description "Clawback: " followed by the original description,
- status Approved, so that it is ready to be included in the next payout,
- today as its payment date.
The salesperson's Outstanding figure goes down by that amount and can become negative. See Commission payments for how a clawback is settled.
Example: a commission of R 96.81 was paid out. The school's payment is then charged back. The commission becomes Reversed and a clawback of -R 96.81 is added. The salesperson's next commission is R 193.81. The next payout includes both lines and totals R 97.00.
Messages¶
| Message | Cause |
|---|---|
| Say why the payment was refunded. | The reason is empty |
| Commission not found. | The commission no longer exists |
| A clawback can't be refunded. | You tried to refund a clawback line |
| This commission is already reversed. | It was reversed before |
| Select the commissions to approve. | Approve was called with nothing selected |
Limitations and notes¶
- A refund is always for the whole payment. Partial refunds cannot be recorded.
- A reversal cannot be undone. If you reverse the wrong commission, the figures can only be corrected in the database.
- A commission's amount cannot be edited.
- Marking a payment as refunded does not end or shorten the school's subscription. Do that separately under Subscriptions.
- If a refund is made but never marked here, the commission stays payable.
- Commissions are not recalculated when a gateway fee rate, a plan price or a salesperson's percentage changes.
Related articles¶
- Gateway Fee Settings - the rates used for estimated fees
- Commission payments - paying out approved commissions
- Monthly commission reports - commissions per month
- Customer Referrals - the referral agreement behind each commission
- Salespeople - commission percentages and periods