Marketplace commission that fits every deal.

Vendor plans give one commission per plan. Advanced Commission Rules adds the exceptions real marketplaces need: a negotiated rate for a key vendor, a lower rate on expensive electronics, volume tiers or a minimum fee per order.

  • v1.1.1
  • CS-Cart 4.17.2 – 4.21.x (Multi-Vendor)
  • 30-day refund on a first purchase
Admin, Vendors > Commission rules: rule list sorted by priority with conditions, rates, specificity, state labels and the search sidebar (vendor, plan, status).
Add-on settings: apply rules to new orders, rule resolution (most specific / priority) and the default discount handling of the commission base.
Rule editor, Conditions: vendors, vendor plans, categories with subcategories, products, then price / subtotal / monthly sales ranges and order dates.
Simulator result: commission with rules, plan-only commission, vendor payout, matching rules and the calculation per rule and product.

The problem

One rate per plan is not enough

Multi-Vendor sets commission per vendor plan, plus an optional percentage per category. As soon as you negotiate with a large vendor or run a launch promotion for a new category, you need a new plan or a manual correction.

Manual corrections are where marketplace accounting goes wrong: the vendor balance, the payout and the order page stop agreeing.

Three ways to handle exceptions

ApproachHow it worksTrade-off
One plan per exceptionCreate a vendor plan for every special rate.Plans multiply, and a plan cannot vary by category, price or sales volume.
Manual adjustmentsCorrect commissions in accounting after the order.Error-prone, and the vendor sees one rate on the order and another on the payout.
Rules on top of plansWhat Advanced Commission Rules doesDescribe only the exceptions; everything else keeps the plan commission.You need to keep the rule list tidy, which the simulator helps with.

Advanced Commission Rules

How it works

  1. 01

    Add rules

    In Vendors > Commission rules, combine up to 8 condition types: vendor, plan, category with subcategories, product, unit price, order subtotal, monthly vendor sales and dates.

  2. 02

    Test in the simulator

    Pick a product and see which rule applies and why, before you save. Choose most-specific-wins or priority order.

  3. 03

    Orders use the result

    New orders get the rule-based commission. Vendor balances, accounting, order pages and payment splits all use it; earlier orders never change by themselves.

What you get

8 condition types

Vendor, plan, category, product, price range, order subtotal, monthly vendor sales and date range.

Percent + fixed fee

A percentage plus a fixed amount per order, with a minimum and maximum commission.

Your commission base

Per rule: include or exclude shipping and taxes, before or after discounts.

Per-order breakdown

The order page shows the calculation per rule and product; edits and refunds follow it.

Report and CSV

Compare rule and plan commission, and export the report as CSV.

My commission rates

Vendors see a read-only page with the rates that apply to them.

Made for

  • Marketplaces with key vendors
  • Electronics and high-ticket categories
  • Category launch promotions
  • Volume-based vendor tiers
  • Minimum fee per order
  • B2B marketplaces

Advanced Commission Rules

Screenshots

When vendor plans stop being enough

Core Multi-Vendor gives each vendor plan a percent plus a fixed fee, and the bundled Commissions by category add-on gives a percent per category and plan. For a young marketplace that is plenty. Then the first real deals arrive: a key vendor negotiates 8%, expensive electronics cannot carry the same rate as accessories, a new category needs a launch promo for six weeks, and high-volume sellers ask for a better tier.

Each of those can be forced into a new plan or a manual correction. Plans multiply, and corrections are how accounting drifts: the order page says one thing and the payout says another. Advanced Commission Rules lets you describe only the exceptions. A product without a matching rule keeps the plan commission or category rate exactly as before.

How a commission is calculated, line by line

When a vendor order is placed, core calculates its commission as usual. The add-on then looks at every product in the order and picks one rule for it. Each rule contributes the sum of its products' bases times its percent, plus its fixed amount, limited by its minimum and maximum per order. Products without a rule contribute their core rate. The total never exceeds the order total, and the result is stored on the vendor payout, so the balance and Accounting need no special handling.

Which rule wins when several match?

By default the most specific rule wins. Each condition scores points, shown in the rule list and the simulator:

Rule specificity points
ConditionPoints
Products32
Categories16
Vendors8
Vendor plans4
Product price2
Order subtotal, vendor sales this month, order date1 each

So an "Apparel 12%" category rule (16) beats an "ACME Corp 8%" vendor rule (8) for an ACME Corp jacket, while ACME Corp’s electronics get 8%. If you prefer a plain first-match list, switch the setting to lowest priority number. On a tie, the lower priority number wins, then the older rule.

A rule replaces the plan commission for the products it matches, including the plan’s fixed fee. The plan fixed fee is charged only when at least one product in the order has no rule.

