All pages
Powered by GitBook
1 of 12

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Create prices for periodic fees

Periodic fees are related to an account and are posted periodically according to the agreed schedule.

The scenarios for periodic fees are as follows:

  • A fixed amount is charged at the beginning of every month or after the end of the month.

  • A fixed amount is charged every month at the beginning of the period from the account opening date or after the end of that period. For example, if the account was opened on the 15th of May, then a period would begin from the 15th of the month. The fees are charged from the beginning of this period or after the end.

  • An amount is calculated based on the specific type of fee transaction or fee booking volumes during the passed period with a minimum amount. The fee can only be calculated and charged after the end of the period.

Periodic fees can be charged as:

  • Each fee is debited immediately from the customer account or fee service account.

  • At the end of the agreed invoicing date every month, all the different types of fee bookings are invoiced. The total invoiced amount is debited from the customer account or fee service account at once.

By default, the following periodic fees are present:

Fee type code
Description

ACC_ADM_FEE

Account maintenance fee.

VIBAN_MONTHLY_FEE

Maintenance fee for a virtual account (vIBAN).

Configuration of prices for periodic fees

Parameter
Type
Description

Periodic fee period rule code

List

This field determines when the next fee is to be posted. The fee can be charged immediately or later, depending on the fee lifecycle rules.

You can select one of the following options:

  • MONTH_ACCOPEN_END - The period is set from the start of opening the account and the fee is posted the day after the end of the period.

  • MONTH_ACCOPEN_START - The period is set from the start of opening the account and the fee is posted at the start of the period.

  • MONTH_CAL_END - The period is set according to the calendar month and the fee is posted the day after the end of the period.

  • MONTH_CAL_START - The period is set from the start of opening the account and the fee is posted at the start of the period.

Fee calculation rule*

List

This field defines how the fee is calculated.

You can only select the Fixed fee rule. This means that the periodically charged fee is fixed to a certain amount. You must specify this amount in the Prices section on the same page. Note: For the VIBAN_MONTHLY_FEE fee type, you also have the option Floor amount, only if the Periodic fee period rule code is MONTH_CAL_END. Floor amount refers to the minimum total amount for the summed fees over a period.

Partial period rule*

List

This field defines how the fee is calculated for partial periods. The partial period may be at the beginning and end of the service usage duration.

Select one of the following options:

  • No fee - The fee is not calculated for the partial period.

  • Full price - The total periodic fee is applied to the partial period.

  • Proportional price - The fee is calculated according to the number of days the service is used during the partial period.

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 available in your Tuum configuration.

Price date from*

Date

Select the start date for the price.

Format: DD.MM.YYYY

Price date to (last excl)

Date

Select the end date for the price.

The last date is excluded from the period.

Format: DD.MM.YYYY

Labels

List

You can select a label for detailed pricing if the periodic fee type has labels defining the periodic fee subtypes attached with it.

Fixed amount*

Number

Enter an amount for the periodic fee.

  • Click Submit to save the price.

  • Click Close to discard.

The Fees that are summed over a period field is displayed only for the VIBAN_MONTHLY_FEE fee type. The field is non-editable and the value is fixed - VIBAN_IN_FEE, VIBAN_OUT_FEE. These fees are aggregated for a period and used in floor pricing calculations.

For example, when the total amount during the period VIBAN_IN_FEE + VIBAN_OUT_FEE on an account is €900 and the Floor amount value is set as 1000, then the VIBAN_MONTHLY_FEE for the particular month is €100. But if the floor value is 800, then the VIBAN_MONTHLY_FEE is not taken into consideration.

Sample of a periodic price

Consider that we want to set up a price of €7.89 for account maintenance. This price is charged to a customer account at the end of every month.

  1. Select the Periodic fee period rule code as MONTH_CAL_END. This means that the price is charged at the end of every month (i.e. the first day of the next month).

  2. Select the Fee calculation rule as Fixed fee. This means that a fixed amount is charged for account maintenance.

  3. Select the Partial period rule as Proportional price. This means that the price charged for a partial period is proportionate to the time the account is open.

  4. Select the Fee currency code as EUR.

  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.

  7. Enter 7.89 as the Fixed fee amount. Click Submit.

Result: The fee of €7.89 is charged to the customer account after the end of every month for account maintenance.

The following screenshot shows the fee creation page with the sample values:

Labels for periodic fees

The following table shows the possible labels for the 2 periodic fee types:

Fee type code
Label name
Label value
Description

