Commissions

How to set up accounting, reconciliation, and balance-based routing

The Commissions section is where you define commission calculation rules that will be inherited by orders (deposits and payouts) and then appear in payments, reports, and reconciliation.

1. Why commissions matter (business logic)

Commissions solve two key business tasks.

1.1. Accounting, reporting, and reconciliation

If you configure actual gateway/PSP fees, then payments, reports, and reconciliation will display:

the correct commission amount,

correct transaction economics (net / gross depending on the report),

transparent obligations and settlement calculations (netting).

Result: less manual Excel work and clearer financial control.

1.2. Routing and cascading based on gateway balances

A gateway/PSP balance can be used in routing and cascading:

a payout cascade can automatically skip a gateway with a zero balance;

you can set a limit so that a PSP balance does not exceed X:

once the balance reaches X, deposits go to another gateway,

after settlement the balance decreases,

and deposits automatically start going to this gateway again.

This is useful when managing liquidity, provider limits, and settlement schedules.

2. Terms: what you configure

2.1. What is a commission?

A commission is a set of rules that is inherited by a Deposit order or Payout order at the moment the order is created.

Important: after the order is created, the commission is “locked” inside the order data.

2.2. What is a commission group?

A commission group is a “container” with base parameters:

Name

Type (Merchant / Gateway / Referral — depending on your model)

Currency

Channels (one or multiple)

Inside a group, you create one or many commission rules.

2.3. What is a commission rule?

A commission rule is a specific commission calculation formula, usually based on an order amount range:

minimum commission,

fixed commission,

percentage,

maximum commission,

rolling reserve (withheld share) and its expiration period.

3. How commission application works

3.1. Which commission is applied if it was changed after the order was created?

The system applies the commission that was set at the moment the order was created.
If you update commissions later, already created orders are not recalculated.

3.2. Example

An order is created at 11:00, commission is 2%.

At 11:07, commission is changed to 4%.

The commission for that order will be calculated using 2%, because that value was active at the time of order creation.

4. What you can do in the Commissions section

In this section you can:

Create and edit commission groups.

Create and edit rules inside groups.

Search commissions and use filters.

5. How to find a commission group

Open Commissions from the main menu.

Use the Name or ID search.

If needed, apply filters:

Commission type

Currency

Channel

To reset, click Clear Filters.

6. Columns in the commission groups list

Common columns in the groups table:

Name — commission group name;

Type — commission type (Merchant / Gateway / Referral);

Currency — commission currency;

Channels — channels linked to the group;

Default — “default group” flag (if used);

ID (GUID) — group identifier;

⋮ (Actions) — actions (Update / Delete).

7. How to create a commission group

Open Commissions.

Click + New commission (top-right).

Fill in the form fields (Name / Type / Currency / Channels).

Click Save/Add.

8. How to edit or delete a commission group

Find the required group in the list.

Click ⋮ (kebab menu) at the end of the row.

Choose:

Update — to edit parameters,

Delete — to remove the group.

When updating, click Save.

9. How to view commission rules

In the groups list, click the required group row.

The group expands and shows the list of commission rules.

10. How to create a commission rule

Open the required group (click the row).

Click + Add commission rule.

Fill in the rule parameters.

Click Save.

To add more rules, click + Add commission rule again.

11. Columns in the commission rules list (and how to interpret them)

Typical rule fields:

Order Amount — order amount / amount range.

Minimum Commission — minimum commission (amount).

Fixed Commission — fixed commission (amount).

Percent Commission — commission percentage.

Maximum Commission — maximum commission (amount).

Rolling Commission — withheld/frozen share for a period (rolling reserve).

Rolling Expire days — withholding period in days.

Tip: fixed and percent often work together, while min/max limit the final commission.

12. Practical recommendations

Keep commissions up to date — otherwise reports and reconciliation will not match provider statements.

Create separate groups for different scenarios (channels, currencies, operation types).

Use amount-range rules — it helps model PSP terms and keep economics under control.

13. Where commissions are used next

After configuration, commissions are reflected in:

payments and transaction details,

reports,

reconciliation,

routing/cascading logic (if provider balance is used in your routing rules).

How to set up accounting, reconciliation, and balance-based routing#

1. Why commissions matter (business logic)#

1.1. Accounting, reporting, and reconciliation#

1.2. Routing and cascading based on gateway balances#

2. Terms: what you configure#

2.1. What is a commission?#

2.2. What is a commission group?#

2.3. What is a commission rule?#

3. How commission application works#

3.1. Which commission is applied if it was changed after the order was created?#

3.2. Example#

4. What you can do in the Commissions section#

5. How to find a commission group#

6. Columns in the commission groups list#

7. How to create a commission group#

8. How to edit or delete a commission group#

9. How to view commission rules#

10. How to create a commission rule#

11. Columns in the commission rules list (and how to interpret them)#

12. Practical recommendations#

13. Where commissions are used next#