Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 528 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

BackOffice User Guides

welcome

Loading...

Loading...

Loading...

Loading...

Users and roles guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Person guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Accounts guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

About Tuum BackOffice

About Tuum BackOffice

The purpose of the Tuum BackOffice is to equip your organisation's employees with efficient and controlled means to access the features of the Tuum system. Its graphical user interface has undergone a remarkable improvement.

On January 9th, 2024, Tuum introduced a fresh graphical user interface design for the BackOffice by introducing a new frame while maintaining the old content.

We have gradually implemented design changes for some content pages in subsequent releases. We will continue to do so until all pages of the BackOffice have a new design. Therefore, the global BackOffice features apply to all pages and content features only to those whose content has transitioned to the new design.

Use one of the shortcuts below to learn about the Tuum BackOffice's global or content features.

BackOffice global features
BackOffice content page features

About BackOffice user guide

Welcome to the user guide. We created this guide as your go-to resource for answering questions about working with Tuum's core banking solution through the BackOffice user interface.

On this page, you will find information on how to make the most of this user guide.

Choose the display mode

To choose your preferred display mode, scroll down to the bottom of the page and move the toggle switch to your preferred display mode setting.

Find the topic

Use the ask or search bar on the screen's top right corner to find information quickly.

  • Enter a question and click Ask to find the answer with the help of AI.

  • Or use keywords with traditional search to find topic-related pages and click on the respective link to continue reading in the user guide.

General features

Look at the and pages to learn about the Tuum BackOffice's general features and how to use them.

Domain features

To access the domain's related knowledge, use the shortcuts below to navigate to the relevant user guide.

Definitions

Privilege - The most granular element defining a single action the employee can perform. For example, a user with the ADD_PERSON privilege can add new person records.

Role - A set of privileges defining activities the user can perform with the respective role.

BackOffice User - A human operator who accesses the Tuum system through the BackOffice interface.

API user - A programmatic operator who accesses the Tuum system through API endpoints.

global
content feature

Users and roles

Person guide

Account guide

Account how-to guides

Deposit guide

Payment guide

Loan guide

Loan how-to guides

Loan penalty guide

Loan campaign guide

Card guide

Card how-to guides

Finance guide

Base interest rate guide

Administration guide

User management

Below, you can learn more about how to perform the activities to manage the users in the Tuum system.

Search users

You can find a list of all users by going to:

  1. Administration > User management.

  2. From the content menu, choose Users.

If you need to find a particular user, click the filter sign and enter the Technical ID, Username, First name, Last name or Role.

You can use the filtering controls in the table header to refine how the table content is displayed. Find more information about filtering table content .

Assign and remove roles

To assign or to remove user roles:

  1. Go to Administration > User management.

  2. From the content menu, select Users.

  3. In the list of the users, click on the Technical ID of the user that needs to be modified.

  4. On the User details page:

    • To assign a role, click on the toggle sign next to the role name.

    • To remove a role, click on the toggle sign next to the role name.

  5. To save the changes, click the Change roles button.

Role management

Roles and privileges define the user permissions to access and complete different actions within the Tuum system.

Below you will find the following information:

Delete user

To delete user:

  1. Go to Administration > User management.

  2. From the content menu, choose Users.

  3. In the list of the users, click on the Technical ID of the user that needs to be deleted.

  4. On the User details page, click the Delete button.

Role management page

The Roles page is where you can create and manage roles. To access it, navigate to:

  1. Administration > User management.

  2. From the content menu, choose Roles.

You can use the filtering controls in the table header to refine how the table content is displayed. Find more information about filtering table content .

Privileges

There are two types of privileges:

  • View privileges. This group of privileges grants reviewer rights only. For example, VIEW_CONTRACT_EVENTS, VIEW_DEPOSIT_OFFER.

  • Action privileges. This group of privileges grants permissions to add, delete, modify objects. For example, MANAGE_USERS, BLOCK_ACCOUNT, ADD_LOAN_OFFER.

In the BackOffice all privileges are grouped per business domain. For example, ACCOUNT, DEBT, DEPOSIT, etc.

You can check the list of the available privileges in BackOffice by going to:

  • Administration > User management > Roles > Add.

  • All privileges are grouped by product or functionality. To view the list of privileges, click the sign.

The Tuum system automatically updates the list of privileges whenever new features are added. By default, all new privileges are assigned to the Admin role. If you want to assign these new privileges to any other role, you must do so manually.

Create role

To create a new role:

  1. Go to Administration > User management.

  2. From the content menu choose Roles > click the Add button.

  1. Write down the Role name.

  2. Scroll the list of the grouped privileges. Click the sign to open available set of privileges.

  1. Assign the Privileges by clicking on the sign next to the privilege name.

If you want to assign all privileges, click on the sign next to Toggle all.

  1. Click the Submit button to create a new role.

Role naming rules:

  • Use capital letters only;

  • Use underscores instead of the word spaces.

For example, if you need to create a role for a bank official, use BANK_OFFICIAL.

  • A role can contain an unlimited amount of privileges.

  • The VIEW_PERSON is a mandatory role for all users as current accounts, loan contracts, deposit contracts and collaterals are always accessed through the customer profile.

Remove role

To remove role:

  1. Go to Administration > User management > Roles.

  2. Click on the sign next to the name of the role that needs to be removed.

You can delete the role only if it is not assigned to any user.

Additional info - legal

This list of parameters applies only to the creation of a legal person.

Field name
Description

See the Additional info section below as it appears when creating a legal person:

Legal entity identifier - legal

This list of parameters applies only to the creation of a legal person.

Field name
Description

See the Legal entity identifier section below as it appears when creating a legal person:

Search persons

After creating a person, you can search for them on the Search persons page using the quick or advanced search options.

To search for a specific private or legal person, follow these steps:

  1. Go to Persons > Search.

  2. On the Search persons page, fill in the relevant parameters.

  1. You can enable Advanced search to access additional filters, allowing for a more granular search and narrowing down the results.

  2. When you click Search, a list of persons is displayed, showing identification numbers, names, e-mail addresses, and other relevant details.

  1. Click the person's name to view their details.

Manage person details

This page allows you to view and update key information related to a person.

From this page, you can:

Add or view comments

To add or view a person's comments, follow these steps:

  1. whose comments you want to view or add.

  2. Click the person's name to view their details.

  3. From the right-side panel, check the Comments box to see the Comments section.

  4. Click Add to add a new comment.

  1. Enter your comment and click Save to apply it.

  1. This is how the added comments will appear, with the most recent one shown first:

View actions log and processes

To view a person's action history and processes, follow these steps:

  1. whose action logs and processes you want to view.

  2. Click the person's name to view their details.

  3. From the right-side panel, check the Actions log and Processes boxes to see these sections.

  1. The Actions log section displays details including who created the action, when it occurred, status changes, and the action performed (activated or inactivated).

  2. The Processes section shows information about who initiated each process, when it started, the process ID, type, status, and reason.

Post confirmation processing

After the account application is confirmed, the subsequent processing will depend on your selection for the account setup type. To find out more, find the relevant explanation for STANDARD or EXTERNAL_VIRTUAL selection options.

User management page
Create users
User credentials
Search users
Assign and remove roles
Change user password
Delete user
Role management page
Privileges
Create role
Modify role
Remove role
here

Date of incorporation/registration

Select the company's date of registration.

Format: DD.MM.YYYY

Web address

Enter the company's web address.

Counterparty sector code

Select the counterparty sector code. This parameter defines the financial sector to which the company belongs. The code is assigned by the relevant regulatory authority, such as the European Banking Authority (EBA) in the European Union. Available options are:

  • Central banks;

  • Credit institutions;

  • General governments;

  • Households;

  • Non-financial corporations;

  • Other financial corporations.

Business area

Select the company's business area.

Business model description

Enter a description of the company's business model.

Lei code

Enter the LEI code.

A Legal Entity Identifier (LEI) is a unique 20-character alphanumeric code used globally to identify legal entities participating in financial transactions.

Local operating unit

Enter the local operating unit.

Local operating units are organisations authorised to issue LEIs.

Registration date

Enter the company's date of registration.

Format: DD.MM.YYYY

Change status of a person
Edit person's data
Add or view comments
View actions log and processes
Add or view external contracts
Search for the person
Standard
External virtual
Search for the person
here

Users and roles

About user management

The Tuum BackOffice user management allows your organisation to manage role-based access controls of users who interact with the Tuum system. By defining specific roles equipped with only the necessary permissions, you can ensure that your organisation's employees and applications access only the resources required for their tasks.

The flexible role customisation capabilities of the Tuum BackOffice allow your organisation to adapt to ever-changing business needs while ensuring that workflows remain efficient and secure.

On the other pages you will find detailed information about:

BackOffice administrator

Tuum Customer Implementation Manager creates for your company the first BackOffice user with the ADMIN role. With this user, you can start defining roles with the relevant permission sets, create additional BackOffice and API users, and assign them appropriate roles.

To create roles and additional users, the employee with the ADMIN role user should log into the Tuum BackOffice and go to Administration > User management.

If necessary, you can create multiple BackOffice users with ADMIN roles.

User management page

The User management page allows you to create and manage BackOffice and API user records.

To access it, navigate to:

  1. Administration > User management.

  2. From the content menu, select Users.

You can use the filtering controls in the table header to refine how the table content is displayed. Find more information about filtering table content here.

Modify role

Modifying role means assigning or removing privileges. To do that, go to:

  1. Administration > User management.

  2. From the content menu choose Roles.

  3. Click on the Role name that should be modified.

  4. On the Role management page, find the necessary privileges group.

  5. Click on the sign to select privileges.

  6. Do the following in a particular privileges section to change the privilege with the role.

    1. To assign a privilege, click on the toggle sign next to the privilege name.

    2. To remove a privilege, click on the toggle sign next to the privilege name.

  7. At the bottom of the Role management page, click the Save button.

About person

In the Tuum system, creating a record for each person is essential for managing client or customer information effectively. This foundational step is necessary to begin leveraging other capabilities of the Tuum system, such as accounts, payments, cards, and loan features.

Person types

There are two types of persons in the system:

  • Private person - a physical individual. Private persons typically represent themselves, but they may also represent others if authorised through consents or mandates.

  • Legal person - an organisation, such as a business or non-profit entity. Legal persons are always represented by private persons.

The Person module in Tuum BackOffice allows you to create and configure person records, define essential parameters, and manage related data such as risk types, levels, and person groups. It also enables you to search for existing persons and control access through person privileges.

Here you will learn about:

Person details - legal

This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Person type *

Select the person type.

Available options are:

  • Private (default);

  • Legal.

Customer type

Select the customer type.

Available options are:

  • Customer (default);

  • Beneficiary.

The available values can be defined on the PERSON.PERSON lookup page by selecting CUSTOMER_TYPE as the Lookup type. For more information, see .

Name *

Enter the name of the legal person. This is a free-text field.

Trading name

Enter the registered trade name of the entity. This is a free-text field.

Legal form

Enter the legal form of the entity. For example, sole trader, partnership, limited company, etc.

Intra org code

Enter the unique internal organisation reference.

Residency country

Select the country of residence.

Person groups

Select a person group from the drop-down list.

To add a new person group, see .

E-mail

Enter a valid e-mail address (e.g. [email protected]).

Phone country code

Select the country code.

Phone number

Enter the phone number.

See the Person details section below as it appears when creating a legal person:

Identification numbers - private

This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Identification numbers *

Enter the identification number. Additional identification numbers can be added by clicking Add .