ACC_ADM_FEE

accAdmFeeSubtype

ACC_ADM_BACS_MONTHLY_SERVICE

BACS monthly service fee.

ACC_ADM_FASTER_MONTHLY_SERVICE

FASTER monthly service fee.

ACC_ADM_BACS_ACCESS

Agency scheme access for BACS fee.

ACC_ADM_FASTER_ACCESS

Agency scheme access for FASTER fee.

VIBAN_MONTHLY_FEE

vibanMonthlyFeeSubtype

VIBAN_MONTHLY_FEE

VIBAN monthly fee.

VIBAN_MONTHLY_MINIMUM_FEE

VIBAN minimum fee.

To define a price for a periodic fee, click the icon. Enter the following parameters on the Create new price for periodic fee page:

See the section for more information.

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

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

Optionally, you can select a label value for the accAdmFeeSubtype field. If you define prices for different ACC_ADM_FEE subtypes, then all of them are debited from the account once per period. For more information, see the section.

You can set labels for periodic fees for more detailed pricing. When defining prices, you can only select one label value at a time that defines the periodic fee subtype. Labels for the periodic fee subtypes can be configured using .

TUUM_SAMPLE_PL
specific APIs
Labels for periodic fees
Labels for periodic fees

Create prices for price lists

You can define a price as a price item in the price list or as a special price directly applicable to an account or a customer.

You can set up prices for three types of fees:

Set up a generic price list

You can set up a generic price list which is used as a backup for complex pricing strategies and to cover prices that may not exist in the other price lists. A generic price list is not related to any customer group code.

To create a generic price list, enter the following parameters:

Parameter
Type
Description

Is generic price list?*

Yes/No

Select Yes to create a generic price list.

Price list type code*

Text

Enter a unique code for the price list.

Description

Text

Enter a short description of the purpose of the price list.

Price start date*

Date

Select the date when the price list starts to be valid.

Format: DD.MM.YYYY

Price end date

Date

Select the end date of the validity of the price list. The last date is excluded from the period.

Format: DD.MM.YYYY

Sample of a generic price list

The following screenshot shows the filled parameters of a sample generic price list called TUUM_SAMPLE_GENERIC_PL:

Set up a non-generic price list

You can create a new non-generic price list applicable to a dedicated group of customers.

To create a non-generic price list, enter the following parameters:

Sample of a non-generic price list

The following screenshot shows the filled parameters of a sample price list called TUUM_SAMPLE_PL. The price list is related to the generic price list TUMM_SAMPLE_GENERIC_PL and is applicable to a specific customer group.

- The price for the service's subscription for a certain period. It is regularly recurring per period. For example, account maintenance fee.

- One-time fees that are based on certain actions. For example, balance inquiry fee or card delivery fee.

- Related to a particular transaction type. It is charged when that type of transaction takes place. For example, all kinds of payment fees, like the fee for an outgoing SEPA payment (ACC2SEPA_FEE).

Click Submit to save the price list. The Fee price lists page opens and the new price list is visible on this page. Now, you can for the price list. Click the Price list ID to open the Price list prices page.

Parameter
Type
Description

Click Submit to save the price list. The Fee price lists page opens and the new price list is visible on this page. Now, you can for the price list. Click the Price list ID to open the Price list prices page.

Periodic fees
One-time fees
Transaction fees
define prices

Is generic price list?*

Yes/No

Select No to create a price list that is not generic.

Related generic price list

List

If you want to relate the price list you are creating to a generic price list, select the generic price list from the drop-down menu.

Note: This field is displayed only if you select No for the Is generic price list field.

Price list type code*

Text

Enter a unique code for the price list. The code must be unique within the specific customer group.

Description

Text

Enter a short description the purpose of the price list.

Customer group code*

List

Select a customer segmentation group for which the price list is valid. Available values consist of the price list related to the customer groups you created with Tuum.

The customer groups are connected to accounts and not related to persons.

Note: This field is displayed only if you select No for the Is generic price list field.

Fee configuration group

List

Select a group from the drop-down menu.

A fee configuration group must be selected if you want the fees listed in this group to be created as fee bookings and not as fee transactions

Note: This field is displayed only if you select No for the Is generic price list field.

Price start date*

Date

Select the date when the price list starts to be valid.

Format: DD.MM.YYYY

Price end date

Date

Select the end date of the validity of the price list. The last date is excluded from the period.

Format: DD.MM.YYYY

define prices

Create prices for one-time fees

