LogoLogo
  • welcome
    • About BackOffice user guide
    • About Tuum BackOffice
      • BackOffice global features
      • BackOffice content features
  • Users and roles guide
    • Users and roles
      • Definitions
    • BackOffice administrator
    • User management
      • User management page
      • Create users
      • User credentials
      • Search users
      • Assign and remove roles
      • Change user password
      • Delete user
    • Role management
      • Role management page
      • Privileges
      • Create role
      • Modify role
      • Remove role
  • Person guide
    • About person
      • Definitions
    • Create lookup codes
    • Configure person
      • Person details
      • Additional info - private
      • Identification numbers
      • Work
      • Company details
      • Additional info - legal
      • Registration numbers
      • Additional contacts
      • Tax numbers
      • Legal entity identifier
      • Addresses
      • Documents
      • Files
      • Relationships - private
      • Relationships - legal
      • Risks
      • Financial data
      • Custom fields
    • Risk types and levels
    • Person groups
    • Search and manage person
    • Person privileges
  • Accounts guide
    • About accounts
    • Account types
      • Currency account
        • Create currency account without application
          • Currency account parameters
        • Create currency account with application
          • Account application parameters
        • Find and confirm account application
        • Post confirmation processing
          • Standard
            • Account application statuses - Standard
          • External virtual
            • Account application statuses - External
      • Internal account
        • Create internal account
          • Internal account parameters
    • Search accounts
    • Account view page
    • Account parameter rule
      • Account parameter rule parameters
      • Create account with parameter rule
    • Account price list
      • Create price lists
        • Set up a generic price list
        • Set up a non-generic price list
      • Create prices for price lists
        • Create prices for periodic fees
        • Create prices for one-time fees
        • Create prices for transaction fees
          • Prices without tiers
          • Prices with tiers
          • Prices with labels
        • Create special prices
    • Account limits
      • Limits parameters
      • Limits view page
    • Account class codes
      • Account class code rule parameters
    • Account access rights
      • Access rights parameters
    • Account review rules
    • Account interest
      • Interest main settings
      • Interest conditions
      • Account interest page
    • Allowed operations
    • Account transactions
      • Transaction view page
        • Transaction details
        • All transactions in group
        • Financial entries
      • Transaction reversals
      • Account transaction types
        • Adjustment
        • Balancing
        • Card
        • Deposit
        • Direct debit
        • External
        • Fee
        • FX
        • Generic
        • Interest
        • Loan
        • Offset
        • Payment
        • Repayment
        • Saving
    • Custom bookings
      • Custom booking parameters
      • Custom booking CSV file
      • Custom booking view page
      • Custom booking review process
    • Reservations
    • Account privileges
  • account how to guides
    • About account how to guides
    • Account floating interest
      • Applying floating interest
        • As a percentage of the base rate
        • As a difference from the base rate
        • Margin type differences explained
      • Base rate update
    • Changing account type interest method and conditions
      • Change account type interest conditions for all accounts
      • Change account type interest conditions for new accounts
      • Change account type interest method
        • Create the base rate
        • Configure the interest method change
        • Follow up on the outcome of the change
    • Internal account balance reset
      • Reset balance for all internal accounts
      • Reset balance for a particular internal account
      • Find information about default suspense account
      • Turn off balance reset
  • Deposit guide
    • About deposits
      • Definitions
    • Setting up deposit products
      • General information parameters
      • Interest main settings
      • Interest conditions
    • Search and manage deposit products
    • Deposit operations
      • Search applications
      • Search offers
      • Search contracts
        • Contract events
      • Cancel deposit contract
      • Terminate deposit contract
      • Change payout bank details
      • Define custom fields
      • Define deposit adjustment limits
    • Accessing deposit processes from the dashboard
    • Deposit user privileges
  • payment guide
    • About payments
      • Definitions
    • View account page
    • View payments dashboard
    • Initiate outgoing payments
      • Initialise payments
      • Confirm payments
      • Configure payment templates
      • Configure 4-eye review process
      • Manage payment in review
      • Troubleshooting payment initiation
    • Payment operations
      • Manage payments with AML
      • Manage incoming payments
      • Manage outgoing payments
    • Search payments
    • View payment details
    • Payment statuses
    • Payment privileges
  • Direct debit
    • Payments with direct debit
      • Mandates
        • Add mandate parameters
      • Collections
        • Create collection parameters
      • Direct debit user privileges
  • loan guide
    • About loan
      • Definitions
      • Loan flow
    • Loan fee component types
      • Manage billing and reminder fees
    • Loan product
      • Loan groups
      • General parameters
      • Loan class code
        • Loan component rule parameters
      • Principal
      • Period limitation
      • Interest conditions
      • Interest on unused limit
      • Disbursement
      • Repayment scheduling
      • Fees
      • Origination process
      • Invoice rules
      • Receivable formation rules
      • Receivable line rules
      • Loan to value rules
      • Pricing
      • Penalty
      • Custom fields
      • Loan product use cases
    • Loan application
      • Loan application page
        • Main details
        • Additional details
        • Income details
      • Loan application scoring
        • Application scoring page
    • Loan offer
      • Loan offer parameters
    • Loan contract
      • Loan contract view page
      • Contract version
        • Contract version parameters
        • Contract version change use cases
      • Loan contract event
        • Loan contract event
      • Loan contract fees
        • New fee booking
        • Fee booking reversal
      • Loan payoff preview
      • Loan contract schedule
      • Loan manual repayment
      • Loan payouts
        • Loan payout parameters
      • Loan contract invoices
        • One-time invoice parameters
        • Credit note parameters
        • Reverse repayment parameters
      • Loan communications
      • Loan funds
      • Loan write-off
        • Write-off parameters
      • Loan contract documents
    • Loan contract - v2
      • Loan contract management
        • Create loan contract parameters
      • Loan contract page
      • Loan contract content sections
      • Contract version
        • Contract version content sections
        • Contract version parameters
        • Contract version change use cases
      • Loan contract event
        • Loan contract event parameters
      • Loan contract fees
        • New fee booking parameters
      • Loan payoff preview
      • Loan contract schedule
      • Loan manual repayment
      • Loan payouts
        • Loan payout parameters
      • Loan contract invoices
        • One-time invoice parameters
        • Credit note parameters
        • Reverse repayment parameters
      • Loan communications
      • Loan funds
      • Loan write-off
        • Write-off parameters
      • Loan contract documents
    • Loan contracts portfolio report
      • Loan contracts portfolio report parameters
    • Loan repayments with direct debit
      • Mandates
      • Collections
    • Assets and collaterals
      • Asset
        • Asset parameters
      • Collateral agreement
        • Create with asset
        • Create with suretyship
        • Find collateral agreement
        • Edit collateral agreement
        • Sign collateral agreement
        • Discard collateral agreement
        • Close collateral agreement
      • Custom fields and lookups
    • Loan privileges
  • loan how to guides
    • About loan how to guides
    • Umbrella loan
      • Umbrella loan example
      • Configure umbrella loan product
      • Create loan contracts
    • Credit line products
      • Configure credit line product
    • Balloon loan
      • Balloon loan example
      • Configure loan product
    • Loan capitalisation and deduction
      • Loan product setup
      • Manual disbursement
      • Manual fee booking scenario
      • Manual capitalisation
    • Top up loan
      • Define top-up conditions
      • Create new contract version
      • Fill in top-up parameters
    • Change loan end date
      • Define new end period
      • Create new contract version
      • Fill in new end date
    • Set up loan payment holiday
      • Define payment holiday terms
      • Create new contract version
      • Fill in payment holiday terms
  • Base interest rate guide
    • About interest rate management
      • Definitions
      • Process flow
    • Base interest rates
      • Add base rate fixing
      • Approve rate fixing
      • Upload rates
      • Find rate fixings
    • Interest rate cap
      • Add rate cap fixing
      • Approve rate cap fixing
      • Find interest rate cap fixing
    • Configure loan product
    • Find applied base rate
  • loan penalty guide
    • About loan penalty calculations
      • Definitions
    • Penalty calculation principles
    • Set up loan penalty calculation
      • Find loan product configuration
      • Set up penalty grace days and amount
      • Configure penalty for loan components
      • Define penalty rates
    • Floating penalty with interest
      • Manage penalty
    • Find calculated penalties
      • Find penalties from invoices
      • Find penalties from contracts
  • loan campaign guide
    • About loan campaigns
    • Create loan campaign
      • Set up loan campaign
      • Apply campaign to product
    • Manage loan campaign
      • Create application/offer with campaign code
      • Find applied campaigns
      • Update and copy campaigns
      • Disconnect loan product from campaign
  • cards guide
    • About cards
      • Definitions
    • Add BIN
    • Card price lists
      • Manage card price list
        • Price list parameters
      • Price list prices
        • New price list price parameters
      • Tiered prices
        • Assign counting and summing groups to transaction fee type in price list
          • Counting and summing group assignment parameters
        • Assigning counting and summing groups for transaction types
        • Aspects to consider
      • Fee types
      • Transaction types
      • Fee caps
        • Fee cap parameters
    • Create card products
      • Product description
      • Card account settings
      • Card main settings
      • PAN settings
      • Product price lists
      • Product designs
      • MCC settings
      • Authorisation types
      • Card level default limits
      • Additional settings
      • Completing card product creation
    • Card product statuses
      • Change card product status
    • Create credit products
      • General conditions
      • Product price lists
      • Interest conditions
      • Penalty conditions
      • Transaction setup
      • Repayment conditions
      • Disbursement conditions
      • Debt conditions
      • Invoice conditions
      • Receivable formation rules
      • Receivable line rules
      • Complete credit product creation
    • Create instalment plans
      • Create an instalment plan type
        • Instalment plan type parameters
      • Create an instalment plan
      • Manage instalment plan
      • Change interest rate for instalment plan
      • Manage premature repayment for instalment plans
    • Card operations
      • Search cards
      • Card details
        • Process steps
        • Card renewal
        • Card custom booking
        • Replace the price list for cards
        • Ordering plastic card
        • Manage card limits
          • Replace card limit group
            • Card limit group parameters
          • Update card limit amounts
            • Card limit amount parameters
          • Replace card usage group
            • Card usage group parameters
        • Change card settings
          • Card settings parameters
      • Search card applications
        • Create a card application
      • Search credit card offers
        • Create a credit card offer
      • Search credit contracts
        • Replace the price list for credit contracts
      • Search card renewals
      • Search card transactions
      • Cards funds search
      • Batch card operations
      • Card clearing reports
        • Export Mastercard clearing report as CSV
          • 1644-685 Financial position detail (clearing totals) parameters
          • 1644-680 File currency summary (source currency totals) parameters
          • 1740-783 Fee collection (clearing system-generated) parameters
        • View Mastercard clearing message details
      • Correct interest manually
      • Card contract write-off
        • Create card contract write-off
          • Write-off parameters
        • Search card contract write-offs
        • Reverse card contract write-offs
    • Cards user privileges
  • Card how to guides
    • About card how to guides
    • Card pricing models
      • Pricing with labels and no tiers
      • Pricing with labels and count-based tiers
      • Pricing with labels and amount-based tiers
      • Amount range-based pricing with count threshold
  • Finance guides
    • About finance
      • Definitions
    • Finance reports guide
      • Report on GL balances and turnovers
        • GL balances and turnovers report request parameters
      • Report on GL monthly entries
        • GL monthly entries report request parameters
      • Report on GL contra entries
        • Contra entry report request parameters
      • Journal reports
      • Search and fetch financial entries
        • GL entries search parameters
  • Administration
    • About administration
    • Currency rates
      • Currency reference rates
        • Create a file with currency reference rates
        • Upload a file with currency reference rates
        • Confirm uploaded reference rates
        • View the latest currency reference rates
    • Lookups
      • Manage lookups
      • Account group lookup codes
        • Method assignment codes
        • Customer groups
      • Loan group lookup codes
        • Solvency level
        • Loan contract change reason
      • Lookups user privileges
    • Custom fields
      • Create field sets
      • Create fields
      • Manage custom field values
      • Custom fields user privileges
    • Holidays
    • System properties
      • Auth system properties
Powered by GitBook

© Tuum 2025

On this page
  • Configuration of prices for periodic fees
  • Sample of a periodic price
  • Labels for periodic fees

Was this helpful?

Export as PDF
  1. Accounts guide
  2. Account price list
  3. Create prices for price lists

Create prices for periodic fees

PreviousCreate prices for price listsNextCreate prices for one-time fees

Last updated 9 months ago

Was this helpful?

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

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

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.

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