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.

PreviousPrices with tiersNextCreate special prices

Last updated

Was this helpful?