Identification number country *

Select the country of identification.

Primary

Primary is automatically assigned to the first identification number created. It cannot be changed or removed. Only non-primary identification numbers can be deleted.

While multiple identification numbers can be added, only the first one is marked as primary.

See the Identification numbers section below as it appears when creating a private person:

Registration numbers - legal

This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Registration numbers *

Enter the registration number of the legal person. Additional registration numbers can be added by clicking Add .

Registration country *

Select the registration country from the list.

Primary

Primary is automatically assigned to the first registration number created. It cannot be changed or removed. Only non-primary registration numbers can be deleted.

While multiple registration numbers can be added, only the first one is marked as primary.

See the Registration numbers section below as it appears when creating a legal person:

Tax numbers

This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Tax number type *

Select one of the following:

  • Tax number;

  • VAT number.

Additional tax numbers can be added by clicking Add .

Tax number *

Enter the tax or VAT number.

Tax country code *

Select the tax country.

Primary

Primary is automatically assigned to the first tax number created. It cannot be changed or removed. Only non-primary tax numbers can be deleted.

While multiple tax numbers can be added, only the first one is marked as primary.

See the Tax numbers section below:

Work - private

This list of parameters applies only to the creation of a private person.

Field name
Description

Business area

Select the area(s) of business for the workplace. Multiple options can be selected. These values can be defined on the PERSON.PERSON lookup page by selecting PERSON_BUSINESS_AREA as the Lookup type. For more information, see .

Example values include:

  • Agriculture, forestry and fishing;

  • Construction;

  • Human health and social work activities;

  • Education.

Activity

Select the activity performed by the person at work. These values can be defined on the PERSON.PERSON lookup page by selecting PERSON_ACTIVITY as the Lookup type. For more information, see . Example values include:

  • Entrepreneur;

  • Executive;

  • Student;

  • Unemployed.

Employment time

Select the employment duration. Available options are:

  • More than 4 years;

  • Trial;

  • Up to 1 year;

  • Up to 2 years;

  • Up to 3 years;

  • Up to 4 years.

Fixed employment length

Enter the duration of the fixed-term employment in months. This applies when the person works as a contractor.

See the Work section below as it appears when creating a private person:

Home - private

This list of parameters applies only to the creation of a private person.

Field name
Description

Property type

Select the property type of the person's home. Available options are:

  • Living with parents;

  • Other;

  • Part ownership;

  • Private;

  • Rented.

Building type

Select the building type of the person's home. Available options are:

  • Apartment;

  • Other;

  • Private house.

See the Home section below as it appears when creating a private person:

Additional contacts - legal

This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Contact type code

Enter the company's contact type code.

E-mail *

Enter the company's e-mail address.

Phone country code *

Select the country code.

Phone number *

Enter the phone number.

Preferred method of contact

Select Yes if this is the preferred way to contact the company; otherwise, select No.

Description

Enter a description of the contact. Additional contacts can be added by clicking Add .

See the Additional contacts section below as it appears when creating a legal person:

Files

This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

Field name
Description

File type *

Select the file type.

These values can be defined on the PERSON.DOCUMENT lookup page. For more information, see .

Available options for a private person are:

  • Birth certificate;

  • CV;

  • Dealer/broker contract;

  • Document copy;

  • Proof of address;

  • Selfie;

  • Terms and conditions;

  • Verification video.

Available options for a legal person are:

  • Annual report;

  • Articles of association;

  • Business representation;

  • Document copy;

  • Flow of funds;

  • Group structure chart;

  • Organisational structure chart;

  • Ownership structure;

  • Proof of address;

  • Registry extract.

Additional files can be added by clicking Add .

File *

Click the upload icon to upload the file.

See the Files section below:

Relationships - private

This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Relationship type *

Select the relationship type:

  • Beneficiary;

  • Parent.

Additional relationships can be added by clicking Add .

Private or legal person *

Select or start typing the name, identification number, registration number, or e-mail of a private or legal person.

Status *

By default, the status is set to Active.

Representing start date *

Select the start date of the representation.

Format: DD.MM.YYYY

See the Relationships section below as it appears when creating a private person:

A private person in the system may represent someone else, be represented, or have no representation relationship. These roles are displayed in the person's profile:

  • Representing person – An individual authorised to act on behalf of another person.

  • Represented person – The individual who is being represented by someone else.

  • Represents as – Indicates that the current person is being represented by another individual.

  • Related as – Indicates that the current person is acting as a representative for someone else.

Risks

This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Risk type *

Select the applicable type of risk.

To add more risk types, see . Additional risks can be added by clicking Add .

Risk level *

Select the level of risk. To add more risk levels, see .

Date *

Select the date of the risk evaluation.

Format: DD.MM.YYYY

Value *

Enter the numerical value associated with the risk.

Source name *

Enter the name of the source that provided the risk data. For example: Hawk.ai.

Source reference *

Enter the reference ID from the source system used for risk evaluation. For example: ID-928292.

Source link

Provide a link to the process results or detailed risk assessment, if available.

See the Risks section below:

Custom fields

For information on generic terms and functions of custom fields in the Tuum system, please refer to the Custom fields chapter.

Custom fields allow Tuum customers to add additional data to private or legal person records. For example, custom fields can include information such as bank details, bank identifiers, location, and address.

To add the custom fields, follow these steps:

  1. Go to Administration > Settings > Custom fields.

  2. From the content menu, select Person > Person.

  3. Click Add field set.

  1. The Create field set modal opens. Enter the Field set ID and Field set name.

  2. Click Create to create new field set.

  1. Find your field set on the Custom fields page to customise it.

  2. Click Add field.

  1. The Create field modal opens. Enter the required parameters and click Create.

  1. The created fields will appear on the Custom fields page.

  1. When you return to Persons > Create, you will see the custom field you created.

Person details page

The purpose of the person details page is to provide a comprehensive management and viewing interface for a specific person's (customer's) profile and associated financial products. It allows you to efficiently review, navigate, and administer a person's complete record within the Tuum system.

Person's summary

The summary card, located prominently at the top centre of the content area, offers a quick overview of the person's essential details and status. It displays key details such as:

  • status and type of the person;

  • ID number, creation date, language, tenant code, and customer type;

  • contact information (phone, e-mail);

  • residency country, business area, counterparty sector code, and intra org code.

If a person is classified as a Politically Exposed Person (PEP), it will be indicated on the summary card as a dedicated notice.

You can modify the parameters shown on the summary card in the respective section of the content area below.

Content menu

The left-side content menu features navigation categories for Tuum product items, providing quick access to person-related financial products. The categories include accounts, loans, deposits, cards, and other financial products. You can select a category and its sub-items, if applicable, to swiftly locate specific financial products related to that person.

The available list of navigation items in it depends on the configuration of the Tuum business modules (e.g. accounts, loans, deposits, cards) for your organisation.

Content sidebar

The content sidebar, located on the right side of the content area, consists of two elements: action buttons at the top and content navigators below them.

Action buttons

The action buttons allow the user to perform essential activities with the person. The specific list of action buttons depends on the person's status. In this example, the user can inactivate the person's record or restrict access to it.

For more information about the action buttons in the content sidebar, please refer to the Action buttons chapter in the BackOffice content page features.

Section navigators

The section navigators on the sidebar display a complete list of content sections on a person's details page.

For more information about the content section navigators in the content sidebar, please refer to the Section navigators chapter in the BackOffice content page features.

Content sections

The purpose of the content section is to group similar data sets into distinct visual categories. To view the data in a particular section, ensure that its visibility is enabled. You can then access it by clicking on the corresponding section navigator in the content sidebar or by simply scrolling the page to that section.

Person details section

The person overview page includes a Details section, which is structured based on the type of person:

  • Private person: displays individual-specific sections such as Personal, Contact, and Work & home.

  • Legal person: displays entity-specific sections such as Personal, Contact, and Business.

Other sections

For more information on viewing data items located in other sections of the person's details page, please refer to the Page content section features chapter.

Add or view external contracts

To add or view a person's external contracts, follow these steps:

  1. Search for the person whose external contracts you want to view or add.

  2. Click the person's name to view their details.

  3. From the content menu, click External contracts.

The content menu shows person-related modules (e.g. accounts, loans, deposits, cards) based on your subscription. Viewing or deleting external contracts requires the VIEW_EXTERNAL_CONTRACTS privilege.

  1. Click Add external contract to create a new contract.

  2. The External contracts modal opens.

  3. Complete the required fields and click Create to add the contract.

  1. This is how the created external contract will appear:

  1. Checking the Show history box will display the validity range.

Create lookup codes

For information on generic terms and functions of lookups in the Tuum system, please refer to the Lookups chapter.

Before creating a person profile, you can set up lookup codes for parameters such as education, employment type, marital status, and others.

To manage these lookup codes, follow these steps:

  1. Go to Administration > Settings > Lookups.

  2. In the content menu, you’ll see a list of modules based on your subscription. Under the PERSON module, lookup options are available for address, document, financial data, personal information, and relationships.

  1. Select the lookup type from the drop-down menu.

  2. Click the add icon to create new lookup codes. The example below shows the PERSON > FINANCIAL DATA page.

  1. The Create new lookup modal opens.

  2. Enter the lookup code and add the translations.

  3. Click Create to save the new lookup.

Lookup codes must be added on the PERSON module lookup page, as this is a mandatory field when creating a person record. Other parameters are optional.

Person groups

Person groups are customer segmentation categories such as Platinum or Economy, typically used for marketing and customer profiling.

This section is visible only if you have the VIEW_PERSON_GROUP privilege.

Create person group

  1. Go to Persons > Settings > Person groups.

  2. On the Person groups page, click Add .

  1. The Create person group page opens, where you can define the Person group code, Person type, and Description.

For more information on assigning a group code, see the instructions for adding a new private or legal person.

About accounts

The accounts guide explains how to create and manage accounts using the Tuum BackOffice interface. Before getting started, please note the meaning of the following terms.

  • Account - an entity that records customers' (private and legal persons) or banks' transactions and balances in different currencies.

  • Account type - a set of attributes that determines the behaviour of an account. Each account type has a dedicated set of additional features.

  • Account service provider - an institution that provides account numbers.

You can find the definitions of other terms in the section explaining the use of the dedicated account feature.

Here you will learn about:

Currency account

For currency accounts, Tuum can be configured in three ways:

  1. Standard (Account type setup code: STANDARD enabled): The Tuum system generates account numbers.

  1. External (Account type setup code: EXTERNAL_VIRTUAL enabled): Account numbers are generated by an external account service provider such as LHV Bank (LHV), Banking Circle (BC), or CurrencyCloud (CC).

  1. Hybrid (Account type setup code: STANDARD and EXTERNAL_VIRTUAL enabled): Both the Standard and External options are used simultaneously. The decision about which option to use is made at the account opening.

Depending on the configuration, two different account opening processes exist for currency accounts.

  1. Opening a currency account without an account application applies to standard configuration.

  2. Opening a currency account with an account application applies primarily to external and hybrid configurations but can also be used for the standard configuration if preferred.

Please ensure you are familiar with the setup your company uses to access the appropriate explanations.

Create currency account without application

This explanation applies to the standard account configuration.

Follow the steps below to open a currency account without using an account application.

  1. Go to Persons > Search for the person who needs to get an account created.

  2. Fill in search parameters > click the Search button.

  3. Click on the person’s Identification number to view the Person details.

  4. Once on the Person details page, go to the content menu Accounts > Accounts.

  5. On the Accounts page > click the Create account button.

  1. Fill in the account parameters > click the Create button.