One-time fees are fees that are charged one time based on certain actions. For example, a balance inquiry fee or card delivery fee.

By default, the following one-time fees are present:

Configuration of prices for one-time fees

Sample of a one-time price

Consider that we want to set up a price of €5 for replacing a card.

  1. Select the Fee currency code as EUR.

  2. 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.

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

  4. Enter 5 as the Fixed fee amount. Click Submit.

Result: The fee of €5 is applied to the customer to replace a card.

The following screenshot shows the fee creation page with the sample values:

Labels for one-time fees

The following table shows the possible labels for certain one-time fee types:

Create prices for transaction fees

You can set up fees ranging from simple transaction-based prices to complex scenarios using tiered pricing and labels.

By default, the following transaction fees are present:

See the following topics for different types of pricing options for transaction fees:

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:

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.

Prices with labels

Using pre-defined and configurable labels, you can have more detailed pricing applicable for different types of fees.

For example, for the price of outgoing SWIFT transactions, you can assign labels for regular or urgent transactions and select counterparty countries.

There are different options according to the fee being created. The following table shows the label fields and the respective options present for the fee types.

The actual use of these transaction labels depends on the payment module you are running with the Tuum core banking module. Currently, the Tuum payment module supports only one label for SWIFT payments - counterpartyCountry.

Sample of a transaction fee price with labels

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

  • The price is charged to currency accounts.

  • The SWIFT fee charge type is SHA (shared). This means that the sender and the beneficiary share the intermediary bank charges for the payment.

  • For the first 1000 transactions, €5 fixed fee is charged for each transaction. After that, €10 fee is charged for each transaction.

  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 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.

  7. In the Labels section, select the accountType as ACC_CURRENCY and swiftPriceType as PRICETYPE_SHARED.

  1. In the Tiers section, enter the values as follows:

  1. Click Submit.

Account price list

Financial institutions need to set up various fees such as fees for transactions on customer accounts, recurring fees for account maintenance, or one-time fees for contract changes or extra services. With the Tuum BackOffice, you can define account price lists and corresponding prices for automatic calculation and application of these fees.

Definitions

  • Price - A set of conditions to calculate the fee amount.

  • Special price - A price specific to an account or a customer. The special price overwrites the price in the account price list.

  • Price list - A set of prices. A price list is assigned to a customer group that determines the accounts that can use this price list.

  • Generic price list - A list of prices which work as a backup reference determining the fee for a particular transaction in case the price is not present in account price lists. Generic price lists cannot be assigned to an account.

  • Fee - The amount of money calculated and charged from an account as account fee transactions (debited immediately) or as account fee bookings (accumulated and debited later) per the respective price.

The following diagram shows how a price is selected for fee calculation:

Create price lists

To add a new price list, access the Fee price lists page:

  • Accounts > Pricing > Fee price list.

  • Click the New price list button.

Once a new price list is created, it is visible on the Fee price lists page.

  • To create new price lists, the MANAGE_PRICE privilege is required. To view the Fee price lists page, the VIEW_PRICE privilege is required.

You can create 2 types of price lists:

Fee type code
Description

To define a price, click the icon for the fee type and enter the following parameters:

Parameter
Type
Description

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

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

You can set labels for one-time fees for more detailed pricing. When defining prices, you can only select one label value at a time that defines the one-time fee subtype. Labels for the one-time fee subtypes can be configured using .

Fee type code
Label name
Label value
Description
Fee type code
Description
Parameter
Type
Description

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.

Transaction fee types can have multiple related labels. When a transaction is posted with labels, then the related fee is calculated according to the most accurate price according to price hierarchy (See ) and the number of matching labels (the more matches, the better).

Fee type code
Labels
Options

We are using the sample price list we created before - . From this price list, we are selecting the ACC2SWIFT_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.

See the page for the complete list of privileges you may need.

ACCOUNT_STATEMENT_FEE

Fee for inquiring the account statement.

AUTH_INSTRUMENT_FEE

Fee for an account authentication instrument.

CARD_BALANCE_INQUIRY

Fee for inquiring the account balance using the card at an ATM machine.

CARD_FAST_DELIVERY

Fee for the fast delivery of the card.

CARD_FX_CONVERSION_ FEE

Fee for foreign exchange conversion for a transaction carried out with a card.

CARD_PIN_CHANGE_FEE

Fee for changing the pin code of a card.

CARD_PLASTIC_ORDERING_FEE

Fee for ordering a plastic card.

CARD_REPLACEMENT_FEE

