The Fee Calculator helps you preview how fees will be applied before running a real transaction. It uses the configuration of an existing Fee Package to estimate the total amount charged, including a detailed breakdown of each rule, flat fees, percentages, and more.

This feature is especially useful when testing changes, validating logic with business teams, or integrating fee previews into your product UI.

Accessing the Fee Calculator

To open the Fee Calculator, go to the Fees page and click the Manage Tests button (Figure 1).

The calculator tab will open, allowing you to simulate the fee for a given transaction. (Figure 2)

How to simulate a fee

To simulate a fee calculation in the Console:

1. Go to the Calculator tab and enter the Transaction Amount (in cents).
2. Select a Fee Package from the dropdown.
3. Specify the rest of the information needed and click Calculate Fees.
4. The calculator will automatically estimate the total fee and display a detailed breakdown.

While the calculation is running, a loading indicator will appear. Once complete, the results are shown immediately below the form.

Understanding the results

The results include:

• Total fee: The total amount to be charged
• Breakdown: How each rule (flat or percentage) contributed to the total
• Descriptions: Labels that help clarify what each part of the fee represents

📘

Note

The Fee Calculator does not affect the ledger or perform any write operations. It's safe to run as many simulations as needed without triggering real transactions.

Best practices

• Use simulations to validate new Fee Packages before deploying them.
• Share screenshots or breakdowns with your finance team to align on expected outcomes.
• If you’re integrating fees into a frontend app, this tool can help design previews or validation flows.