All pages
Powered by GitBook
1 of 1

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