You can set account parameter rules to restrict the options for new account parameter values. To learn more, look at the account opening example with the account parameter rule enabled.

Standard

The explanation below applies when you have selected STANDARD as the Account setup type when creating the account application.

Application processing

The account application will go through a manual approval process after the account application confirmation.

  • Click Accept if the application meets all the account opening criteria.

  • Click Reject if it does not meet the required criteria for account opening.

  • Click Mark for review if additional due diligence about the applicant is required to decide whether to accept or reject the application.

After clicking the Accept, Reject, or Mark for review button, the confirmation modal will open. In this modal, you can:

  • select the status change reason and

  • fill in a comment.

Click Yes to confirm the application status change.

Pending applications

Clicking the Mark for review button sets the account application to PENDING status. In this intermediary status, the decision to accept or reject the application must be made.

Once you have finished the additional due diligence, click the Accept or Reject button to change the application's status.

Accepted applications

Clicking the Accept button sets the account application to the ACCEPTED status and starts fully automated account opening processing.

If successful, the account application gets the status PROCESSED, and the primary account number of the opened account will be visible on the account application details page.

Keep monitoring the account application by checking its status until it reaches the PROCESSED status.

Rejected applications

Clicking the Reject button sets the account application to the REJECTED status, which is the final status and ends the application's processing.

For more information, refer to the explanations about account application statuses.

Search accounts

There are two ways to find an account.

  1. If you want to perform a global search for any account:

    • Go to Accounts > Search > Accounts.

    • Fill in the search criteria and click Search.

    • Click on the Account number of the account you are interested in to see full details.

  1. If you need to search for any account for a dedicated person:

    • Go to Persons > Search.

    • Fill in search parameters > click the Search button.

    • Click the Identification number to access the person view page.

    • From the person content menu, choose Account > Accounts.

    • Click on the Account number of the account you are interested in to see full details.

BackOffice global features

The BackOffice global features allow the BackOffice user to navigate through the BackOffice and adjust their working preferences. Below are highlights of the tools available for users to manage their experience within the BackOffice.

Main menu

The main menu has been thoughtfully relocated to the left while maintaining its familiar elements and order, inspiring a seamless and smooth user experience.

Side panel

Enhance your productivity with the feature-rich side panel. Easily access your favourite pages, copied content, and page history.

Prompt and efficient assistance

Looking for assistance is now simple and fast. You can effortlessly search or request content from the BackOffice user guide using the side panel ask or search field. You can follow the steps outlined in the summary or explore the BackOffice user guide to learn more about the topic of your interest.

Favourites

Discover the power of the favourites feature and take control of your browsing experience. Save your most visited pages for an increase in efficiency and convenience.

Favourites extra icon

Add more favourites with a single click using the star icon next to the breadcrumbs. And remember, you can also do so in the side panel.

Clipboard

Your copying history is saved in the clipboard. Enjoy the easy access to texts, links, and excerpts. It is your personal memory vault that ensures nothing valuable slips away.

Display modes

Create a personal workspace that suits you with customisable visual modes and zoom settings. Your preferences are saved for future logins so you can seamlessly continue your work without distractions.

Content menu toggle

The content menu toggle gives you the power to keep your content menu open or closed just the way you like it.

Content width toggle

Minimise or maximise the main content space with the content width toggle for a more comfortable browsing experience with just one click.

Profile icon

Clicking on the profile icon reveals a link to your profile settings and a logout button.

Loading spinner

Keep an eye on the loading spinner – a subtle signal that your data is loading in the background. Plus, give it a click anytime to swiftly return to the dashboard.

Bank day icon

The current banking day is always visible here. Look out for a vibrant red icon, signalling an ongoing banking day change process.

Create users

About users

The Tuum system has two types of users:

  1. BackOffice User is a user for human operators who access the Tuum system through the BackOffice interface. These users are identities for employees of your company who perform their daily tasks and should not have a system role included in their role set.

  2. API User is a user for applications communicating with Tuum through API endpoints. These users are identities for other IT systems of your company integrated with Tuum and should have a system role included in their role set.

The Tuum system has a unique user with the username modular.system. The Tuum system retained this user for maintenance purposes. Tuum customers should not modify or use this user.

User creation flow

To enable a new user to perform tasks within the Tuum system, follow these three steps:

  1. .

  2. to restrict user's permissions to perform authorised tasks.

  3. to enable secure access to the Tuum system.

Below you can find more details about each step.

Create users and add roles

To create new user:

  1. Go to Administration > User management.

  2. From the content menu, choose Users > click the Add button

Only users with the MANAGE_USERS privilege can add new employees to the BackOffice.

  1. Enter the user details. The username and email entered must be unique within the Tuum system.

  2. Select required roles. To assign a role, click on the toggle sign next to the role name.

    1. If you are creating a BackOffice user, please do not assign the System role to the user.

    2. If you are creating an API user, assign the System role to the user.

  3. Click Submit to complete the creation of a new user.

If you need to create a new role, please refer to the section to learn more.

User credentials

Options for credentials

For BackOffice users, there are two options for managing user credentials:

  1. Single Sign-On (SSO) - If your company uses SSO through Google or Microsoft Azure, user credentials will be managed via these service providers. For more details, refer to the relevant provider instructions.

  2. Tuum managed credentials - Alternatively, you can manage user credentials directly in Tuum by associating passwords with usernames. To learn more, follow the instructions below for .

Create BackOffice user password

After the BackOffice admin has created a new BackOffice user, the Tuum system will send an email. This email will confirm the account creation and include instructions for setting up a password.

The email contains the link to the Tuum system page, where a user can create a password.

  • The BackOffice user must create the password that follows the company password policy. You can find more information about the password policy configuration .

  • If the link for password creation has expired, the user should follow the instructions in the section to create a password.

Create API user password

The should create a password for the API user by following the instructions in the chapter .

Change user password

There are two ways to change a user's password:

  • The can reset user password,

  • The user can reset their password themselves.

Change password - BackOffice admin

To change user password as BackOffice admin, navigate to:

  1. Administration > User management.

  2. From the content menu, select Users.

  3. In the list of the users, click the Technical ID of the employee whose password you need to reset.

  4. On the User details page, type in the New password and Confirm password.

  5. Click the Change password button to save the changes.

Change password - user

The BackOffice user can reset their password in two ways:

  1. using the forgotten password feature when not logged in or

  2. accessing their user profile page when logged in.

Change password via forgotten password feature

If the BackOffice user has forgotten their password, they can initiate a password reset via the login page.

  1. On the login page, click the Trouble signing in link.

  1. On the password reset page, enter your email address.

  2. Click the Reset Password button.

An email with password reset instructions will be sent to the employee's registered email address. They should follow the instructions in the email to complete the password reset process.

Change password via user profile page

If the BackOffice user has logged in, they can change their password on the user profile page.

  1. Click the user profile icon in the top right corner on any BackOffice page.

  1. Click on the Settings icon, which is opened in the same place, to navigate to the user profile page.

  1. When the user profile page opens, scroll down to the password section.

  1. Enter and confirm the new password.

  2. Click the Change password button to complete the password change.

Documents - private

This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

See the Documents section below as it appears when creating a private person:

Relationships - legal

This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

See the Relationships section below as it appears when creating a legal person:

A legal person may represent another party, be represented, or have no representation relationship. These roles are shown in the legal person’s profile:

  • Representing person – The individual or entity authorised to act on behalf of the legal person.

  • Represented person – The individual or entity that the legal person is authorised to represent.

  • Represents as – Indicates that the legal person is being represented by another party.

  • Related as – Indicates that the legal person is acting as a representative for another party.

External contracts parameters

Field name
Description

Risk types and levels

To record person-related risks for either a legal or private person, the Tuum system provides two key parameters:

  • ;

  • .

These parameters are interrelated: the risk type defines the nature or category of the risk (e.g. credit risk), while the risk level indicates its potential impact (e.g. low, medium, or high).

You can define how these parameters are used, including the criteria for assigning them, based on your internal risk policy framework.

Below are theoretical examples to help illustrate how risk type and risk level can be applied.

The examples below are for illustrative purposes only and are not predefined in the Tuum system. You must define the appropriate risk types and risk levels based on your organisation’s risk policies, as described below.

Create risk type

  1. Go to Persons > Settings > Risk types.

  2. On the Risk types page, click Add .

  1. The Create risk type page opens, where you can define the Risk type code, Person type, and Description.

For example, you can create different risk types such as Credit risk, Operational risk, or Reputation risk, depending on your risk classification needs.

You can add a risk type either when creating a person or editing an existing one.

Create risk level

  1. Go to Persons > Settings > Risk levels.

  2. On the Risk levels page, click Add .

  1. The Create risk level page opens, where you can define the Risk level code and Description.

For example, you can create risk levels such as High, Medium, and Low to indicate the impact or severity of the risk. A High risk level means that the person is considered to carry the greatest level of risk.

You can add a risk level either when creating a person or editing an existing one.

Assign risk

When assigning a risk to a person, you must select both the Risk type and the Risk level. For example, the outcome could be Risk type: Operational risk with an Impact level: Medium.

See how to when creating a person.

Account types

The following table presents the available account types in the Tuum system and their corresponding features.

Account type
Description
  • Only Currency and Internal account types can be created via the BackOffice interface.

  • To create other types of accounts, use the endpoint.

Find and confirm account application

Find account application

There are two ways to find an account application.

  1. If you want to perform a global search for any account application:

    • Go to Accounts > Search > Applications.

    • Fill in the search criteria and click Search.

    • Click on the Application identifier of the account application you are interested in to see full details.

  1. If you need to search for any account application for a dedicated person:

    • Go to Persons > Search.

    • Fill in search parameters > click the Search button.

    • Click the Identification number to access the person view page.

    • From the person content menu, choose Account > Account applications.

    • Click on the Application identifier of the account application you are interested in to see full details.

Confirm account application

After submitting an account application, the account application details page will open.

  • Click Confirm > Yes to confirm the account application.

Account application statuses - External

These account application statuses apply if the Tuum configuration for accounts is .

APPLICATION STATUS CODE
DESCRIPTION

Internal account parameters

Parameter name
Type
Description

Create internal account

To create a new internal account, go to:

  1. Persons > Search for the person who needs to get an account created.

  2. Fill in search parameters > click the Search button.

  3. Click on the person’s Identification number to view the Person details.

  4. Once on the Person details page, go to the content menu Accounts > Accounts.

  5. On the Accounts page > click the Create account button.

  1. On the New account page select the Internal account type and fill in the .

Edit person's data

To edit a person's data, start with these steps:

  1. whose status you want to change.

  2. Click the person's name to view their details.

  3. The person details page opens.

To edit a person's data, please follow the specific instructions for each section.

  • If you wish to edit the Details section, follow the instructions .

  • For any other section, please refer to the instructions .

Edit data in Details section

To edit a person's existing data in Details sections, follow these steps:

  1. From the right-side panel, check the Details box to see the Details section.

  2. Click Edit to change the existing details.

  1. Edit the necessary parameters, then click Save to apply the changes.

Edit data in any other section

To update a person's data in any section except Details, follow these steps:

  1. Check the section navigator on the content sidebar to make the section data visible for editing.

  2. Click the section navigator to navigate to the section where the data you want to change is located.

  3. Follow the instructions provided in the .

Account price list

Financial institutions need to set up various fees such as fees for transactions on customer accounts, recurring fees for account maintenance, or one-time fees for contract changes or extra services. With the Tuum BackOffice, you can define account price lists and corresponding prices for automatic calculation and application of these fees.

