All pages
Powered by GitBook
1 of 1

Loading...

Prices with tiers

Tiers are useful for grouping the transactions and setting prices for the groups respectively. You can only set up tiers for transaction-related fees. You can select a tier type for the price.

There are 3 types of tiered pricing models in Tuum:

  • Based on the transaction amount. For example, if the outgoing SWIFT payment is less than 10,000 USD then the transaction-related fee amount is 20 EUR. If the SWIFT payment is more than 10,000 USD then the related fee is 25 EUR.

  • Based on the transaction amount in tier currency. For example, if the outgoing SWIFT USD payment amount expressed in EUR is less than 10,000 EUR (up to 10,950 USD payment depending on the FX base rate), then the transaction-related fee amount is 20 EUR. If the SWIFT USD payment expressed in EUR is more than 10,000 EUR then the related fee is 25 EUR.

  • Based on the transaction grouping rule. For example, for the first 100 SEPA payments from the virtual accounts during the week, the transaction-related fee amount is 1 EUR per payment. For all the next SEPA payments from the virtual accounts during the same week, the fee is 0.80 EUR per payment.

More specific transaction groupings can be configured using specific APIs to set rules for gathering transaction statistics:

  • Aggregation period: DAILY, MONTHLY, WEEKLY or YEARLY.

  • Grouping type: COUNT or SUM.

  • Transaction type(s) to be counted or summer over aggregation period.

  • Label names to be used for more detailed statistics used in pricing.

Configuration of transaction prices with tiers

The configuration parameters are as follows:

Parameter
Type
Description

Fee calculation rule*

List

This field is used to define how the fee is calculated.

Select one of the following options:

  • Fixed fee - A fixed amount is charged.

  • Fixed fee with percentage - The fee is calculated as a fixed amount plus a percentage of the transaction.

  • Percentage fee - The fee is calculated as a percentage of the transaction.

Tier type*

List

Select one of the following tier options:

  • Group based - Based on transaction groups.

  • Amount single - Based on transaction amounts.

  • Amount single (in tier currency) - Based on the transaction amount in tier currency.

Tier application mode

List

This field describes the behavior when the transaction amount crosses the tier limit.

Select one of the following tier application modes:

  • Highest - The upper tier is selected for the calculation.

  • Partial - The transaction amount for calculation is split between 2 consequent tiers.

Tier currency code*

List

This field is displayed only if you select a tier type.

The tier currency is used to sum up transactions carried out in different currencies which is then used to find the appropriate price tier. Select a currency code from the drop-down list.

Transaction grouping code*

List

This field is displayed only if you select the tier type as Group based.

Select one of the options from the drop-down list. The displayed options depend on the fee type and pre-configured grouping rules to gather transaction statistics.

Transaction currency code*

List

The currency in which the transactions are carried out.

Select a transaction currency code from the drop-down list.

Fee currency code*

List

Select the currency in which the fee is charged from the drop-down list.

The list displays the currencies that are made available in your Tuum configuration.

Price date from*

Date

Select the start date for the price. Format: DD.MM.YYYY

Price date to

Date

Select the end date for the price. The last date is excluded from the period.

Format: DD.MM.YYYY

Tiers

Click Submit and the price is now available under the Fee type code. Click the Price id to view the price details. You have the option to edit and invalidate the price.

Samples of prices with tiers

Amount-based transaction sample

Consider that we want to set up a price for transaction fees for outgoing SEPA payments based on the following scenario:

  • For transaction amounts €100 - €200, the fee charged per transaction is €0.5.

  • For transaction amounts €200 - €500, the fee charged per transaction is €0.7.

  • For transaction amounts €500 - €1000, the fee charged per transaction is €1.2.

  1. Select the Fee calculation rule as Fixed fee.

  2. Select the Tier type as Amount single.

  3. Select the Tier application mode as Highest.

  4. Select the Tier currency code, Transaction currency code, and Fee currency code as EUR respectively.

  5. Select the date 05.04.2026 for the Price date from field. This is the date from which the price is available for fee calculation.

  6. Price date to is an optional field and you can edit the date later.

  1. According to the pricing scenario mentioned above, enter the values as follows:

Note that the Max transaction amount field excludes the last number from the range.

  1. Click Submit.

Group-based transaction sample

Consider that we want to set up a price for transaction fees for outgoing SEPA payments based on the following scenario:

  • For the first 100 transactions during the month, the fee charged per transaction is €0.9.

  • For the next 500 transactions during the month, the fee charged per transaction is €0.5.

  • For more than 500 transactions during the month, the fee charged per transaction is €0.2.

  1. Select the Fee calculation rule as Fixed fee.

  2. Select the Tier type as Group based.

  3. Select the Tier application mode as Highest.

  4. Select the Tier currency code as EUR.

  5. Select the Transaction grouping code as ACC2SEPA_COUNT. This means that the number of transactions in a month is counted.

  6. Select the Transaction currency code and Fee currency code as EUR respectively.

  7. Select the date 05.04.2026 for the Price date from field. This is the date from which the price is available for fee calculation.

  8. Price date to is an optional field and you can edit the date later.

  1. According to the pricing scenario mentioned above, enter the values as follows:

Note that the Max transaction amount field excludes the last number from the range.

  1. Click Submit.

In the Tiers section, click the icon and enter the amounts as applicable.

We are using the sample price list we created before - . From this price list, we are selecting the ACC2SEPA_FEE fee type and following these steps:

Click the icon to define a price for the fee. The Create new price for transactional fee page opens. The Fee type and Price list type code fields are filled automatically and you cannot edit them.

To add tiers, click the icon next to Tiers.

We are using the sample price list we created before - . From this price list, we are selecting the ACC2SEPA_FEE fee type and following these steps:

Click the icon to define a price for the fee. The Create new price for transactional fee page opens. The Fee type and Price list type code fields are filled automatically and you cannot edit them.

To add tiers, click the plus iconnext to Tiers.

TUUM_SAMPLE_PL
TUUM_SAMPLE_PL