All pages
Powered by GitBook
1 of 1

Loading...

Create prices for one-time fees

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

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.

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

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