Definitions

  • Price - A set of conditions to calculate the fee amount.

  • Special price - A price specific to an account or a customer. The special price overwrites the price in the account price list.

  • Price list - A set of prices. A price list is assigned to a customer group that determines the accounts that can use this price list.

  • Generic price list - A list of prices which work as a backup reference determining the fee for a particular transaction in case the price is not present in account price lists. Generic price lists cannot be assigned to an account.

  • Fee - The amount of money calculated and charged from an account as account fee transactions (debited immediately) or as account fee bookings (accumulated and debited later) per the respective price.

The following diagram shows how a price is selected for fee calculation:

Create price lists

To add a new price list, access the Fee price lists page:

  • Accounts > Pricing > Fee price list.

  • Click the New price list button.

Once a new price list is created, it is visible on the Fee price lists page.

  • To create new price lists, the MANAGE_PRICE privilege is required. To view the Fee price lists page, the VIEW_PRICE privilege is required.

  • See the page for the complete list of privileges you may need.

You can create 2 types of price lists:

Account application statuses - Standard

These account application statuses apply if the Tuum configuration for accounts is .

APPLICATION STATUS CODE
DESCRIPTION

Create prices for price lists

You can define a price as a price item in the price list or as a special price directly applicable to an account or a customer.

You can set up prices for three types of fees:

  • - The price for the service's subscription for a certain period. It is regularly recurring per period. For example, account maintenance fee.

  • - One-time fees that are based on certain actions. For example, balance inquiry fee or card delivery fee.

  • - Related to a particular transaction type. It is charged when that type of transaction takes place. For example, all kinds of payment fees, like the fee for an outgoing SEPA payment (ACC2SEPA_FEE).

External virtual

The explanation below applies when you have selected the EXTERNAL_VIRTUAL as the Account setup type when creating the account application.

Application processing

After confirming the account application, the Tuum system automatically sends it to the Account service provider for AML review.

  • The account service provider will review the application and respond with acceptance or rejection.

  • In case the AML review takes longer, the Account service provider sends a response with a pending status.

Pending applications

When the Tuum system receives a response with the pending status, it means the AML review process with the Account service provider is still ongoing.

Next, the Tuum system sets the account application to PENDING status. The application stays in this intermediary status until the Account service provider sends the message about accepting or rejecting it.

Accepted applications

When the Tuum system receives the response with acceptance, it means the application has met all the account opening criteria of the Account service provider. The response then also contains the assigned account number.

Next, the Tuum system sets the account application to the ACCEPTED status and starts fully automated account opening processing with the account number assigned by the Account service provider.

If successful, the account application gets the status PROCESSED, and the primary account number of the opened account will be visible on the account application details page.

Keep monitoring the account application by checking its status until it reaches the PROCESSED status.

Rejected applications

When the Tuum system receives a rejecting response, it means the application has not met the required criteria for opening an account with the Account service provider.

Next, the Tuum system sets the account application to the REJECTED status, which is the final status and ends the application's processing.

For more information, refer to the explanations about .

Internal account

Introduction to internal accounts

Internal accounts are the bank's technical accounts in the account module, used to reflect incoming or outgoing funds movements. The funds held in internal accounts are not categorised as customer deposits.

In the account module, internal accounts can operate in two modes:

  1. .

  2. .

Adjustable balance mode

Regular automated adjustment

By default, the internal accounts balances are set to zero daily, a few minutes before the begins.

In financial accounting, the reset transaction moves the funds from the deposit and overdraft portfolio GL accounts to the default or dedicated GL suspense account.

Irregular manual adjustment

In addition to regular automated adjustments, you can manually reset the balances of all internal accounts or just one particular account during the day.

Learn more by referring to the description of the .

Immutable account balance mode

You can also avoid automatic or manual balance reset by turning off the internal account balance reset option.

In financial accounting, the funds are reflected on deposit and overdraft portfolio GL accounts.

Find more information on for a particular internal account.

Contract number *

A unique identifier assigned to the external contract.

Contract type code *

A predefined code that specifies the type of contract (e.g. due diligence, dealer agreement, service contract). This value is selected from a dropdown list and must be configured in the system beforehand.

Status code

Indicates whether the contract is currently Active or Inactive. Select the appropriate status from the dropdown.

Start date

The date the contract becomes effective. Select the date from the calendar.

End date

The date the contract expires or is no longer valid. Select the date from the calendar.

Description

A brief summary or additional details about the contract.

Download

Provides access to download the uploaded contract document or related files.

Source name *

The name of the organisation, system, or individual that provided the contract.

Source reference *

A reference ID or code used by the source system to identify the contract.

Source link *

A direct URL or link to the original source of the contract.

Account name

Text / Number

Enter the name you would like to assign to the account.

Account type*

List

Select the INTERNAL account type.

Jurisdiction country*

List

Select the jurisdiction country.

Account class

List

Select the account class.

Default currency*

List

Select the account default currency.

Overdraft amount

Number

Enter the maximum amount of negative balance an account can have.

Account holder name*

Text / Number

Enter the account holder's full name.

Residency country*

List

Select the residency country of the account holder.

BackOffice administrator
User management
Role management
Create person
Search persons
Person details page
Manage person details
Create lookup codes
Risk types and levels
Person groups
Person privileges
Account types
Search accounts
Account view page
Account parameter rule
Account price list
Account limits
Account class codes
Account access rights
Account review rules
Account interest
Allowed operations
Account transactions
Custom bookings
Account transaction types
Transaction reversals
Reservations
Account privileges

Currency

A customer account that allows holding balances in multiple currencies on one account. It can have fees, interest conditions, and contractual overdraft conditions. Note: see more about currency accounts.

Internal

Bank's technical account used to reflect incoming or outgoing funds movements. The funds held in internal accounts are not categorised as customer deposits. Note: see more about internal accounts.

Virtual

A customer account with a number, which can be used for payments but does not store its balance. The reference to the master account id is mandatory for such account types.

Shadow

A hidden customer account related to the credit contract disbursements and repayments if currency accounts are not in use.

Saving

A customer account to put some money aside from the usual current account and earn additional interest.

create account API
Periodic fees
One-time fees
Transaction fees
creating a BackOffice user password
here
Change password - user
BackOffice admin
Change password - BackOffice admin
BackOffice admin

INSERTED

The INSERTED status indicates a draft account application has been created.

  • You can edit or cancel the application at this stage.

  • The application needs to be confirmed to proceed with application processing towards account opening.

PREPARED

After confirmation, the application becomes uneditable and enters the PREPARED status. The Tuum system automatically sends the account application to the account service provider for account opening due diligence and account number assignment.

CANCELLED

The CANCELLED status indicates that either:

  • the draft account application was cancelled or

  • the confirmed application was cancelled before the subsequent processing steps were finished.

PENDING

The PENDING status indicates that the Tuum system received a response from the Account service provider notifying Tuum that its AML review process is ongoing.

ACCEPTED

The ACCEPTED status indicates that the Tuum system has received a message from the account service provider stating that the AML review process has been successfully completed. The message includes the assigned primary account number. The Tuum system will proceed to the account opening.

REJECTED

The REJECTED status indicates that the Tuum system has received a message from the account service provider stating that the AML review process has failed. It is the final status and terminates the account application's processing.

PROCESSED

The PROCESSED status indicates that the Tuum system has completed the account opening process. The application also includes the assigned account number by the account service provider.

ERROR

The ERROR status indicates that the account application processing has encountered a technical error during the account opening process. You can manually retry the failed part of the process for failover.

External or Hybrid
account parameters
Account privileges
Set up a generic price list
Set up a non-generic price list

INSERTED

The INSERTED status indicates a draft account application has been created.

  • You can edit or cancel the application at this stage.

  • The application needs to be confirmed to proceed with application processing towards account opening.

PREPARED

After confirmation, the application becomes uneditable and enters the PREPARED status. The account application is ready for a manual approval process to change its status to PENDING, ACCEPTED, or REJECTED.

CANCELLED

The CANCELLED status indicates the draft account application was cancelled.

PENDING

The PENDING status indicates that the application processing is on hold until additional due diligence is complete. It is intermediary status before the account application gets ACCEPTED or REJECTED status.

ACCEPTED

The ACCEPTED status indicates the account opening due diligence has successfully completed and the process will proceed with the account opening.

REJECTED

The REJECTED status indicates the account opening due diligence has failed. It is the final status and terminates the account application's processing.

PROCESSED

The PROCESSED status indicates that the Tuum system has completed the account opening process. The application also includes the assigned account number by Tuum.

ERROR

The ERROR status indicates that the account application processing has encountered a technical error during the account opening process. You can manually retry the failed part of the process for failover.

Standard or Hybrid
account application statuses
Adjustable account balance mode
Immutable account balance mode
reset internal account balance
disabling the automatic balance reset
Risk type
Risk level
add a risk
Search for the person
here
here
Edit data item chapter
Create lookup codes
Person groups
Create lookup codes
Create lookup codes
Create lookup codes
Risk types and levels
Risk types and levels

Person privileges

To add
  • ADD_PERSON

  • ADD_PERSON_FILE

  • ADD_PERSON_GROUP

  • ADD_PERSON_GROUP_TYPE

  • ADD_PERSON_LOG

  • ADD_FINANCIAL_DATA

  • ADD_LEGAL_ENTITY_IDENTITY

  • ADD_REPRESENTATIVE

To change
  • CHANGE_PERSON_ADDITIONAL_CONTACT

  • CHANGE_PERSON_ADDITIONAL_INFO

  • CHANGE_PERSON_ADDRESS

  • CHANGE_PERSON_DOCUMENT

  • CHANGE_PERSON_PERSONAL_INFO

  • CHANGE_PERSON_STATUS_CODE_REASON

  • CHANGE_LEGAL_ENTITY_IDENTITY

To create
  • CREATE_PERSON_ADDITIONAL_CONTACT

  • CREATE_PERSON_ADDRESS

  • CREATE_PERSON_COMMENT

  • CREATE_PERSON_CUSTOM_FIELD

  • CREATE_PERSON_CUSTOM_FIELD_VALUE

  • CREATE_PERSON_DOCUMENT

  • CREATE_PERSON_LOOKUP

To delete
  • DELETE_PERSON_ADDITIONAL_CONTACT

  • DELETE_PERSON_ADDRESS

  • DELETE_PERSON_DOCUMENT

  • DELETE_PERSON_GROUP

  • DELETE_PERSON_GROUP_TYPE

  • DELETE_EXTERNAL_CONTRACTS

  • DELETE_FINANCIAL_DATA

  • DELETE_LEGAL_ENTITY_IDENTITY

To edit and search
  • EDIT_PERSON

  • SEARCH_PERSON_FILES

  • EDIT_REPRESENTATIVE

  • FORGET_CUSTOMER

  • INACTIVATE_CUSTOMER

  • CLOSE_REPRESENTATIVE

To view
  • VIEW_PERSON

  • VIEW_PERSON_BLOCK

  • VIEW_PERSON_COMMENT

  • VIEW_PERSON_CUSTOM_FIELD

  • VIEW_PERSON_CUSTOM_FIELD_VALUE

  • VIEW_PERSON_GROUP

  • VIEW_PERSON_GROUP_TYPE

  • VIEW_PERSON_LOGS

  • VIEW_PERSON_LOOKUP

  • VIEW_EXTERNAL_CONTRACTS

  • VIEW_FINANCIAL_DATA

  • VIEW_LEGAL_ENTITY_IDENTITY

