Insurance software

Commission logic and reports for insurance brokers

Commission looks like a percentage until a policy is cancelled, a sub-broker changes hands, or an insurer changes its rate midway through a year. Good broker software keeps a record of why each amount was paid.

By itmarkerz Technologies. Updated 30 October 2026.

An old project, stated plainly

From about 2014 to 2019, we built and ran a platform for Indian insurance brokers. It began as a general insurance platform, became a broker CRM, and later extended to reinsurance. It had a broker and sub-broker hierarchy, policy and claims management, a policyholder login, supervisor reporting, regulatory reports in IRDAI format and reinsurance lead management. That work ended around 2019, so treat this as lessons about structure and not as current regulatory guidance. The worked example below is invented.

Model the rule, not the result

The classic mistake is to store a commission amount on a policy. It works until somebody asks why it was that amount. Keep the rule that applied, and keep every movement separately.

What a broker commission model should keep
RecordHoldsWhy
AgreementInsurer, product, rate, effective from and toRates change; old policies keep old terms
HierarchyWho reports to whom, with effective datesA sub-broker moving must not rewrite history
Policy snapshotThe agreement and hierarchy that applied at saleAnswers “why this rate?” years later
Commission linePayee, amount, type, source, and statusOne line per person and per event
ReversalA new negative line linked to the originalCorrections stay visible

A worked example

Suppose a broker earns 15% on a product and passes 10% to a sub-broker. These figures are made up, and real terms depend on your agreements and on the applicable rules. A premium of 1,000 gives the sub-broker 100 and leaves the broker 50. The questions that follow are where your software earns its cost:

  • Mid-term cancellation. The insurer refunds part of the premium. How much commission comes back, and from whom? If the sub-broker has already been paid, is it deducted from their next statement?
  • An endorsement. Cover is increased mid-term. Which rate applies to the extra premium: the one at sale or the current one?
  • Renewal. Is the renewal rate different? Who earns it if the original sub-broker has left?
  • Timing. Do you pay on premium receipt or on insurer payment? Statements must show what is earned and what is paid.

Write your answers down as test cases before any coding. They are also the agreements that your staff and sub-brokers will argue over, so it helps to have them settled.

Reports are a design input

On our platform, supervisors had their own reporting, and regulatory reports were generated in the required format. Reports like these shouldn’t be left to the end of the project, since they reveal which data you have to capture at the moment of sale. If a regulator or an insurer asks for a figure by a particular date or category and you didn’t store it, no report can recover it. Start from the current templates, from your current regulator, and work back to your data model. Keep a record of how each submitted report was produced, so you can reproduce it when asked.

The wider system

Commission rarely stands alone. Policyholders need a login to see policies and raise claims. Claims need a path from intake to settlement. Document-heavy workflows need review steps, and access to all of it should be limited by role and recorded. If you are weighing up custom work, the method in our build-or-buy guide transfers well: test any product with your worst real case. And if your commissions run across several levels of referral rather than brokers, see multi-level referral commissions.

The platform described here (about 2014–2019)

  • Platform for Indian insurance brokers, run for about five years: broker and sub-broker hierarchy, policy and claims management, customer login, supervisor reports, IRDAI regulatory reporting and reinsurance lead management.

    Sector
    Insurance & financial services
    Region
    India
    Year
    About 2014–2019
    Stack
    PHP, Laravel
    Engagement
    Built and run for about five years

Questions

Is this experience still current?

Our insurance platform ran from about 2014 to 2019, so the regulatory detail has moved on, and you should check current rules with your compliance team and your regulator. The structure of the problem hasn't changed much: who sold what, under which rule, and who gets paid when it changes.

Should a broker build or buy?

Look at products first. Building makes sense when your hierarchy, commission agreements or reinsurance work are unusual enough that a product means spreadsheets alongside it. Our rental guide has a build-or-buy method that applies here too.

More on regulated sectors

Is your commission worked out in spreadsheets?

Tell us how your hierarchy works and what your reports have to show. We will tell you what we would model first.

We reply within one business day (IST).