Fee for replacing a card.

CARD_TRANSACTION_ RECEIPT_FEE

Fee for issuing a receipt for a transaction.

ONBOARDING_FEE

Fee for onboarding a new customer.

PAYMENT_INQUIRY_FEE

Fee for inquiring payment details.

SETUP_FEE

Fee for setting up an account.

SETUP_FEE

setupFeeSubtype

SETUP_AGENCY

Setup fee for agency.

SETUP_VIBAN

Setup fee for VIBAN.

SETUP_AGENCY_SORT_CODE

Agency sort code setup fee.

PAYMENT_INQUIRY_FEE

paymentInquiryFeeSubtype

PAYMENT_INQUIRY_SWIFT_TRACE

SWIFT inquiry - trace fee.

PAYMENT_INQUIRY_SWIFT_AMENDMENT

SWIFT inquiry - amendment fee.

PAYMENT_INQUIRY_SWIFT_CREDIT_CONFIRM

SWIFT inquiry - credit confirm fee.

PAYMENT_INQUIRY_SWIFT_INFO

SWIFT inquiry - information request/other fee.

PAYMENT_INQUIRY_SWIFT_COPY

SWIFT copy fee.

PAYMENT_INQUIRY_SWIFT_TRACKER

SWIFT tracker inquiry fee.

AUTH_INSTRUMENT_FEE

authInstrumentFeeSubtype

AUTH_INSTRUMENT_PIN_CALCULATOR

Pin calculator fee.

ACCOUNT_STATEMENT_FEE

accountStatementFeeSubtype

ACCOUNT_STATEMENT_AUDIT_INQUIRY

Audit inquiry fee.

ACCOUNT_STATEMENT_OTHER

Other statement or proof fee.

ACCOUNT_STATEMENT

Account statement fee.

ACC2INTRA_FEE

Fee for an outgoing payment where both accounts are within Tuum (also known as intrabank payment).

ACC2LOCAL_FEE

Fee for an outgoing payment through a local payment scheme.

ACC2SEPA_FEE

Fee for an outgoing payment through the SEPA payment scheme.

ACC2SEPA_RET_FEE

Fee for a returned outgoing payment through the SEPA scheme.

ACC2SWIFT_FEE

Fee for an outgoing payment through a SWIFT payment network.

INTRA2ACC_FEE

Fee for an incoming payment where both accounts are within Tuum (also known as intrabank payment).

LOCAL2ACC_FEE

Fee for an incoming payment through a local payment scheme.

SEPA2ACC_FEE

Fee for an incoming payment through the SEPA payment scheme.

SEPA2ACC_RET_FEE

Fee for a returned incoming payment through the SEPA scheme.

SWIFT2ACC_FEE

Fee for an incoming payment through a SWIFT payment network.

CARD_TOP_UP_FEE

Fee for payment to increase the card limit.

CARD_WITHDRAWAL

Fee for withdrawal of cash from an ATM machine.

FX_FEE

Fee for a foreign exchange transaction.

VIBAN_IN_FEE

Fee for incoming payment from a virtual IBAN account.

VIBAN_OUT_FEE

Fee for outgoing payment from a virtual IBAN account.

ACC2INTRA_FEE,

INTRA2ACC_FEE

accountType

  • ACC_CURRENCY - Currency account

  • ACC_INDIRECT - Indirect account

  • ACC_VIRTUAL - Virtual account

ACC2LOCAL_FEE,

LOCAL2ACC_FEE

accountType localSchema

  • ACC_CURRENCY

  • ACC_INDIRECT

  • ACC_VIRTUAL

  • LOCAL_BACS - UK local payment scheme

  • LOCAL_FASTER - UK local payment scheme

ACC2SEPA_FEE,

SEPA2ACC_FEE

accountType sepaSchema

  • ACC_CURRENCY

  • ACC_INDIRECT

  • ACC_VIRTUAL

  • SEPA_INSTANT

  • SEPA_REGULAR

ACC2SWIFT_FEE,

SWIFT2ACC_FEE