Risk privileges
  • DELETE_RISK_LEVEL

  • DELETE_RISK_TYPE

  • VIEW_RISK_LEVEL

  • VIEW_RISK_TYPE

  • MANAGE_RISK_LEVEL

  • MANAGE_RISK_TYPE

Access rights parameters

Parameter name
Type
Description

SSN*

List

Select the Social Security Number (SSN). Choose the available option from the drop-down.

Account right code*

List

Select the type of the account rights:

  • All rights - the customer can view and edit account details; initiate currency transfers, payments, etc.

  • View rights - the customer can view account details but not edit them; the customer cannot initiate any transactions on accounts.

  • Change rights - the customer can view and edit account details and initiate transactions and payments but not confirm them.

Document type *

Select the type of document. These values can be defined on the PERSON.DOCUMENT lookup page. For more information, see Create lookup codes.

Example values include:

  • Driver’s licence;

  • ID card;

  • Passport;

  • Residence permit.

Additional documents can be added by clicking Add .

Number *

Enter the document number.

Issuing country *

Select the issuing country of the document.

Expiry date

Enter the document's expiry date.

Format: DD.MM.YYYY

File *

Click the upload icon to upload the file.

Relationship type *

Select the relationship type:

  • Accountant;

  • Director;

  • Executive officer;

  • Member of board;

  • Representative;

  • Shareholder;

  • Supervisory board member.

Additional relationships can be added by clicking Add .

Private or legal person *

Select or start typing the name, identification or registration number, or e-mail of a private or legal person.

Role

Enter the role of the representative.

Percentage of signature

Enter the representative's signature percentage.

Status *

By default, the status is set to Active.

Representing start date *

Select the start date of the representation.

Format: DD.MM.YYYY

Beneficiary

Select Yes if the representing person is a beneficial owner of the company; otherwise, select No.

Create a BackOffice or API user
Assign roles
Set up credentials
Role management

Create person

To create a new private or legal person in Tuum BackOffice, follow these steps:

  1. Go to Persons > Create.

  2. On the Create new person page, a list of configurable parameters is displayed.

  1. The Create person page opens with parameter selection for a Private person. To create a legal person, select Legal as the person type. The available parameters will automatically adjust based on your selection.

Create private person parameters
  • Person details;

  • Identification numbers;

  • Addresses;

  • Additional info;

  • Tax numbers;

  • Work;

  • Home;

  • Documents;

  • Files;

  • Relationships;

  • Risks;

  • Financial data;

  • Custom fields.

Create legal person parameters
  • Person details;

  • Registration numbers;

  • Addresses;

  • Additional info;

  • Tax numbers;

  • Legal entity identifier;

  • Additional contacts;

  • Files;

  • Relationships;

  • Risks;

  • Financial data;

  • Custom fields.

  1. Fill in the required parameters and add optional ones if needed. Once completed, click Submit to finalise the person creation process.

Depending on the settings of the Tuum system for your organisation, the successful creation of the person sets its state to Pending or Active. For more information, refer to the Change the status of a person.

Person details - private

This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Person type *

Select the person type. Available options are:

  • Private (default);

  • Legal.

Customer type

Select the customer type. Available options are:

  • Customer (default);

  • Beneficiary.

The available values can be defined on the PERSON.PERSON lookup page by selecting CUSTOMER_TYPE as the Lookup type. For more information, see .

Given name

Enter the first name of the person. This is a free-text field.

Middle name

Enter the middle name of the person. This is a free-text field.

Surname *

Enter the last name of the person. This is a free-text field.

Residency country

Select the country of residence.

Tax residence

Select the country of tax residence.

Person groups

Select a person group from the drop-down list. To add a new person group, see .

E-mail

Enter a valid e-mail address (e.g. [email protected]).

Phone country code

Select the country code.

Phone number

Enter the phone number.

Gender

Select the gender. Available options are:

  • Male;

  • Female;

  • Other.

Number of dependent persons

Enter the number of dependent persons.

See the Person details section below as it appears when creating a private person:

Financial data

This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

Field name
Description

Financial data type *

Select the financial data type. Available options for a private person are:

  • Assets;

  • Expenses;

  • Income;

  • Investments.

Available options for a legal person are:

  • Assets;

  • Equity;

  • Expenses;

  • Income;

  • Investments;

  • Profit;

  • Raised capital;

  • Revenue.

Additional financial data can be added by clicking Add .

Financial data value type *

Select the financial data value type:

  • Currency;

  • Number;

  • Currency range;

  • Number range.

Period *

Enter the duration of the period in months.

Period from *

Select the start date of the period range. Format: DD.MM.YYYY

Period to

Select the end date of the period range. Format: DD.MM.YYYY

Currency *

Select the currency code. Note: This field is visible only when the financial data value type is set to Currency or Currency range.

Value from

Enter the estimated lower value for the period. Note: This field is visible only when the financial data value type is set to Currency or Currency range.

Value to

Enter the estimated higher value for the period. Note: This field is visible only when the financial data value type is set to Currency or Currency range.

Current period value

Enter the financial value for the current period. Note: This field is visible only when the financial data value type is set to Currency or Number.

Next period estimate value

Enter the estimated financial value for the next period. Note: This field is visible only when the financial data value type is set to Currency or Number.

Description

Enter a description of the financial data.

See the Financial data section below:

Change status of a person

Person statuses help manage and understand a person's data record throughout its existence in the Tuum system, supporting operational workflows, data governance, and compliance.

This diagram illustrates the possible status transitions for a person in the Tuum system.

To change a person's status, follow the steps outlined below.

Common steps

To activate, inactivate or close a person, follow these steps:

  1. Search for the person whose status you want to change.

  2. Click the person's name to view their details.

  3. The person details page opens.

For the next steps use the action button on the content sidebar, located on the right side of the content area.

Activate person

You must activate the person once it is in pending status after creation or reactivation.

Click Activate on the content sidebar, located on the right side of the content area.

The success notification stating Customer successfully activated is shown, and the person's status changes to green with the label Active.

Change status reason

To update the status reason, click Change status reason to open a modal where you must select a status code reason from a dropdown menu, and provide a comment. Click Submit to confirm the changes, or Cancel to close the modal without saving any changes.

Inactivate person

You must inactivate a person when you intend to close that person's record in the Tuum system.

  1. Click Inactivate on the content sidebar, located on the right side of the content area.

  1. The Close customer modal opens.

  1. Select the reason for inactivation and the inactivation date.

  2. Add a comment if needed.

  3. Click Submit to apply the changes.

The person's record now shows a note with the inactivation date.

Reactivate person

You must reactivate a person when you intend to restore an inactivated person's record in the Tuum system.

  1. Click Reactivate on the content sidebar, located on the right side of the content area.

  1. The Reactivate person modal opens.

  1. Select the reason for reactivation and the reactivation date.

  2. Add a comment if needed.

  3. Click Submit to apply the changes.

The success notification stating Person successfully reactivated is shown, and the person's status changes to ! with the label Pending.

Forget person

You must forget a person when you intend to permanently delete an inactivated person's record in the Tuum system.

  1. Click Forget on the content sidebar, located on the right side of the content area.

  1. The Forget person modal opens.

  1. Select the forget Reason and the Forget date.

  2. Add a comment if needed.

  3. Click Submit to apply the changes.

A success notification appears, confirming that the person's data has been permanently deleted. The person's details page, with no data, is displayed.

Currency account parameters

Parameter name
Type
Description

Account name

Text

Enter the name you would like to assign to the account.

Account type*

List

Select the CURRENCY account type.

Account Class

List

Select the account class.

Default currency*

List

Select the default currency of the account. Available values consist of the currencies configured for your Tuum setup.

Customer group*

List

Select a customer segmentation group. Available values consist of customer groups you have created with Tuum.

Price list type*

List

Select an account price list type within the chosen customer group. Available values consist of price list types you have created with Tuum.

Overdraft amount

Number

Non-editable field; It is available for internal accounts only.

Account holder name*

Text

Enter the actual name of the account holder.

Residency country code*

List

Select the residency country of the account holder.

Tax residency country*

List

Select the account residency country.

Interest method assignment code

List

Select the interest method assignment code. This parameter is generated when you create the account type interest. For more details, please refer to the .

Create account with parameter rule

If you have the account parameter rule configured, the account creation form will be adjusted according to the rule setup.

Let us consider an example of a parameter rule set for Finnish clients:

If you create a new currency account for a Finnish customer, you will see the following parameters:

In this example the the selection of jurisdiction country and account type parameters define the available values for the following parameters:

  • default currency,

  • customer group,

  • residency countries,

  • tax residency countries,

  • interest method assignment code.

The availability of the predefined items depend on the account parameter rule configuration.

Create special prices

You can define special prices related to a specific account or a customer.

You can only set special prices for active currency accounts.

Follow these steps to define a special price:

  1. First, you need to select the account you want to update. Click Accounts > Search > Accounts from the top menu. You can fill in the search criteria and select the account.

  2. When you select the account, the account details page opens. Click Fees > Prices from the content menu. The Account fee prices page opens.

From here, you also have the option to change the account price list by clicking Change pricelist. You can select the new price list for the account from the drop-down menu. The drop-down menu lists only the price lists that are allowed for the account according to the customer group code.

  1. Select the fee type for which you want to define the special price.

  2. On the price creation page, select the Special price level as Account or Customer. If you select Account, the price is applied for the specific account only. If you select Customer, the price is applied to all the accounts the customer has.

  3. Next, you can continue to fill in the parameters as per your requirements and click Submit.

The following screenshot shows the special price creation page:

Account access rights

Set account access rights

  1. Open the account view page.

  2. From the content menu, go to Settings > Access rights.

  3. Click the Add access button.

  4. Fill in the account access details.

  5. Click the Add access button.

View account access rights

Once the access rights are granted, you can view the existing account access settings:

  1. Open the account view page.

  2. From the left-side menu, choose Access.

Modify account access rights

  • Click the pencil sign and choose the required Account right code.

Terminate account access rights

  • Click the cross sign > click the Terminate access button.

Account class codes

The purpose of the account class code is to differentiate various account balances in the General Ledger. For example, when respective account class codes are created and associated with unique finance accounts, the safeguarded account balances are kept separately from regular account balances in the General Ledger.

Create account class codes

  1. Accounts > Settings > Class codes.

  2. From the content menu, choose Account class code values.

  3. Click the Add new class code button.

  4. Enter the account class code values > Save.

Create account class code rules

  1. Accounts > Settings > Class codes.

  2. From the content menu, choose Account class code rules.

  3. Click the Create rule button.

  4. Enter the rule conditions > Save.

Modify account class codes and rules

You can modify account class codes and rules by pressing the pencil sign.

You can modify only the following parameters:

  • account class code values - you can update the description.

  • account class code rules - you can update the validity range to parameter.

Delete account class codes and rules

You can only delete the account class codes if they are not used by the account class code rules.

You can invalidate the account class rule by changing the validity range to parameter.

Account review rules

View review rules

  1. Open the account view page.

  2. From the content menu, choose the Settings > Account review rules option.

On the Account rule review settings page, you will see all account review rules available for the account:

Enable/Disable review rules

  1. Open the account view page.

  2. From the content menu, choose the Settings > Account review rule config option.

  3. From the Account review rule settings list, choose the necessary rule.

  4. Click the icon to update rule status > click the Save button.

Additional info - private

This list of parameters applies only to the creation of a private person.

Field name
Description