Commission rules marketplaces actually set up

  • Negotiated rate: Vendors = ACME Corp, 8%.
  • Lower rate on expensive items: Categories = Electronics, Product price from 1,000, 6%, maximum per order set.
  • Launch promo: Categories = Garden with subcategories, Order date from and to, 3%. Ended rules show as Expired, future ones as Scheduled.
  • Volume tiers: two rules on Vendor sales this month, for example 10% below 5,000 and 8% from 5,000.
  • Minimum fee on small orders: a rule with a minimum commission per order.
  • Commission on shipping or not: include shipping and taxes per rule, and calculate before or after discounts.

Before you save, the simulator shows the result for any product: commission with rules, what the plan alone would charge, what the vendor receives, and every matching rule with the applied one highlighted. Nothing is saved, and taxes are not simulated.

Past orders, edits and refunds

Creating, editing or deleting a rule affects new orders only. Vendors should never find that last month’s commission moved because someone tidied a rule. If you do want to apply current rules to earlier orders, the Recalculate orders tab previews up to 500 orders per run, then adds one Order changed entry per difference. Earlier entries are not rewritten, and running it twice changes nothing.

Edited orders are recalculated with the rules as of the original order date. On refunds through RMA, commission is returned at the order’s effective rate, and a full refund returns everything charged. Vendors see the calculation on their order pages and a read-only My commission rates page, unless you turn those off. Rule management is never available in the vendor panel.

The report lists every payout entry calculated by rules, with what the plan alone would have charged, and exports to CSV. That comparison tells you what each exception actually costs or earns.

Rules, extra plans or manual fixes?

Three ways to handle commission exceptions
One plan per dealManual correctionsRules
Vary by category or priceOnly by category percentBy handYes
Volume tiersNoBy handYes, on monthly vendor sales
Time-limited ratesNoBy handYes, date range
Order page matches payoutYesOften notYes
UpkeepPlans multiplyEvery periodKeep the rule list tidy

If all your sellers really pay the same rate, you do not need this add-on: vendor plans are enough. It earns its place at the first exception you would otherwise fix by hand.

It pairs with Vendor Payouts Automation, which pays out the balance these rules produce, and with Commission Invoices & Vendor Statements for monthly invoices to vendors. See Advanced Commission Rules on the store.

Versions and requirements

Multi-Vendor 4.17.2 to 4.21.x on PHP 7.4 to 8.3, as your version supports. The bundled Vendor plans add-on must be active, which it is by default. Commissions by category is optional. Payment add-ons that split by the payout commission use the rule result. CS-Cart Standard and Ultimate refuse the installation.

CS-Cart

Advanced Commission Rules at a glance

Commission rules on top of vendor plans: by vendor, plan, category, product, price, order subtotal, monthly sales and dates, with fixed fees, caps, a simulator and reports.

Price
Multi-Vendor $129 (one-time)
Version
1.1.1
Compatible with
CS-Cart 4.17.2 – 4.21.x (Multi-Vendor)
Licence
One production store, perpetual, 12 months of updates and support
Refund
30-day refund on a first purchase

CS-Cart

The CS-Cart products stores buy first

The most requested products on this platform. Each one has its own page, and you can buy it straight on the sales site.

Shop CS-Cart on our sales site

Prices, licences, full documentation and instant downloads are on the store.

cs-cart.kaviolabs.com · 98 add-ons · 29 themes

FAQ

Questions and answers

Do I have to rewrite my vendor plans?

No. Products without a matching rule keep the plan commission and category fees. You only describe the exceptions.

Will it change commissions on past orders?

No. Earlier orders are never recalculated by themselves. An explicit tool can recalculate selected orders, with a preview, by adding adjustment entries instead of rewriting history.

Does it change core files?

No. It has no core file changes, and uninstalling leaves earlier commissions intact.

Which editions does it support?

Multi-Vendor and Multi-Vendor Ultimate 4.17.2 to 4.21.x.

What is the difference between a rule and Commissions by category?

Commissions by category sets one percent per category and plan. A rule can combine vendor, plan, category, product, price, order subtotal, monthly sales and dates, and add fixed amounts and caps. Products without a rule keep the category rate.

Can I test a rule before using it?

Yes. The simulator shows the commission with rules, the plan commission, the amount the vendor receives and every matching rule. Nothing is saved.

Can vendors see or edit the rules?

Vendors can see a read-only My commission rates page and the breakdown on their orders, unless you switch those off. They can never manage rules.

How do I set volume tiers?

Use the condition Vendor sales this month. It counts the vendor’s orders placed earlier in the same calendar month, in statuses that count for payouts.

What happens if I disable the add-on’s rules?

With Apply commission rules to new orders off, new orders get the plan commission again. Existing orders are not recalculated, and the rules, simulator and report stay available.

Set the commission your deals actually say

The product page has the full documentation, screenshots and the changelog.

Kavio Labs

Also by Kavio Labs

The same standards, the same support desk and one licence portal on every platform we build for.