Prices with labels

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

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 Special prices) and the number of matching labels (the more matches, the better).

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.

Fee type code	Labels	Options
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.

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.

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

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

2. Select the Fee calculation rule as Fixed fee.

3. Select the Tier type as Amount single.

4. Select the Tier application mode as Highest.

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

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

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

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