Manage Brokerage Fees

Introduction

You can now easily manage brokerage fees on the platform to ensure accurate fee tracking and reporting.

In this guide, you’ll learn how to:

Set brokerage fees (%) at the Mandate level.
View Estimated Fees while creating BUY/ SELL orders.
Check automatic calculation of external commission and brokerage markup during transaction matching (visible on the transaction card).
Review platform-generated fees in the Fee object after confirmation of transaction.
Verify how platform marks markup fee during reconciliation.

Key Terminologies

Term (A-Z)	Definition
Accrued	A platform-assigned status indicating that a fee has been calculated and recognized but not yet paid.
Awaiting Review	A status reason under Brokerage Fee type, created when the calculated Brokerage Markup is zero or negative, requiring back-office verification before payout.
Awaiting Payout	A status reason under Brokerage Fee type, indicating that the Brokerage Markup has been approved and ready for payout, but the transfer has not yet been initiated.
Brokerage Fee	A commission charged by the broker for executing trades on your behalf, expressed as a percentage of the transaction value.
Brokerage Markup	An additional fee applied on top of the standard brokerage commission. It represents the broker’s earnings or spread and is included during reconciliation to ensure total fees reflect the applied markup.
External Commission	A fee charged by an external party or counterparty for executing or facilitating a transaction. This fee is separate from the platform’s brokerage fee and is typically calculated as a percentage of the transaction value.
Fee	A platform-generated record that stores details of calculated charges (such as brokerage or markup) after transaction confirmation.
Mandate	A contractual agreement between you and your client that defines investment terms, strategies, and applicable fees.
Order	A trade instruction placed to buy or sell a financial instrument.
Reconciliation	The process of comparing and validating transactions to ensure that all brokerage/markup fees and commissions are accurately reflected and settled.

👉 New to some terms? Check out full Glossary for quick descriptions.

Set Brokerage Fees on Mandate

You can add brokerage fees either when creating a new mandate or by editing an existing one.

🔗 Learn here on how to create or manage Mandate.

To Add or Edit Brokerage Fees:

Go to Accounts > Mandates
Click the + icon to create a new mandate or click an existing mandate to open it.

The Mandate form opens. If you’re editing an existing mandate, you’ll see its details screen.
Go to the Fees tab and click the “+” icon to add a new fee entry.

Fill in the required fields on the Fee form.

Detailed Fields Table Here:

Field

Description

Type (*)

Select the type of fee from the dropdown. Choose BROKERAGE when adding brokerage fees. Other options include:

MANAGEMENT
SUCCESS
EXECUTION
OPERATION
CUSTODY
SAFEKEEPING
OTHER

Rate, % (*)

Enter the brokerage percentage that applies to the mandate. This value determines how brokerage fees will be calculated during trade execution.

Ccy (Default)

The fee is always charged in the Order Execution Currency. You can’t predefine it at the mandate level.

Set Criteria for Brokerage Fees (Optional):

You can make a fee conditional by enabling the Show Criteria toggle. Once enabled:

platform Field* – Choose the field.
Value* – Enter the value.
- Use + Add Value to add more, Remove to delete.
+ Add Criteria – Add additional rules if needed.
Criteria Pattern
- Displays a summary of all defined criteria and how they are connected — 1 AND 2.

The workflow triggers only when all criteria are satisfied.

Click Save and the added fee will appear in the list and you can Edit or Delete it, if needed.

View Estimated Fees on Orders

Go to Transactions > Orders tab and click the + icon.
Select the Buy/Sell order type.
On the order form, after entering the required details, hover over the icon to view more information.

🔗 Learn here on how to Create Orders.

The fee displayed is estimated. The exact amount will be confirmed at execution and charged in the order’s currency.

Automatic Fee Calculation During Transaction Matching

Once your transaction is matched, the platform automatically calculates External Commission and Brokerage Markup.

When creating a transaction, you can add the following fields on the order form:
- External Commission
- Brokerage Markup
Once the order is active and matching occurs, these fields automatically display calculated values.

You don’t need to manually adjust them. The platform applies calculations based on the set brokerage rate and execution currency.

Fees Generated After Confirmation

When the transaction is confirmed, the platform automatically generates a Fee record in the Fee object.

Here’s what happens behind the scenes:

The platform captures confirmed transaction data.
It applies the brokerage rate and markup based on mandate rules.
A new Fee object is created to store details such as:

Detailed Fields Explained Here:

Field	Definition	Meaning	How it’s Filled / Why it Happens
Name	Internal label for the fee record (e.g. Q12025).	Identifies the fee period in reporting.	Usually auto-generated (quarter tag) but can be edited manually.
Portfolio	The client’s portfolio linked to the trade.	Ensures markup is tied to the correct client mandate.	Auto-filled from the order/transaction context.
Type	Type of fee object. Here: `BROKERAGE_MARKUP`.	Identifies it as the broker’s internal margin (hidden from client).	Auto-assigned by the platform during fee creation.
Bank Account	Client’s bank account where the trade occurred.	Tracks which account holds the accrued fee before payout.	Auto-filled from the transaction’s bank account.
Amount	Value of the markup = (Tariff Client Commission − External Commission).	Positive = broker profit; Negative = broker loss.	Calculated by platform at reconciliation.
Start Date	The start of the fee recognition period.	Defines the applicable timeframe for the fee.	Mandatory – must be entered at creation (for reporting consistency).
End Date	The end of the fee recognition period.	Defines the end of the applicable timeframe.	Mandatory – must be entered at creation.
Status	Current lifecycle state of the fee. Example: `Accrued`.	Tracks progress: Created → Accrued → Awaiting Payout → Settled.	Auto-updated by the platform.
Status Reason	Additional detail on why a fee is in its status. Two key cases: Awaiting_review – if markup ≤ 0, platform flags it for manual validation/adjustment. Awaiting_payout – once the fee is accrued and confirmed as payable, waiting for payout processing.	Ensures back office knows whether fee needs review or is ready for payout.	Auto-set by the platform based on fee amount and process stage.

You can review all generated fees by navigating to:

Transactions > Fees tab or via the linked Fee object on the transaction card.

Markup Fee in Reconciliation

During reconciliation, the platform automatically includes the Markup Fee in the Reconciliation Data tab.

The Brokerage Markup Fee must already be generated and accrued (via the confirmed transaction) before it appears in the Reconciliation Data tab.

Go to Reconciliation > Reconciliation Data tab

Here’s how it works:

The platform compares and validates executed transactions against custodian or counterparty records.
The Markup Fee — previously accrued under the Fee object — is displayed as part of the reconciliation data.
Ensures the total reflected fee aligns with the executed order’s value.