Commission & Charges
Commission and charges define the financial rules of your marketplace: how much of each order your merchants keep (and you earn), the taxes applied to orders, and the additional charges and payment-method fees that appear on the customer’s bill. All of it is configured under the dashboard’s financial and payment settings and applied automatically — at checkout, in earnings calculations, and in reports — so order totals, merchant earnings, and your accounting always agree.
The four financial levers
Section titled “The four financial levers”| Lever | Who pays | Where it’s configured |
|---|---|---|
| Commission | The merchant — deducted from their share of each order | Financial → Outlet Earnings Setup |
| Tax | The customer — itemized at checkout | Financial → Tax |
| Charge | The customer — service charge, packaging fee, etc. | Financial → Charge |
| Payment-method fee | The customer — varies by how they pay | Payment → Payment Config, per method |
Commission — Outlet Earnings Setup
Section titled “Commission — Outlet Earnings Setup”Dashboard → Settings → Financial → Outlet Earnings Setup (/configuration/financial/commission/list) defines how each outlet’s earnings are computed per order — i.e. your commission rules. The earnings rules you set here drive the outlet earnings reports and the settlement balances you eventually pay out.
A few principles that keep commission setups manageable:
- Start with one standard rule. A single marketplace-wide rate is easy to explain to merchants and easy to verify in reports. Add exceptions only when a negotiation requires it.
- Per-outlet arrangements are supported. Merchants with negotiated terms can have their own earnings rule, so an anchor merchant’s special deal doesn’t force a marketplace-wide change.
- Verify with a test order. After changing a rule, place a test order at an affected outlet and check the outlet earnings report (
/reports/outlet-earnings) reflects the split you expect.
Configure the taxes your region requires under Dashboard → Settings → Financial → Tax (/configuration/financial/tax/list); add new entries at /configuration/financial/tax/add/new. Each tax has a customer-facing name, a calculation type (percentage or fixed), the rate or amount, applicability conditions, and a status. Active taxes that match an order are itemized at checkout and on receipts.
Reconcile collected tax with the tax-wise report (/reports/tax-wise).
Charges
Section titled “Charges”Order-level charges — a service charge, packaging fee, or similar — live under Dashboard → Settings → Financial → Charge (/configuration/financial/charge/list), with the same shape as taxes: name, percentage or fixed, amount, conditions, status. Use conditions to scope a charge to the orders it belongs on (for example, a packaging fee that applies to delivery but not dine-in).
Track them with the charge-wise report (/reports/charge-wise).
Payment-method fees, cashback, and reward points
Section titled “Payment-method fees, cashback, and reward points”Each payment method entry in Dashboard → Settings → Payment → Payment Config (/configuration/payments/payment/list) can carry its own economics:
- Fee — a fixed amount plus a percentage, with an optional maximum cap, added when the customer pays with that method. Commonly used to offset cash-handling or gateway costs.
- Cashback — credit back to the customer for choosing that method; a lever for steering customers toward prepaid orders.
- Reward Points — points earned when paying with that method, feeding your rewards program.
Because these sit on the method entry, you can price methods differently — for example, a small fee on cash on delivery and cashback on wallet payments. Method setup itself is covered in Gateway Setup.
Checking the numbers
Section titled “Checking the numbers”Three reports under Dashboard → Reports keep the financial rules honest:
| Report | Route | Use it to |
|---|---|---|
| Tax-wise | /reports/tax-wise | Reconcile collected tax for filings |
| Charge-wise | /reports/charge-wise | Confirm charges are applying as intended |
| Payment-wise | /reports/payment-wise | See volume and totals per payment method, including method fees |
Commission outcomes show up in the outlet earnings reports — see Settlements.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Try this |
|---|---|
| A tax or charge isn’t appearing at checkout | Check its status is active and its conditions match the test order (order type, amount) |
| Merchant disputes their earnings on an order | Open /reports/outlet-earnings-list, find the order, and walk through the earnings rule together — the per-order entry shows the split |
| A method fee isn’t being added | Open the method’s Payment Config entry and confirm the Fee settings and any maximum cap |
| Totals differ between checkout and reports | Confirm the order wasn’t edited after placement — edits recalculate taxes and charges; see Editing & Refunds |
Related: Payments Overview · Settlements · Gateway Setup · Reports