See the Additional info section below as it appears when creating a private person:

Create currency account with application

This explanation applies primarily to external and hybrid account configurations and the standard configuration if selected.

About account application

In the account opening process, the creation of the account application is a preparatory stage before the account opening and consists of two steps.

  1. .

  2. .

Confirmation of the account application initiates the account opening process. Depending on the , the account will be assigned either an externally provided or internally generated account number.

Create account application

Follow the steps below to open a currency account using the account application.

  1. Open the person view page:

    • Go to Persons > Search.

    • Fill in search parameters > click the Search button.

    • Click the Identification number to access the person view page.

  2. Create an account application for a person:

    • From the person content menu, choose Account > Account applications.

    • Click the Create application button.

  3. Fill in the main .

Selecting the correct combination of account type setup, service provider code, and account code parameters is crucial to opening the intended account.

  1. If necessary, you can add account owner limits (optional).

    • Click the Add Limits button to open the section with parameters.

    • Fill in the parameters for the account owner limits.

  1. If necessary, you can add representatives and their limits (optional).

    • Click the Add Representatives button to open the section with parameters.

    • Fill in the parameters for the representative and set their limits.

  1. Click Submit to complete the creation of the account application.

You must to start the account opening process.

Edit or cancel account application

After clicking Submit, Tuum creates a draft account application with the status INSERTED. You can or the draft application until you confirm it and start the account opening process.

Edit account application

Click Edit to change the account application details and click Save to preserve the changes.

You must to start the account opening process.

Cancel account application

Click Cancel to cancel the account application.

  • Select the reason for the status change and add a comment, if necessary.

  • Click Yes to confirm the cancellation.

Cancelling an account application results in the irreversible termination of the account application process.

Set up a generic price list

You can set up a generic price list which is used as a backup for complex pricing strategies and to cover prices that may not exist in the other price lists. A generic price list is not related to any customer group code.

To create a generic price list, enter the following parameters:

Parameter
Type
Description

Click Submit to save the price list. The Fee price lists page opens and the new price list is visible on this page. Now, you can for the price list. Click the Price list ID to open the Price list prices page.

Sample of a generic price list

The following screenshot shows the filled parameters of a sample generic price list called TUUM_SAMPLE_GENERIC_PL:

Account class code rule parameters

Parameter name
Type
Description

Account type code*

List

Select the account type code. The following values are available:

  • OVERDRAFT,

  • SHADOW,

  • SAVING,

  • VIRTUAL,

  • INTERNAL,

  • CURRENCY.

Account class code

Number/Text

Select the account class code value.

Class change allowed*

List

Select if the class change is allowed or not.

Validity from*

Date

Choose the rule validity date from.

Validity to

Date

Choose the rule validity date to.

account interest section

Date of birth

Select the person's date of birth.

Format: DD.MM.YYYY

Country of birth

Select the country of birth.

Place of birth

Enter the place of birth.

Language

Select the person's native language.

Nationality

Select the person's nationality.

Education

Select the level of education from the drop-down list. The available values can be defined on the PERSON.PERSON lookup page by selecting PERSON_EDUCATION as the Lookup type. For more information, see Create lookup codes. Example values include:

  • Higher education;

  • Not available;

  • Primary;

  • Secondary;

  • Vocational school.

Marital status

Select the person's marital status. The available values can be defined on the PERSON.PERSON lookup page by selecting PERSON_MARITAL_STATUS as the Lookup type. For more information, see Create lookup codes. Example values include:

  • Cohabitant;

  • Complicated;

  • Divorced;

  • Married;

  • Single;

  • Widowed.

Web address

Enter the person's web address.

Intra org code

Enter the intra org code.

Intra org codes are used to identify different branches or entities within the same organisation operating on the platform.

For example, if Bank A has branches in London and Berlin, each branch should have a unique intra org code to distinguish their records.

Counterparty sector code

Select the counterparty sector code. This parameter defines the financial sector to which the company belongs. The code is assigned by the relevant regulatory authority, such as the European Banking Authority (EBA) in the European Union. Available options are:

  • Central banks;

  • Credit institutions;

  • General governments;

  • Households;

  • Non-financial corporations;

  • Other financial corporations.

PEP

Indicates whether the person is a Politically Exposed Person (PEP), meaning they hold or have been entrusted with a prominent public position.

PEP explanation

Enter the reason why the person is considered a PEP.

Note: This field is visible only when PEP is set to Yes.

US resident

Indicates whether the person is considered a resident of the United States.

Creating an account application
Confirming an account application
account setup type
account application details
confirm the account application
edit
cancel
confirm the account application

Is generic price list?*

Yes/No

Select Yes to create a generic price list.

Price list type code*

Text

Enter a unique code for the price list.

Description

Text

Enter a short description of the purpose of the price list.

Price start date*

Date

Select the date when the price list starts to be valid.

Format: DD.MM.YYYY

Price end date

Date

Select the end date of the validity of the price list. The last date is excluded from the period.

Format: DD.MM.YYYY

define prices
Create lookup codes
Person groups
Person statuses
Person statuses

BackOffice content page features

The BackOffice content page features allow the BackOffice user to customise their viewing preferences within the content area. These features apply to the pages with new design and are related to specific content elements displayed on those pages.

This chapter highlights the tools available to manage and optimise your experience within specific content element groups in the BackOffice.

Page layout

The layout of the content page includes a page summary header, if available, and content sections in the middle, along with a content sidebar that features action buttons and various content section navigators on the right.

Summary header

The summary header represents a collection of the most prominent data items for the business object, in this example, a person, across all content sections. Its purpose is to give users a quick and comprehensive overview of the business object at a glance.

Action buttons

The action buttons, which allow the user to perform critical activities on the business object, in this example, inactivating the person's record or restricting access to it, are located at the top of the content sidebar on the right.

For more information about the action buttons in the content sidebar, refer to the Change status of a person chapter for an illustrative example.

Section navigators

The section navigators on the content sidebar present a comprehensive list of distinct content sections. Each item in this list serves a dual purpose:

  1. A checkbox on the left controls whether its corresponding section is visible in the main content area. A checked box makes the section visible, while an unchecked box hides it.

  2. When a checkbox is checked, the item also acts as a navigator. Clicking on the item's label will smoothly scroll the user to that visible section in the main content area, which is indicated by an arrow on the right.

Page content section features

The primary component for displaying a list of data entities in a specific section of the page is a basic table. The tools located in the table header enable users to customise and rearrange the view of the table's content, as illustrated below.

Show history toggle

Check the box next to Show history to display past records, if any are available.

Show more details

If an icon with three dots appears in square brackets , it indicates that some table columns cannot be displayed within the visible area of the screen.

Click Show more to reveal the list of hidden columns. You can also reorganise the order of table columns to make a hidden column visible.

Download items

You can download items by clicking Download next to the document or file you want to download. The download will begin automatically and save the document or file to your default download folder.

Select items per page

You can adjust how many items are shown per page:

Organise displayed columns

You can customise which columns are shown and in what order.

Click Settings to customise which columns are visible.

  • To relocate the column into a different position: Click and hold the reorder handle next to the column name, then drag and drop the column to the desired position. Changes take effect immediately.

  • To show or hide a specific column: Check or uncheck the box next to its name. Changes are applied instantly.

Filter data items

Many sections include a Filter icon, which helps narrow down search results when working with large sets of data. For example, in the Actions log section, click Filter to open the search bar.

Start typing your search term, and results will begin to appear as you type. You can enter values such as a user’s first or last name, or the name of a specific parameter you're looking for.

Sort data items

You can sort data items by clicking Sort in any column header.

When you hover over a column header, both up and down arrows appear, indicating that the column is currently unsorted. Clicking the icon will cycle through sorting states: ascending (↑), descending (↓), and back to unsorted.

Edit data item

To edit a data item, click Edit, make the necessary changes or select a different option, then click Save to apply your updates.

Delete data item

To delete a data item, click Delete.

Review the confirmation modal below, then click Confirm to proceed or Cancel to stop the deletion.

Account parameter rule

Account parameter rules allow restricting account attributes depending on the account type, person type, account class and jurisdiction country code. When creating a new account, the Tuum system selects a valid account parameter rule that is matching to the account attributes.

Enable account parameter rule feature

Enabling an account parameter rule feature is a one-time action. Once enabled, you can continue creating and managing the account parameter rules without the need to re-enable it.

To use the account parameter rule, you must enable this feature:

  1. Administration > Settings > System property.

  2. From the content menu, choose account-api.

  3. From the list of rules, find the USE_ACCOUNT_PARAMETER_RULES code > click the sign to update the system property.

  4. Change the system property value to Yes.

Add new account parameter rule

  1. Accounts > Settings > Account parameter rule.

  2. On the account parameters page, click the Create rule button.

  3. Fill in the parameter rule parameters > Save.

To ensure the account parameter rule applies to a new account, select account type, person type, account class, and jurisdiction country code when creating an account.

Find account parameter rule

Once a new account rule is added, it appears on the account parameter rules page:

  • Accounts > Settings > Account parameter rule.

Update account parameter rule

  1. Accounts > Settings > Account parameter rule.

  2. Click the in front of the rule that you want to modify.

  3. Update the parameter rule > Save.

You can modify the following rule parameters:

  • Currencies,

  • Residency countries,

  • Tax residency countries,

  • Interest method assignments,

  • Customer groups,

  • Validity range from,

  • Validity range to.

Disable account parameter rule

  1. Accounts > Settings > Account parameter rule.

  2. Click the cross sign in front of the rule that you want to disable.

  3. Select the invalidate from date > Invalidate.

Account view page

On the account view page, you can get an overview of the account details and balances and access to account management features.

View account details

To go to the account view page, follow the steps outlined below.

  1. Find the required account.

  2. Open the account view page by clicking on the account Account number.

Account view page

The account view page has four sections:

  1. header,

  2. account details,

  3. account numbers and

  4. account balances.

Header section

The header section starts with the title, followed by action buttons for account management and account-related activity review links at the end.

Three action buttons you will find in the header section of the Account view page allow you to perform particular actions.

  • Edit details - allows modifying the account name information.

  • Block account - allows temporarily setting the account to the blocked status.

  • Close account - allows closing the account.

Close account - is an irreversible action. Once an account is closed, it cannot be reopened.

At the end of the header section on the Account view page, you can find three links that provide an overview of various account-related activities.

  • 4eye review processes - to view the account-related review processes.

  • Actions log - to view the account-related actions.

  • Account processes - to view the account-related processes.

Account details section

The account details section gives you a comprehensive overview of account-related parameters. It includes three parameters that you can change.

  • Click the edit icon next to the Account class parameter value to change the Account class code.

  • Click the edit icon next to the Interest method assignment code parameter value to change the Interest method assignment code.

  • Click the Open modal link following the Custom fields parameter to manage the account-related custom fields.

Account numbers section

The account numbers section lists all alternative account number sets for different use cases, such as domestic payment schemes.

Account balances section

The account balance section lists account balances in different currencies. Each currency has the following balance items.

  • Balance indicates the gross amount available to the account holder.

  • Overdraft shows an amount permitted by the bank which can be overdrawn. Click the add icon to add an overdraft in a particular currency. If an overdraft already exists, you can view it by clicking the view icon , adjust it by clicking the edit icon or remove it by clicking the remove icon .

  • Reserved is an amount that still belongs to the account holder but has been suspended and reserved, for example, by a merchant.

  • Available is the net amount in the balance currency available to the account holder.

Set up a non-generic price list

