MLM software fundamentals
How MLM software works: modules, data flow and payouts
6 min readCodioo Engineering Team
The modules inside every MLM platform, how a commission run processes data step by step, and where custom development actually pays off.
What MLM software actually does
Every network marketing company runs on the same core loop: a distributor joins, the system records who sponsored them, product moves through that distributor's network, and the software calculates commissions based on the company's compensation plan. MLM software is the system of record for that loop. When people say "MLM software" they mean the platform that stores your distributor tree, processes orders, runs commission calculations and pays people.
A spreadsheet can track fifty distributors. A platform like this exists because at five hundred or five thousand distributors the tree gets deep, rank qualifications get conditional, and every commission run must be reproducible and auditable. The software's job is to make the compensation plan boring: the same inputs produce the same payouts every month, with a report to prove it.
The core modules
Most MLM platforms, whether off-the-shelf or custom built, are assembled from the same set of modules. Understanding them helps you evaluate vendors, because the differences live in how each module handles your plan's edge cases.
Genealogy: the distributor tree
Genealogy is the data structure at the center of the platform. It stores each distributor, their sponsor (who recruited them) and their placement (where they sit in the plan's structure). In a unilevel plan, placement follows sponsorship. In a binary plan, a distributor can be placed under someone other than their sponsor, which is why the distinction matters. The genealogy module answers questions like "who is in this leg", "what is this subtree's volume" and "where does the next placement go". Placement rules are plan specific: binary plans fill left to right or by weakest leg, matrix plans fill top to bottom left to right, and unilevel plans place directly under the sponsor.
The commission engine
The commission engine reads the genealogy plus a period's orders and produces payouts. A serious engine supports bonuses defined as percentages of volume, level based payouts, matching bonuses (a percentage of what your personally sponsored people earn), rank advancement bonuses and pool bonuses (a share of a company wide pool). The engine should run against a locked period: once you close a commission run, the numbers should not change, and re-running the same period should produce identical results. Ask vendors how they handle retroactive changes, such as a returned order from a previous period, and whether adjustments appear as clawbacks in the next run.
Replicated websites and back offices
Each distributor gets a replicated site (yourcompany.com/janedoe) and a back office where they see their downline, volumes, ranks, commissions and payment history. The back office is where distributors live, so its usability directly affects support load. Look for clear volume statements, rank progress bars and downloadable commission statements.
Order processing and ecommerce
Orders come from three places: the corporate storefront, distributor back offices (for autoship) and replicated sites. The platform needs to handle inventory, tax by jurisdiction, shipping calculations and payment processing. For US companies, sales tax nexus rules across states make this module harder than it looks, and it is worth asking exactly how the vendor handles nexus and exempt customers.
Payments and payouts
After a commission run closes, payouts go out by check, ACH, direct deposit, or wallet. Payout modules track payment status, support minimum payout thresholds and holdbacks, and export files your bank or payment processor accepts. Crypto payouts are increasingly requested; they belong in this module as another payout rail with its own ledger.
How data flows through a commission run
A commission run is the platform's most watched job. The sequence looks like this:
- Period close. The operations team closes the period (usually monthly). Orders after this point count toward the next run.
- Volume calculation. The engine walks every order in the period, applies product volume (PV/BV/CV) rules and attributes volume up the tree according to the plan.
- Rank evaluation. Each distributor's qualifications are checked against the plan's rank requirements: personal volume, group volume, active legs, rank legs and any one-time requirements.
- Bonus calculation. The engine computes each bonus type against the attributed volume and ranks, respecting caps, carrying balances (like binary points that accumulate until paid) and matching rules.
- Review and adjustments. Operators review totals, look for anomalies (a distributor earning a suspicious share of revenue) and post manual adjustments with notes.
- Lock and payout. The run is locked, statements become visible in back offices, and the payout file is generated.
A platform worth buying makes every step of this sequence inspectable. If a distributor asks "why did I earn 214 dollars and not 300", support should be able to open their statement and show the volume, rank and bonus lines that produced the number.
Where custom development pays off
Off-the-shelf platforms cover standard plans well. Custom development earns its cost when your plan is unusual, when you need deep integration with an existing ecommerce stack, or when you want a mobile app that distributors actually enjoy using. The most common custom work we see: hybrid plans that mix binary pairing with unilevel levels, real time rank progress in a mobile app, and payout rails beyond ACH. The least glamorous but highest value work is usually the commission engine: getting the plan's edge cases exactly right, with tests that prove it.
Right sizing the build: which modules you actually need
Not every company needs every module on day one, and overbuying is the most common budget failure we see. Scope follows two questions: how do distributors earn today, and what does corporate need to operate commission day confidently.
A company launching with one unilevel plan and a Shopify storefront needs the genealogy, engine, back office, ecommerce integration and one payout rail. It does not need a mobile app in month one if the field is small, multi currency, or crypto rails. Those arrive when the field asks for them, and a platform built with clean module boundaries adds them without rework.
Conversely, underbuying the commission engine itself is a false economy. The engine is the one module where "we will fix it later" means incorrect payouts later. Rank logic, caps and refund clawbacks belong in the first release even when everything else is deferred, because they are the rules the field tests in week one.
A useful exercise before scoping: list what your support team answers by phone today. Every recurring question maps to a missing self service screen, and the mapping usually reshapes the priority list more honestly than a feature comparison does.
What to ask a vendor about their architecture
- Is the commission engine a black box, or can we see the calculation for any single payout?
- Can we lock a period and guarantee that a re-run produces identical numbers?
- How are plan changes handled: configuration, code changes, or a migration?
- Where does the software run, who holds the encryption keys, and how do we export our data if we leave?
- What is the recovery plan when a commission run fails at 2 AM on payout day?
The answers tell you more about a vendor than a feature list does. If you are early in the process, our guide to choosing MLM software walks through the full evaluation, and our development service page explains what a custom build includes.
MLM softwarecommission enginegenealogypayouts