Skip to content

Commission Payment (multi-level)

Access Prerequisites

  • Permission (module): viewCommissions OR manageCommissions
  • 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: viewCommissions or manageCommissions registered 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

  1. Access the menu Commissions and Rewards → Commission Payment (/manage-multilevel-commissions).
  2. The screen loads the commissions and enriches them with the user's e-mail (by crossing userId with the user list) and the asset name (by crossing unit_of_money with the asset list).
  3. Use the search to filter by e-mail, userId, reason (reason) or id.
  4. Click the view payments icon on a row to open the modal with the payment breakdown.
  5. Use Export CSV to download the full listing (date, e-mail, amount, currency, number of payments).

Filters and columns

Filter / ColumnWhat it showsData source
SearchFilters by e-mail, userId, reason or commission idClient-side filter over the loaded list
Date (when)When the commission was generatedmultilevel_commissions.when (CPM)
User / E-mailBeneficiary user of the commissionuserId enriched with email via user list
Amount (amount)Total commission amountmultilevel_commissions.amount, displayed via BigNumber with 2 decimal places
Currency (unit_of_money)Commission asset/currencyWhen the id is longer than 20 characters it is resolved to the asset name; otherwise the code itself is displayed
No. of paymentsNumber of payments that make up the commissionpayments.length

Actions and modals

  • View payments: opens the Payments modal, listing each multilevel_commissions_payments of the commission with user (e-mail), amount and processing status. Read-only.
  • Export CSV: generates a multilevel-commissions_<date>.csv file 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 wasProcessed flag 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.