You can create a new non-generic price list applicable to a dedicated group of customers.

To create a non-generic price list, enter the following parameters:

Parameter
Type
Description

Is generic price list?*

Yes/No

Select No to create a price list that is not generic.

Related generic price list

List

If you want to relate the price list you are creating to a generic price list, select the generic price list from the drop-down menu.

Note: This field is displayed only if you select No for the Is generic price list field.

Price list type code*

Text

Enter a unique code for the price list. The code must be unique within the specific customer group.

Description

Text

Enter a short description the purpose of the price list.

Customer group code*

List

Select a customer segmentation group for which the price list is valid. Available values consist of the price list related to the customer groups you created with Tuum.

The customer groups are connected to accounts and not related to persons.

Note: This field is displayed only if you select No for the Is generic price list field.

Fee configuration group

List

Select a group from the drop-down menu.

A fee configuration group must be selected if you want the fees listed in this group to be created as fee bookings and not as fee transactions

Note: This field is displayed only if you select No for the Is generic price list field.

Price start date*

Date

Select the date when the price list starts to be valid.

Format: DD.MM.YYYY

Price end date

Date

Select the end date of the validity of the price list. The last date is excluded from the period.

Format: DD.MM.YYYY

Click Submit to save the price list. The Fee price lists page opens and the new price list is visible on this page. Now, you can define prices for the price list. Click the Price list ID to open the Price list prices page.

Sample of a non-generic price list

The following screenshot shows the filled parameters of a sample price list called TUUM_SAMPLE_PL. The price list is related to the generic price list TUMM_SAMPLE_GENERIC_PL and is applicable to a specific customer group.

Create prices for transaction fees

You can set up fees ranging from simple transaction-based prices to complex scenarios using tiered pricing and labels.

By default, the following transaction fees are present:

Fee type code
Description

ACC2INTRA_FEE

Fee for an outgoing payment where both accounts are within Tuum (also known as intrabank payment).

ACC2LOCAL_FEE

Fee for an outgoing payment through a local payment scheme.

ACC2SEPA_FEE

Fee for an outgoing payment through the SEPA payment scheme.

ACC2SEPA_RET_FEE

Fee for a returned outgoing payment through the SEPA scheme.

ACC2SWIFT_FEE

Fee for an outgoing payment through a SWIFT payment network.

INTRA2ACC_FEE

Fee for an incoming payment where both accounts are within Tuum (also known as intrabank payment).

LOCAL2ACC_FEE

Fee for an incoming payment through a local payment scheme.

SEPA2ACC_FEE

Fee for an incoming payment through the SEPA payment scheme.

SEPA2ACC_RET_FEE

Fee for a returned incoming payment through the SEPA scheme.

SWIFT2ACC_FEE

Fee for an incoming payment through a SWIFT payment network.

CARD_TOP_UP_FEE

Fee for payment to increase the card limit.

CARD_WITHDRAWAL

Fee for withdrawal of cash from an ATM machine.

FX_FEE

Fee for a foreign exchange transaction.

VIBAN_IN_FEE

Fee for incoming payment from a virtual IBAN account.

VIBAN_OUT_FEE

Fee for outgoing payment from a virtual IBAN account.

See the following topics for different types of pricing options for transaction fees:

Addresses

There are two types of address formats: unstructured and structured.

  • The is a non-standardised and less detailed representation of the address.

  • The is a more detailed representation of the address following the ISO 20022 standard guidelines.

These parameter lists apply to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

Unstructured address

Field name
Description

See the Unstructured address format below:

Structured address

Field name
Description

See the Structured address format below:

Account parameter rule parameters

Parameter name
Type
Description

Limits view page

The Limits view page shows the information about the that were added along with the information.

The usage information is available only if the account limit was applied.

Limits

Parameter name
Type
Description

Usages

Parameter name
Type
Description

Account type*

List

Select the account type:

  • CURRENCY,

  • INTERNAL,

  • VIRTUAL.

Account holder type*

List

Select the person type:

  • Private,

  • Legal.

Account class

List

Select the account class. If you want to use this parameter for the account parameter rule, make sure that the account class is configured before.

Jurisdiction country*

List

Select the jurisdiction country. This parameter reflects branch jurisdiction country code. The jurisdiction parameter is defined on the account level.

Currencies

List

Select the allowed currencies for the parameter rule.

Residency countries

List

Select the residency countries. The residency countries parameter is defined on the account level.

Tax residency countries

List

Select the tax residency countries. The tax residency parameter is defined on the account level.

Method assignment codes

List

Select the interest method assignments. Note that the method assignment codes are a lookup parameter. If you have not configured the method assignment code values, refer to the following instructions.

Customer groups

List

Select the customer groups.

Note that the customer groups are a lookup parameter. If you have not configured the method assignment code values, refer to the following instructions.

Tenant*

Number/Text

Enter the tenant name for which you are configuring the account parameter rule.

BIC key

Number/Text

Enter the BIC key value.

Numbering sequence key

Number/Text

Enter the Numbering sequence key value.

Validity range from*

Date

Select the account parameter rule validity from date.

Validity range to

Date

Select the account parameter rule validity to date.

Prices without tiers
Prices with tiers
Prices with labels

Limit scope*

Number, Text

This is a prefilled parameter. The account limit scope:

  • ACCOUNT,

  • ACCOUNT_USER,

  • ACCOUNT_OWNER.

Limit code

Number, Text

This is a prefilled parameter. The custom name of the account limit.

Person identifier*

Number, Text

This is a prefilled parameter. The name and identifier of a person to whom the account limit is being applied.

Period type code*

Text

This is a prefilled parameter. period when the limit is active:

  • YEARLY,

  • MONTHLY,

  • WEEKLY,

  • DAILY.

Calculation type*

Text

This is a prefilled parameter. The account limit calculation type:

  • CROSS_CURRENCY,

  • PER_CURRENCY.

Amount*

Number

This is a prefilled parameter. The account limit amount.

Used amount

Number, Text

This is a prefilled parameter. The amount used under the limit.

Validity range*

Date, Time

This is a prefilled parameter. The period when the account limit is applied.

Used amount*

Number, Text

This is a prefilled parameter. Indicates the amount that was used under the limit.

Last used date*

Date

This is a prefilled parameter. The last date when the limit was used.

Usage period*

Date

This is a prefilled parameter. The account limit usage period.

Reset time

Date

This is a prefilled parameter. It shows the date and time when usage was reset.

limits
usage

Address format

Toggle between structured and unstructured address formats.

Address type *

The address type can be defined on the PERSON.ADDRESS lookup page by selecting PERSON_ADDRESS_TYPE or PERSON_LEGAL_ADDRESS_TYPE as the Lookup type. For more information, see Create lookup codes.

  • For a private person, the default address type is Residency address.

  • For a legal person, the default address type is Registration address.

Additional addresses can be added by clicking Add .

Country *

Select the country of the address.

State / Region

Enter the state or region of the address.

City / County *

Enter the city or county of the address.

Address line 1 *

Enter the main part of the address.

Address line 2

Enter any additional address details.

Postal code

Enter the postal code.

Move in date

Select the date the person moved into the address.

Format: DD.MM.YYYY

Address format

Toggle between structured and unstructured address formats.

Address type *

The address type can be defined on the PERSON.ADDRESS lookup page by selecting PERSON_ADDRESS_TYPE or PERSON_LEGAL_ADDRESS_TYPE as the Lookup type. For more information, see Create lookup codes.

  • For a private person, the default address type is Residency address.

  • For a legal person, the default address type is Registration address.

Additional addresses can be added by clicking Add .

Street name *

Enter the name of the street.

Building number *

Enter the number of the building.

Building name

Enter the name of the building, if applicable.

Floor

Specify the floor number or level within the building.

Apartment number

Enter the apartment number, if applicable.

Post box

Enter the post office box number, if mail is received via a P.O. box.

City / County *

Enter the city or county of the address.

District

Enter the district or administrative area within the city or region.

Town location name

Enter a specific locality or neighbourhood within the town or city.

Postal code

Enter the postal code.

Country *

Select the country of the address.

Department

Enter the relevant department within the organisation, if applicable.

Sub-department

Enter the relevant sub-department, if applicable.

Move in date

Select the date the person moved into the address.

Format: DD.MM.YYYY

unstructured address
structured address

Account application parameters

General info

Parameter name
Type
Description

Account numbers

Parameter name
Type
Description

Account owner limits

Parameter name
Type
Description

The same parameters apply to setting account limits for representatives.

Representative data

Parameter name
Type
Description

Prices without tiers

The configuration parameters are as follows:

Parameter
Type
Description

Click Submit and the price is now available under the Fee type code. Click the Price id to view the price details. You have the option to edit and invalidate the price.

Sample of a price without tiers

Consider that we want to set up a price for transaction fees for outgoing local payments.

We are using the sample price list we created before - . From this price list, we are selecting the ACC2LOCAL_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 with percentage. This means the price is calculated using the fixed amount plus a percentage of the transaction.

  3. Select the Transaction currency code as EUR. This means that the price is set for transactions that are carried out in EUR.

  4. Select the Fee currency code as USD. This means that the fee is charged in USD.

  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 Fixed amount = 5, Percentage = 0.5, Min fee amount = 5.5, Max fee amount = 9. (Note that the maximum fee cannot be less than 5 as the value of the fixed fee is 5.)

  8. Click Submit.

Result: The fee amount is calculated like this: The Min fee amount value is considered as the floor amount for the full fee amount.

  • If the value of Fixed amount + Percentage >= Min fee amount, then the total fee of fixed + percentage is charged.

  • If the value of Fixed amount + Percentage < Min fee amount, then the value of the minimum fee amount is charged as the fee.

The following screenshot shows the fee creation page with the sample values:

Account limits

Account limits flow

To create account limits you first must create:

  1. Account limit code - an optional step. The limit code defines the limit subtype.

  2. Account limit type - a mandatory step. The limit type defines the way how the limit is applied.

  3. Account usage limit default rule - an optional step. You can create default usage rules if you want to assign some default limits to currency accounts.

Create account limit code

  1. Accounts > Settings > Limits setup.

  2. From the content menu choose Usage limit types and codes.

  3. Scroll the page to the Usage limits codes.

  4. Click the Add new code button.

  1. Fill in the > Save.

Create account limit type

  1. Accounts > Settings > Limits setup.

  2. From the content menu choose Usage limit types and codes.

  3. Find the Usage limit type section, click the Add new type button.

  1. Fill in the > Save.

Create account usage default rule

  1. Accounts > Settings > Limits setup.

  2. From the content menu choose Usage limit default rules.

  3. Click the Add new rule button.

  1. Fill in the .

Create account limit

  1. Open the .

  2. From the content menu, choose Limits > click the Add Limit button.

  1. Fill in Limits information > click the Add limit button > fill in the > click the Add limit button.

View account limits

  1. Open the .

  2. From the content menu, choose Limits.

  3. To view only the valid limits, select the Only valid checkbox.

Modify account limits

  1. in question.

  2. Click the pencil sign to modify the limit.

  3. Enter a new Limit amount > click the Change limit button.

Terminate account limits

The BackOffice allows you to terminate account limits by invalidating them. To do that:

  1. in question.

  2. Click the cross sign to terminate the limit.

  1. Click the Terminate limit button to confirm the action.

Limits parameters

Account usage limit code parameters

Parameter name
Type
Description

Account limit type parameters

Parameter name
Type
Description

Usage limit default rule

Parameter name
Type
Description

Account limit parameters

