Commission Payment (multi-level)
Access Prerequisites
- Permission (module):
viewCommissionsORmanageCommissions - License/Feature: None
- Menu container: GENERAL → group Commissions and Rewards
What it is / when to use
Audit screen for already-generated multi-level commissions. Each row is a commission created by the multi-level engine (entity multilevel_commissions) and aggregates its individual payments per level (multilevel_commissions_payments).
Use it when you need to verify how much commission was generated, for which user, in which currency/asset, and how many payments make up that commission. This is a read-only screen — it does not create or reprocess payments.
Prerequisites
- Permission:
viewCommissionsormanageCommissionsregistered for the operator role (double permission: CPM enum on the backend + dynamic module in the DB). - License/Feature: None.
- Dependencies on other screens: commissions only exist if levels are configured in Commission Configuration and end-user actions trigger the engine.
Step by step
- Access the menu Commissions and Rewards → Commission Payment (
/manage-multilevel-commissions). - The screen loads the commissions and enriches them with the user's e-mail (by crossing
userIdwith the user list) and the asset name (by crossingunit_of_moneywith the asset list). - Use the search to filter by e-mail,
userId, reason (reason) orid. - Click the view payments icon on a row to open the modal with the payment breakdown.
- Use Export CSV to download the full listing (date, e-mail, amount, currency, number of payments).
Filters and columns
| Filter / Column | What it shows | Data source |
|---|---|---|
| Search | Filters by e-mail, userId, reason or commission id | Client-side filter over the loaded list |
Date (when) | When the commission was generated | multilevel_commissions.when (CPM) |
| User / E-mail | Beneficiary user of the commission | userId enriched with email via user list |
Amount (amount) | Total commission amount | multilevel_commissions.amount, displayed via BigNumber with 2 decimal places |
Currency (unit_of_money) | Commission asset/currency | When the id is longer than 20 characters it is resolved to the asset name; otherwise the code itself is displayed |
| No. of payments | Number of payments that make up the commission | payments.length |
Actions and modals
- View payments: opens the
Paymentsmodal, listing eachmultilevel_commissions_paymentsof the commission with user (e-mail), amount and processing status. Read-only. - Export CSV: generates a
multilevel-commissions_<date>.csvfile with the listing columns, on the client.
Business rules / caveats
Attention
- The currency field may appear as a UUID when the asset is not in the loaded list — in that case the id is displayed raw. Confirm the asset in Token Holders if in doubt.
- The
wasProcessedflag per payment indicates whether the credit has already been settled. Pending payments have not yet been settled.
- Financial values: all values are BigNumber — the interface formats them with 2 decimal places for display only; do not use the displayed value for accounting reconciliation without checking the original precision.