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 one-time fees
  • Sample of a one-time price
  • Labels for one-time fees

Was this helpful?

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

Create prices for one-time fees

PreviousCreate prices for periodic feesNextCreate prices for transaction fees

Last updated 9 months ago

Was this helpful?

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:

Fee type code
Description

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.

Configuration of prices for one-time fees

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

Parameter
Type
Description

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.

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:

Fee type code
Label name
Label value
Description

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.

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.

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 .

TUUM_SAMPLE_PL
specific APIs
Labels for one-time fees