accountType swiftPriceType swiftSchema swiftUrgency counterpartyCountry

  • ACC_CURRENCY

  • ACC_INDIRECT

  • ACC_VIRTUAL

  • PRICETYPE_BEN - Beneficiary type SWIFT payment fee

  • PRICETYPE_OUR - OUR type SWIFT payment fee

  • PRICETYPE_SHARED - Shared type SWIFT payment fee

  • SWIFT_CHAPS - UK SWIFT payment schema

  • SWIFT_CROSSBORDER - SWIFT payment schema Crossborder

  • SWIFT_INTRAGROUP - SWIFT payment schema for intragroup payments

  • URGENCY_REGULAR - SWIFT urgency level is regular

  • URGENCY_SAMEDAY - SWIFT urgency level is the same day

  • URGENCY_URGENT - SWIFT urgency level is urgent

  • COUNTERPARTY_AD - Payment counterparty account country is AD (Andorra)

  • COUNTERPARTY_AE - Payment counterparty account country is AE (United Arab Emirates)

  • and so on for other countries.

Prices without tiers
Prices with tiers
Prices with labels
Set up a generic price list
Set up a non-generic price list
TUUM_SAMPLE_PL
specific APIs
TUUM_SAMPLE_PL
TUUM_SAMPLE_PL
Special prices
TUUM_SAMPLE_PL
Account privileges

Fee calculation rule*

List

This field defines how the fee is calculated.

You can only select the Fixed fee rule. This means that the amount charged is fixed to a certain amount.

You must specify this amount in the Prices section on the same page.

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

Labels

List

Fixed amount*

Number

Enter an amount for the one time fee.

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

Create special prices

You can define special prices related to a specific account or a customer.

You can only set special prices for active currency accounts.

Follow these steps to define a special price:

  1. First, you need to select the account you want to update. Click Accounts > Search > Accounts from the top menu. You can fill in the search criteria and select the account.

  2. When you select the account, the account details page opens. Click Fees > Prices from the content menu. The Account fee prices page opens.

From here, you also have the option to change the account price list by clicking Change pricelist. You can select the new price list for the account from the drop-down menu. The drop-down menu lists only the price lists that are allowed for the account according to the customer group code.

  1. Select the fee type for which you want to define the special price.

  2. On the price creation page, select the Special price level as Account or Customer. If you select Account, the price is applied for the specific account only. If you select Customer, the price is applied to all the accounts the customer has.

  3. Next, you can continue to fill in the parameters as per your requirements and click Submit.

The following screenshot shows the special price creation page:

Prices without tiers

The configuration parameters are as follows:

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.

Sample of a price without tiers

Consider that we want to set up a price for transaction fees for outgoing local payments.

  1. Select the Fee calculation rule as Fixed fee with percentage. This means the price is calculated using the fixed amount plus a percentage of the transaction.

  2. Select the Transaction currency code as EUR. This means that the price is set for transactions that are carried out in EUR.

  3. Select the Fee currency code as USD. This means that the fee is charged in USD.

  4. 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.

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

  6. Enter Fixed amount = 5, Percentage = 0.5, Min fee amount = 5.5, Max fee amount = 9. (Note that the maximum fee cannot be less than 5 as the value of the fixed fee is 5.)

  7. Click Submit.

Result: The fee amount is calculated like this: The Min fee amount value is considered as the floor amount for the full fee amount.

  • If the value of Fixed amount + Percentage >= Min fee amount, then the total fee of fixed + percentage is charged.

  • If the value of Fixed amount + Percentage < Min fee amount, then the value of the minimum fee amount is charged as the fee.

The following screenshot shows the fee creation page with the sample values:

You can select a label for detailed pricing if the one-time fee type has labels defining the fee subtypes attached with it. See the section for more information.

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

Parameter
Type
Description

We are using the sample price list we created before - . From this price list, we are selecting the ACC2LOCAL_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.

Labels for one-time fees
TUUM_SAMPLE_PL

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 amount.

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

Transaction currency code*

List

The currency in which the transactions are carried out. Select a transaction currency code from the drop-down list.

Note: You can select the All currencies option if the price is the same for all similar transactions made in different currencies.

You can also combine the options as follows:

  • Define the price of 10 EUR with All as the Transaction currency code.

  • Define another separate price of 8 EUR for the USD transaction currency code.

  • Define a separate price of 9 EUR for the GBP transaction currency code.

Result:

  • If a transaction is made in EUR or NOK or any other supported currency, then the fee of 10 EUR is charged.

  • If a similar transaction is made in USD, then the fee of 8 EUR is charged.

  • If a similar transaction is made in GBP, then the fee of 9 EUR is charged.

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

Labels

List

You can select one or more label values for the transaction fee for detailed pricing if a particular transaction fee type has label names attached with it.

Prices

Enter the price, percentages, and maximum and minimum fee amounts as applicable.

See for more information.

Prices with labels