Parameter name
Type
Description

Account type setup

/service provider code

/account type*

List

Select your account setup type:

  • STANDARD/TUUM/CURRENCY,

  • EXTERNAL_VIRTUAL/LHV/CURRENCY,

  • EXTERNAL_VIRTUAL/BC/CURRENCY,

  • EXTERNAL_VIRTUAL/TUUM/CURRENCY,

  • EXTERNAL_VIRTUAL/CC/CURRENCY.

Note: you will only see the options that are relevant to your setup.

Jurisdiction country*

List

Select the account jurisdiction country.

Account class

List

Select the account class.

Account name

Text

Enter the client account name.

Default currency*

List

Select the default currency from the list.

Customer group*

List

Select a customer segmentation group. Available values consist of customer groups you have created with Tuum.

Price list type*

List

Select an account price list type within the chosen customer group. Available values consist of price list types you have created with Tuum.

Account holder name*

Text

Enter the actual name of the account holder.

Residency country*

List

Select the residency country code.

Tax residency country*

List

Select the tax residency country.

Account number type*

List

Select from the available options:

  • IBAN - International Bank Account Number contains the account number, bank and branch information and country code.

  • BBAN - Basic Bank Account Number. It represents a country-specific bank account number.

Account number*

Number

Enter the account number.

Financial institution id*

Text

Enter the identification number of the financial institution.

Financial institution id type*

List

Select the financial institution id type:

  • BIC - a unique eight- or eleven-digit alphanumeric code identifying a specific bank or branch worldwide.

  • SORT_CODE - a unique six-digit numerical code identifying a specific bank or branch in the United Kingdom and Ireland.

  • ABA_CODE - an ABA routing transit number (ABA RTN) is a unique nine-digit code identifying a financial institution within the United States.

  • BANK_CODE - a unique domestic numerical identifier for a specific bank, branch, or financial institution in most countries, excluding the United States, United Kingdom, and Ireland.

Note: The account number type IBAN allows you to select BIC, and the account number type BBAN allows you to select SORT_CODE, ABA_CODE or BANK_CODE.

Country*

List

Select the account country from the list.

Currency code*

List

Select the account currency from the list.

Add limit type*

List

Select the account limit type:

  • Daily,

  • Monthly.

Currency code*

List

Select currency from the list.

Amount*

Number

Enter the limit amount.

SSN*

List

Select representative from the list.

Account right code*

List

Select the account right code from the list:

  • All rights,

  • View rights,

  • Change rights.

Code*

Text/Number

Enter the technical name of the limit code.

Name

Text/Number

Enter the limit code name.

Description

Text/Number

Enter the limit code description.

Enabled

List

Select if the limit code is enabled. The possible options:

  • Yes,

  • No.

Scope type*

List

Defines the limit scope. For whom the limit is applicable:

  • Per account - the limit applies to an account.

  • Across all owner's accounts - the limit applies to a person and all accounts that belong to that person.

  • Per account and usage person - the limit applies to the private person who initiates the payment.

Calculation type*

List

Select the calculation type:

  • Usages recalculated into limit currency,

  • Usages calculated per each currency.

Period type*

List

Select the period when the limit type is applied:

  • Daily,

  • Weekly,

  • Monthly,

  • Yearly.

Limit code

List

Select the relevant limit code.

Limit scope / period / calculation type / code*

List

Select

Limit amount*

Number

Enter the limit amount.

Currency code*

List

Select the limit currency.

Person type

List

Select the person type:

  • Private,

  • Legal.

Account class code

List

Select the account class code. See more about the account class codes in the following chapter.

Date from

Date

Select the date from which the default rule is valid.

Date to

Date

Select the validity to date.

Limit scope / period / calculation type / code*

List

Select the required limit configuration:

  • Limit scope - limit scope type:

    • ACCOUNT - the limit applies to one account.

    • ACCOUNT_USER - the limit applies to the private person who initiates the payment.

    • ACCOUNT_OWNER - the limit applies to a person and all accounts that belong to that person.

  • Period - period when the limit is active:

    • YEARLY,

    • MONTHLY,

    • WEEKLY,

    • DAILY.

  • Calculation type - defines how the limit is calculated:

    • CROSS_CURRENCY - transactions can be made in different currencies, and limit usage is calculated into limit currency with current reference rates.

    • PER_CURRENCY - limit usage is calculated on transactions made with the currency that matches the limit currency.

  • Code - is a unique name used to identify the account limit type.

Currency*

List

Select the account limit currency.

Limit amount*

Number

Enter the limit amount.

Date from*

Date

Select the date when the account limit is effective. The date format:

DD.MM.YYYY.

account limit code parameters
parameters
default rule parameters
account view page
limits parameters
account view page
Find the account limit
Find the account limit

Fee calculation rule*

List

This field is used to define how the fee is calculated.

Select one of the following options:

  • Fixed fee - A fixed amount is charged.

  • Fixed fee with percentage - The fee is calculated as a fixed amount plus a percentage of the transaction amount.

  • Percentage fee - The fee is calculated as a percentage of the transaction amount.

Transaction currency code*

List

The currency in which the transactions are carried out. Select a transaction currency code from the drop-down list.

Note: You can select the All currencies option if the price is the same for all similar transactions made in different currencies.

You can also combine the options as follows:

  • Define the price of 10 EUR with All as the Transaction currency code.

  • Define another separate price of 8 EUR for the USD transaction currency code.

  • Define a separate price of 9 EUR for the GBP transaction currency code.

Result:

  • If a transaction is made in EUR or NOK or any other supported currency, then the fee of 10 EUR is charged.

  • If a similar transaction is made in USD, then the fee of 8 EUR is charged.

  • If a similar transaction is made in GBP, then the fee of 9 EUR is charged.

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

You can select one or more label values for the transaction fee for detailed pricing if a particular transaction fee type has label names attached with it.

See Prices with labels for more information.

Prices

Enter the price, percentages, and maximum and minimum fee amounts as applicable.

TUUM_SAMPLE_PL

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

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.

See the section for more information.

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.

We are using the sample price list we created before - TUUM_SAMPLE_PL. From this price list, we are selecting the ACC_ADM_FEE fee type and following these steps:

  1. 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.

  2. 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).

  3. Select the Fee calculation rule as Fixed fee. This means that a fixed amount is charged for account maintenance.

  4. 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.

  5. Select the Fee currency code as EUR.

  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. 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:

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 Labels for periodic fees section.

Labels for periodic fees

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 specific APIs.

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.

Prices with tiers

Tiers are useful for grouping the transactions and setting prices for the groups respectively. You can only set up tiers for transaction-related fees. You can select a tier type for the price.

There are 3 types of tiered pricing models in Tuum:

  • Based on the transaction amount. For example, if the outgoing SWIFT payment is less than 10,000 USD then the transaction-related fee amount is 20 EUR. If the SWIFT payment is more than 10,000 USD then the related fee is 25 EUR.

  • Based on the transaction amount in tier currency. For example, if the outgoing SWIFT USD payment amount expressed in EUR is less than 10,000 EUR (up to 10,950 USD payment depending on the FX base rate), then the transaction-related fee amount is 20 EUR. If the SWIFT USD payment expressed in EUR is more than 10,000 EUR then the related fee is 25 EUR.

  • Based on the transaction grouping rule. For example, for the first 100 SEPA payments from the virtual accounts during the week, the transaction-related fee amount is 1 EUR per payment. For all the next SEPA payments from the virtual accounts during the same week, the fee is 0.80 EUR per payment.

More specific transaction groupings can be configured using specific APIs to set rules for gathering transaction statistics:

  • Aggregation period: DAILY, MONTHLY, WEEKLY or YEARLY.

  • Grouping type: COUNT or SUM.

  • Transaction type(s) to be counted or summer over aggregation period.

  • Label names to be used for more detailed statistics used in pricing.

Configuration of transaction prices with tiers

The configuration parameters are as follows:

Parameter
Type
Description

Click Submit and the price is now available under the Fee type code. Click the Price id to view the price details. You have the option to edit and invalidate the price.

Samples of prices with tiers

Amount-based transaction sample

Consider that we want to set up a price for transaction fees for outgoing SEPA payments based on the following scenario:

  • For transaction amounts €100 - €200, the fee charged per transaction is €0.5.

  • For transaction amounts €200 - €500, the fee charged per transaction is €0.7.

  • For transaction amounts €500 - €1000, the fee charged per transaction is €1.2.

We are using the sample price list we created before - . From this price list, we are selecting the ACC2SEPA_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 Tier currency code, 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.

  1. To add tiers, click the icon next to Tiers.

  2. According to the pricing scenario mentioned above, enter the values as follows:

Note that the Max transaction amount field excludes the last number from the range.

  1. Click Submit.

Group-based transaction sample

Consider that we want to set up a price for transaction fees for outgoing SEPA payments based on the following scenario:

  • For the first 100 transactions during the month, the fee charged per transaction is €0.9.

  • For the next 500 transactions during the month, the fee charged per transaction is €0.5.

  • For more than 500 transactions during the month, the fee charged per transaction is €0.2.

We are using the sample price list we created before - . From this price list, we are selecting the ACC2SEPA_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 Group based.

  4. Select the Tier application mode as Highest.

  5. Select the Tier currency code as EUR.

  6. Select the Transaction grouping code as ACC2SEPA_COUNT. This means that the number of transactions in a month is counted.

  7. Select the Transaction currency code and Fee currency code as EUR respectively.

  8. 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.

  9. Price date to is an optional field and you can edit the date later.

  1. To add tiers, click the plus iconnext to Tiers.

  2. According to the pricing scenario mentioned above, enter the values as follows:

Note that the Max transaction amount field excludes the last number from the range.

  1. Click Submit.

Labels for periodic fees

Fee calculation rule*

List

This field is used to define how the fee is calculated.

Select one of the following options:

  • Fixed fee - A fixed amount is charged.

  • Fixed fee with percentage - The fee is calculated as a fixed amount plus a percentage of the transaction.

  • Percentage fee - The fee is calculated as a percentage of the transaction.

Tier type*

List

Select one of the following tier options:

  • Group based - Based on transaction groups.

  • Amount single - Based on transaction amounts.

  • Amount single (in tier currency) - Based on the transaction amount in tier currency.

Tier application mode

List

This field describes the behavior when the transaction amount crosses the tier limit.

Select one of the following tier application modes:

  • Highest - The upper tier is selected for the calculation.

  • Partial - The transaction amount for calculation is split between 2 consequent tiers.

Tier currency code*

List

This field is displayed only if you select a tier type.

The tier currency is used to sum up transactions carried out in different currencies which is then used to find the appropriate price tier. Select a currency code from the drop-down list.

Transaction grouping code*

List

This field is displayed only if you select the tier type as Group based.

Select one of the options from the drop-down list. The displayed options depend on the fee type and pre-configured grouping rules to gather transaction statistics.

Transaction currency code*

List

The currency in which the transactions are carried out.

Select a transaction currency code from the drop-down list.

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

Tiers

In the Tiers section, click the icon and enter the amounts as applicable.

TUUM_SAMPLE_PL
TUUM_SAMPLE_PL

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

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

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.

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.

We are using the sample price list we created before - TUUM_SAMPLE_PL. From this price list, we are selecting the CARD_REPLACEMENT_FEE fee type and following these steps:

  1. 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.

  2. Select the Fee currency code as EUR.

  3. 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.

  4. Price date to is an optional field and you can edit the date later.

  5. 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

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 specific APIs.

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.

Labels for one-time fees

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.