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...
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...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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.
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.
The Role management page is where you can create and manage roles.
To access it, navigate to:
Administration > Access management > Roles.
The Roles page opens.
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 .
To remove a role:
Go to Administration > Access management > Roles.
On the Roles page, click Delete next to the name of the role that needs to be removed.
You can delete a role only if it is not assigned to any users.
The Confirmation modal opens.
Click Confirm to proceed, or Cancel to discard.
The User management page enables you to create and manage both BackOffice and API users.
To access it, navigate to:
Administration > Access management > Users.
The User management page opens.
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 .
The Organisational units management page is where you can create and manage organisational units.
To access it, navigate to:
Administration > Access management > Organisation.
The Organisational units page opens.
For BackOffice users, there are two options for managing user credentials:
Single Sign-On (SSO) - If your company uses SSO through Google or Microsoft Azure, user credentials will be managed via these identity providers. For more details, refer to the relevant provider instructions.
To assign or remove user roles:
Go to Administration > Access management > Users.
In the list of the users, click the Technical ID of the user that needs to be modified.
There are two types of privileges:
View privileges. This group of privileges grants view-only access. For example, VIEW_CONTRACT_EVENTS, VIEW_DEPOSIT_OFFER.
Action privileges. This group of privileges grants permissions to add, edit, delete items. 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.
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.
The main menu has been thoughtfully relocated to the left while maintaining its familiar elements and order, inspiring a seamless and smooth user experience.
Modifying a role means granting or revoking privileges. To do that, follow these steps:
Go to Administration > Access management > Roles.
Click the Code to open the Role management page.
An organisational unit represents a structural part of your company within the Tuum platform. It reflects how your organisation is arranged in real life, for example, by departments, branches, or regions, and allows you to mirror that hierarchy in the system.
Organisational units help structure users, roles, and responsibilities. By assigning employees to specific units, you can clearly define access rights and visibility boundaries in line with your company’s internal setup.
Below, you can learn more about how to perform organisational unit management activities in the Tuum system.
This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).
See the Files section below:
You can find a list of all users by following these steps:
Go to Administration > Access management > Users.
The Users page opens.
If you need to find a particular user, click Filter and enter the Technical ID, Username, First name
Modifying an organisational unit means updating its details. To do that, follow these steps:
Go to Administration > Access management > Organisation.
Click the Unit code to open the details page.












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 creating a 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 here.
If the link for password creation has expired, the user should follow the instructions in the Change password - user section to create a password.
The BackOffice admin should create a password for the API user by following the instructions in the chapter Change password - BackOffice admin.
On the User details page, scroll down to the Roles section, and click Edit next to the role.
You can:
Assign a role by toggling On next to the role name.
Remove a role by toggling Off next to the role name.
To confirm the changes, click Save.


Go to Administration > Access management > Roles > Add.
The Role management page opens.
All privileges are grouped by product or functionality. To view the list of privileges, click Expand.
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.
Enhance your productivity with the feature-rich side panel. Easily access your favourite pages, copied content, and page history.
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.
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.
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.
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.
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.
The content menu toggle gives you the power to keep your content menu open or closed just the way you like it.
Minimise or maximise the main content space with the content width toggle for a more comfortable browsing experience with just one click.
Clicking on the profile icon reveals a link to your profile settings and a logout button.
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.
The current banking day is always visible here. Look out for a vibrant red icon, signalling an ongoing banking day change process.

On the Role management page, find the necessary privileges group.
Click Expand to select privileges.
You can:
Grant a privilege by toggling On next to the privilege name.
Revoke a privilege by toggling Off next to the privilege name.
To confirm the changes, click Save.


Use the shortcuts below to quickly access user guides related to this domain's knowledge.
File type *
Select the file type.
These values can be defined on the PERSON.DOCUMENT lookup page. For more information, see Create lookup codes.
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;
Additional files can be added by clicking Add .
File *
Click the upload icon to upload the file.
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.
Go to Organisational unit tab and click Edit.
Update the organisational unit details, then click Save.


This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).
Relationship type *
Select the relationship type:
Accountant;
Director;
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.
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
This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).
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.
See the Additional contacts section below as it appears when creating a legal person:
This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).
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.
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
This list of parameters applies only to the creation of a private person.
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
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;
Employment time
Select the employment duration. Available options are:
More than 4 years;
Trial;
See the Work section below as it appears when creating a private person:
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:
This list of parameters applies only to the creation of a legal person.
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;
See the Additional info section below as it appears when creating a legal person:
This list of parameters applies only to the creation of a private person.
Property type
Select the property type of the person's home. Available options are:
Living with parents;
Other;
Building type
Select the building type of the person's home. Available options are:
Apartment;
Other;
See the Home section below as it appears when creating a private person:
In Tuum, account functionality is based on two different logical setups:
Account product – the core logic used for all new clients.
Account parameter rule – the core logic used for earlier Tuum clients who have not yet migrated to the Account product setup.
If you are using the Account product setup, begin with the Account product section. There you will find explanations of the setup’s components and links to detailed configuration instructions.
If you are using the Account parameter rule setup, start with the section instead. For instructions on additional elements related to the account, use the table of contents to find the relevant component and follow the guidance provided there.
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.
Go to Persons > Settings > Person groups.
On the Person groups page, click Add .
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 or person.
There are two ways to find an account application.
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.
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.
After submitting an account application, the account application details page will open.
Click Confirm > Yes to confirm the account application.
To view a person's action history and processes, follow these steps:
Search for the person whose action logs and processes you want to view.
Click the person's name to view their details.
From the right-side panel, check the Actions log and Processes boxes to see these sections.
The Actions log section displays details including who created the action, when it occurred, status changes, and the action performed (activated or inactivated).
The Processes section shows information about who initiated each process, when it started, the process ID, type, status, and reason.
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:
Go to Persons > Search.
On the Search persons page, fill in the relevant parameters.
You can enable Advanced search to access additional filters, allowing for a more granular search and narrowing down the results.
When you click Search, a list of persons is displayed, showing identification numbers, names, e-mail addresses, and other relevant details.
Click the person's name to view their details.
This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).
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
See the Risks section below:
To remove users in organisational unit, follow these steps:
Go to Administration > Access management > Organisation.
Click the Unit code to open the details page.
Go to Users tab and click Delete next to the name of the role that needs to be removed.
The Confirmation modal opens.
Click Confirm to proceed, or Cancel to discard.
To create a new organisational unit, follow these steps:
Go to Administration > Access management > Organisation.
On the Organisational units page, click Add.
The New organisational unit page opens.
, then click Create.
Before you can use the account product feature, the Tuum team must first enable it. Customers currently using the Account Parameter Rule functionality need to complete all required preparations prior to transitioning to the account product solution.
Users can verify that the setting is enabled after account migration by following these steps:
Go to Administration > Settings > System properties.
From the content menu, choose account-api.
From the list of rules, find the USE_ACCOUNT_PRODUCT code.
Check if its value is set to Yes.
Once USE_ACCOUNT_PRODUCT is set to Yes, the value of USE_ACCOUNT_PARAMETER_RULES is ignored.
This page allows you to view and update key information related to a person.
From this page, you can:
Use the Search account products page to search and filter available account products.
To search for an account product, follow these steps:
Go to Accounts > Products > Account products.
On the Account products search page, enter the desired search parameters and click Search.
The search results include many columns that may not fit on your screen. To choose which columns are shown first, click Settings to customise the visible columns.
Click the Product code to view the account product details.
The Account product details page opens.
To delete a user, follow these steps:
Go to Administration > Access management > Users.
In the list of the users, click the Technical ID of the user that needs to be deleted.
On the User details page, click Delete user.
The Confirmation modal opens.
Click Delete to confirm, or Cancel to discard.
To create a new role, follow these steps:
Go to Administration > Access management > Roles.
On the Roles page, click Add.
To add or view a person's comments, follow these steps:
whose comments you want to view or add.
Click the person's name to view their details.
From the right-side panel, check the
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).
This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).
For information on generic terms and functions of custom fields in the Tuum system, please refer to the 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:
To edit a person's data, start with these steps:
whose status you want to change.
Click the person's name to view their details.
The person details page opens.
The following table presents the available account types in the Tuum system and their corresponding features.
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:
This operation opens a new savings account linked to an existing customer currency account. It can only be completed through internal API requests and is not supported in the Tuum BackOffice system.
For detailed instructions and usage, refer to the . However, we assume your organisation has set up a method for creating savings accounts, so you do not need to get into the specifics of the corresponding API call.
For currency accounts, Tuum can be configured in three ways:
Standard (Account type setup code: STANDARD enabled): The Tuum system generates account numbers.
External (Account type setup code:
To add users to an organisational unit, follow these steps:
Go to Administration > Access management > Organisation.
Click the Unit code to open the details page.
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.
There are two types of persons in the system:
You can add or view comments on the savings account for reference or internal use.
To view or add comments to the savings account, follow these steps:
you want to view or comment on.
Click the account number to open its details.
To set up a savings account, establish a connection between your savings account and an existing currency account. This involves configuring the savings account’s Account type interest method with parameters that match the Method assignment code, Account holder type, and Currency of the currency account. Once completed, the currency account will function as the servicing account for the savings account.
To create a new account type interest method, follow these steps:
For information on generic terms and functions of lookups in the Tuum system, please refer to the 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:
This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).
To add or view a person's external contracts, follow these steps:
whose external contracts you want to view or add.
Click the person's name to view their details.
From the content menu, click
These account application statuses apply if the Tuum configuration for accounts is .
This list of parameters applies only to the creation of a legal person.
Savings can be withdrawn from the savings account either partially or in full, depending on the account’s terms and available balance.
To withdraw savings from the savings account, follow these steps:
from which you want to withdraw savings.
Click the account number to view its details.
This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).
The Tuum system has two types of users:
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.
This explanation applies to the standard account configuration.
Follow the steps below to open a currency account without using an account application.
Go to Persons > Search for the person who needs to get an account created.
Use the block account feature to temporarily restrict access to savings accounts when required for security, legal, or risk management reasons.
To block or unblock the savings account, start with these steps:
you want to block or unblock.
Click the account number to open its details.
If a savings account is no longer needed by the account holder, or if the client relationship is ending, use the close account feature to permanently close it.
To close the savings account, follow these steps:
you want to close.
Click the account number to open its details.
This page provides a clear overview of the savings account operations, along with access to additional actions available for managing the account. The following actions are accessible from their respective pages:
A savings account is a type of account designed to help customers save money for specific goals while earning a higher interest rate. To open a savings account, you must have an existing currency account (called the servicing account) and provide an initial deposit. Multiple savings accounts can be linked to the same servicing account, allowing flexible goal management.
For more information, see the following sections:
Human health and social work activities;
Education.
Student;
Unemployed.
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.


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.


Part ownership;Private;
Rented.
Private house.

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.










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.












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.
Representing start date *
Select the start date of the representation.
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.





















Document copy;
Flow of funds;
Group structure chart;
Organisational structure chart;
Ownership structure;
Proof of address;
Registry extract.
























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.
Only Currency and Internal account types can be created via the BackOffice interface.
To create other types of accounts, use the create account API endpoint.
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.
Savings
This account is designed to help customers save for specific goals while earning a higher interest rate. To open one, customers need to have an existing currency (servicing) account and make an initial deposit.
Note: See more about savings 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
Organisational unit code *
Enter a unique organisational unit code.
Example: MB_UK
Organisational unit level
This field is automatically set to 1 when no Parent is selected. If a Parent is selected, the Organisational unit level is automatically assigned based on the Parent’s level.
Note: This field is read-only and cannot be edited manually.
Name *
Enter the name that corresponds to and describes the organisational unit code.
Example: UK branch
Telephone
Enter the phone number.
Enter a valid e-mail address.
Example: [email protected]
Street
Enter the street of the address.
City
Enter the city of the address.
State
Enter the state of the address.
Zip
Enter the ZIP code.
Country code
Select the country code.
Timezone
Select the time zone of the address.
Parent
Select an existing organisational unit from the list to assign it as the parent of the new organisational unit. If no Parent is selected, the organisational unit will be created at the top level.
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.
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


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.
Executive officer;Member of board;
Representative;
Shareholder;
Supervisory board member.
Additional relationships can be added by clicking Add .
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.


On the Role management page, enter the Role name and, if needed, provide a description.
Scroll the list of the grouped privileges. Click Expand to open available set of privileges.
Grant the Privileges by toggling On next to each privilege name.
To assign all privileges, toggle On the option next to Toggle all.
Click Submit 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 number of privileges.
To work with accounts and contracts, users must access the customer profile. For this reason, the privilege VIEW_PERSON is mandatory.


Click Add to add a new comment.
Enter your comment and click Save to apply it.
This is how the added comments will appear, with the most recent one shown first:
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.
Go to Persons > Settings > Risk types.
On the Risk types page, click Add .
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.
Go to Persons > Settings > Risk levels.
On the Risk levels page, click Add .
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.
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 add a risk when creating a person.
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.
From the content menu, select Person > Person.
Click Add field set.
The Create field set modal opens. Enter the Field set ID and Field set name.
Click Create to create new field set.
Find your field set on the Custom fields page to customise it.
Click Add field.
The Create field modal opens. Enter the required parameters and click Create.
The created fields will appear on the Custom fields page.
When you return to Persons > Create, you will see the custom field you created.
To edit a person's existing data in Details sections, follow these steps:
From the right-side panel, check the Details box to see the Details section.
Click Edit to change the existing details.
Edit the necessary parameters, then click Save to apply the changes.
To update a person's data in any section except Details, follow these steps:
Check the section navigator on the content sidebar to make the section data visible for editing.
Click the section navigator to navigate to the section where the data you want to change is located.
Follow the instructions provided in the Edit data item chapter.
EXTERNAL_VIRTUALHybrid (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.
Opening a currency account without an account application applies to standard configuration.
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.
Go to Users tab and click Add.
Select the user from the dropdown list, then assign a role by toggling On next to the role name.
When you are finished, click Save.
If you need to create a new user, refer to the User management section to learn more.


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:
The Account details page opens.
Click View/add comments at the top right of the page.
The Account comments modal opens.
View existing comments, if any, or add a new one by entering your comment and clicking Add comment.
If no comments exist, the added comment will appear in the modal; otherwise, your new comment will be added to the list of existing comments.
When you are finished viewing or adding comments, and have clicked Add comment if needed, click Close to exit the modal.
Find any currency account that you intend to use as the basis for the savings account.
On the Account details page, check the following parameters: Default currency, Person type, Interest method assignment code. These values must correspond exactly to the appropriate settings used when setting up the savings account.
Create a new account type interest method for savings accounts.
In the Interest method main settings section, enter values for Method assignment code, Account holder type, and Currency, ensuring they match the corresponding values assigned to the servicing account.
Select Savings as the Account type.
Set all other parameter values according to your requirements.
After completing all required fields, click Create new account type interest.
Alternatively, you can first create a new Account type interest method for currency accounts, followed by a separate interest method for savings accounts.
Once the interest method is created, proceed to open a savings account linked to any currency account which Account type interest method matches the configured settings.
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.
Select the lookup type from the drop-down menu.
Click the add icon to create new lookup codes. The example below shows the PERSON > FINANCIAL DATA page.
The Create new lookup modal opens.
Enter the lookup code and add the translations.
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.
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.
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.
Click Add external contract to create a new contract.
The External contracts modal opens.
Complete the required fields and click Create to add the contract.
This is how the created external contract will appear:
Checking the Show history box will display the validity range.
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
The Account details page opens.
Click Withdraw savings at the bottom left of the page.
The Withdraw money from the savings account modal opens.
Enter the withdrawal amount and click Withdraw.
Withdrawn funds will always be deposited into the currency account that is used as the servicing account. If the savings account is blocked, you will not be able to withdraw funds or top up the account.
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:
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
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.
Tuum has a unique system user with the username modular.system. The system reserves this user for maintenance purposes. Tuum customers should not modify or use this user.
To enable a new user to perform tasks within the Tuum system, follow these three steps:
Assign roles to restrict a user's permissions to perform authorised tasks.
Set up credentials to enable secure access to the Tuum system.
Below you can find more details about each step.
To create a new user:
Go to Administration > Access management > Users.
On the Users page, click Add.
Only users with the MANAGE_USERS privilege can add new employees to the BackOffice.
Enter the user details. The username and email must be unique within the Tuum system.
Select required roles. To assign a role, toggle On next to the role name.
If you are creating a BackOffice user, do not assign the System role to the user.
If you are creating an API user, assign the System role to the user.
Click Submit to complete the creation of a new user.
If you need to create a new role, refer to the Role management section to learn more.
Fill in search parameters > click the Search button.
Click on the person’s Identification number to view the Person details.
Once on the Person details page, go to the content menu Accounts > Accounts.
On the Accounts page > click the Create account button.
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.
The Account details page opens.
To block or unblock the savings account, follow the specific instructions for each section.
Click Block account at the top right of the page.
The Block account modal opens.
Select a reason for the status change from the dropdown menu, add a comment if needed, and click Yes to confirm blocking the savings account, or No to cancel the action.
If the savings account is blocked and you wish to unblock it, click Unblock account at the top right of the page.
A confirmation modal opens.
Add a comment if needed, then click Yes to confirm unblocking the savings account, or No to cancel the action.
The Account details page opens.
Click Close saving at the top right of the page.
A confirmation modal opens.
Click Yes to confirm closing the savings account, or No to cancel the action.
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 .


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
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.
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.
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.
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 chapter for an illustrative example.
The section navigators on the content sidebar present a comprehensive list of distinct content sections. Each item in this list serves a dual purpose:
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.
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.
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.
Check the box next to Show history to display past records, if any are available.
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 to make a hidden column visible.
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.
You can adjust how many items are shown per page:
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.
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.
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.
To edit a data item, click Edit, make the necessary changes or select a different option, then click Save to apply your updates.
To delete a data item, click Delete.
Review the confirmation modal below, then click Confirm to proceed or Cancel to stop the deletion.
This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).
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.
See the Person details section below as it appears when creating a private person:
To create a new private or legal person in Tuum BackOffice, follow these steps:
Go to Persons > Create.
On the Create new person page, a list of configurable parameters is displayed.
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.
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 .
Modifying user roles means assigning or removing them. To do that, follow these steps:
Go to Administration > Access management > Organisation.
Click the Unit code to open the details page.
Go to Users tab and click Edit next to the user whose roles you want to update.
You can:
Assign a role by toggling On next to the role name.
Remove a role by toggling Off next to the role name.
There are several ways to fund a savings account, each suited to different needs, from regular automated deposits to single manual transfers. The following provides an overview of the available options for funding a savings account:
To find out more about each option, refer to the particular chapter below.
The primary method for funding a savings account is by setting up a recurring deposit schedule (e.g. monthly on a specific date). This automates the transfer of a fixed amount from the linked currency account to the savings account at the specified frequency.
This operation can only be completed through internal API requests and is not supported in the Tuum BackOffice system.
For detailed instructions and usage, refer to the . However, we assume your organisation has implemented a method for setting up recurring transfers, so you do not need to get into the specifics of the corresponding API call.
The top-up function allows for flexible transfers from the linked currency account to the savings account. It can be used to make the initial deposit during account creation, as well as any subsequent manual contributions as needed.
To top up the savings account, or add funds, follow these steps:
to which you want to top up savings.
Click the account number to view its details.
The Account details page opens.
The Top up savings account modal opens.
Enter the top-up amount and click Top up.
You can also transfer funds from another financial institution via a standard bank transfer. Use the savings account number as the recipient and the account holder's name as the beneficiary. Other details may vary depending on the payment context.
It is also possible to make a manual custom booking into the savings account. However, this method is considered an exception and should only be used when necessary. For detailed instructions, refer to .
This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).
Document type *
Select the type of document. These values can be defined on the PERSON.DOCUMENT lookup page. For more information, see .
Example values include:
Driver’s licence;
ID card;
Number *
Enter the document number.
Issuing country *
Select the issuing country of the document.
See the Documents section below as it appears when creating a private person:
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:
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.
Account product marks a shift away from a technical, finance-driven account parameter rule setup toward a more business-centric account configuration model. It replaces complex technical field combinations with a clearer configuration structure and decouples account configuration from finance-oriented account class codes.
The account is now directly linked to a unique product code, making it clear which rules apply to the account throughout its lifecycle. Previously, each account parameter rule was uniquely identified by multiple parameters—person type, account type, jurisdiction country, and class code. These parameters could be filled or empty and could change on the account, adding complexity and making it unclear which rule was actually valid.
Account class codes can now be changed without affecting account configuration. Previously, changing or clearing the class code could unintentionally change the account parameter rule, because they were directly linked, causing the class code to control which attribute values were allowed on the account instead of serving only its intended financial configuration purpose.
Customers using the Account parameter rule functionality must transition to the newer and more flexible Account product solution. For more information on migrating from Account parameter rule to Account product, contact the Tuum team. To learn more about enabling the Account product feature, see .
The Create account product page lets you set up a new account product in two steps:
Create a draft account product, which is fully editable but not yet usable.
Confirm the draft account product to make it usable and only partially editable or delete it.
To create an account product, follow these steps:
Go to Accounts > Products > Account products.
On the Account products search page, click Add in the upper-right corner.
The Create new product page opens.
, then click Submit.
While an account product is in Draft status, you can . To find account products in Draft status, see .
After submission, you can either:
Click Confirm to activate the account product.
Click Delete to delete the account product.
If you click Confirm, a confirmation modal opens. Enter a comment if needed, then click Confirm to activate the account product, or Cancel to go back.
If you click Delete, a confirmation modal opens. Click Confirm to delete the account product, or Cancel to discard the action.
These account application statuses apply if the Tuum configuration for accounts is Standard or Hybrid.
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.
The explanation below applies when you have selected the EXTERNAL_VIRTUAL as the Account setup type when creating the account application.
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.
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.
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.
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 .
The explanation below applies when you have selected STANDARD as the Account setup type when creating the account application.
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.
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.
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.
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 .
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.
On the Savings account details page, you can get an overview of the savings account details and balances.
On the Savings account details page, you can view key information including the Account details and Savings details sections, as well as your account numbers and current balances.
To view Savings account details page, follow these steps:
This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).
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.
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:
As savings accounts are always connected to servicing accounts, you may occasionally need to quickly identify this relationship. This section explains how to find related accounts in Tuum, specifically how to locate a savings account from a servicing account, and vice versa.
To find a savings account from the servicing account details page, follow these steps:
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.
















































































































Work;
Home;


To confirm the changes, click Save.






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.
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 Person groups.
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.




Passport;
Residence permit.
Additional documents can be added by clicking Add .
Expiry date
Enter the document's expiry date.
Format: DD.MM.YYYY
File *
Click the upload icon to upload the file.


Search for the person whose status you want to change.
Click the person's name to view their details.
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.
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.
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.
You must inactivate a person when you intend to close that person's record in the Tuum system.
Click Inactivate on the content sidebar, located on the right side of the content area.
The Close customer modal opens.
Select the reason for inactivation and the inactivation date.
Add a comment if needed.
Click Submit to apply the changes.
The person's record now shows a note with the inactivation date.
You must reactivate a person when you intend to restore an inactivated person's record in the Tuum system.
Click Reactivate on the content sidebar, located on the right side of the content area.
The Reactivate person modal opens.
Select the reason for reactivation and the reactivation date.
Add a comment if needed.
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.
You must forget a person when you intend to permanently delete an inactivated person's record in the Tuum system.
Click Forget on the content sidebar, located on the right side of the content area.
The Forget person modal opens.
Select the forget Reason and the Forget date.
Add a comment if needed.
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.
Find the required account.
Open the account view page by clicking on the account Account number.
The Savings account view page has five sections:
The header section of the Savings account view page starts with the title, followed by action buttons for savings account management and links for reviewing related activity.
Three action buttons available in the header section allow you to perform specific actions:
View/add comments - allows viewing existing comments or adding new ones. See the View or add comments section for more details.
Block account - allows temporarily setting the savings account to blocked status. See the Block or unblock the savings account section for more details.
Close saving - allows closing the savings account. See the Close the savings account section for more details.
Close saving - is an irreversible action. Once a savings account is closed, it cannot be reopened.
At the end of the header section on the Savings account view page, you can find three links that provide an overview of various savings account-related activities:
4eye review processes - to view the savings account-related review processes.
Actions log - to view the savings account-related actions.
Account processes - to view the savings account-related processes.
The Savings account details section provides a comprehensive overview of savings account-related parameters. It includes two parameters that you can modify:
Click Edit next to the Interest method assignment code parameter value to change the Interest method assignment code.
Click the Open modal link next to the Custom fields parameter to manage the savings account-related custom fields.
The Savings details section provides a clear summary of key information related to the savings account. This section is read-only and allows you to view essential details about the savings setup, including the savings plan, schedule, and progress. It helps you quickly understand the structure and current state of the savings without requiring any actions.
The account numbers section lists all alternative account number sets for different use cases, such as domestic payment schemes. For standard account types (which include savings accounts), only alias account numbers can be added. You can add a new account number by clicking Add.
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.
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.
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 .
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:
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.


Confirmation of the account application initiates the account opening process. Depending on the account setup type, the account will be assigned either an externally provided or internally generated account number.
Follow the steps below to open a currency account using the account application.
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.
Create an account application for a person:
From the person content menu, choose Account > Account applications.
Click the Create application button.
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.
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.
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.
Click Submit to complete the creation of the account application.
You must confirm the account application to start the account opening process.
After clicking Submit, Tuum creates a draft account application with the status INSERTED. You can edit or cancel the draft application until you confirm it and start the account opening process.
Click Edit to change the account application details and click Save to preserve the changes.
You must confirm the account application to start the account opening process.
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.
On the Related accounts page, click the Saving accounts tab.
Click on the account number to open the Savings account details page.
To find a servicing account from the savings account details page, follow these steps:
From the content menu, select Related accounts.
On the Related accounts page, click the Saving servicing account tab.
Click on the currency account number to open the Servicing account details page.























Account type*
List
Select the account type:
CURRENCY,
INTERNAL,
VIRTUAL.
Account holder type*
List
Select the person type:
Private,
Legal.
Account class
List
There are two ways to change a user's password:
The BackOffice admin can reset a user's password.
The user can reset their password themselves.
To change a user's password as a BackOffice admin, go to:
Administration > Access management > Users.
In the list of the users, click Technical ID of the employee whose password you need to reset.
On the User details page, scroll down to the Password section.
Enter the New password and Confirm password.
Click Change to save the changes.
The BackOffice user can reset their password in two ways:
Using the when not logged in.
Accessing their when logged in.
If the BackOffice user has forgotten their password, they can initiate a password reset via the login page.
On the login page, click the Trouble signing in link.
On the password reset page, enter your email address.
Click Reset Password.
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.
If a BackOffice user is logged in, they can change their password from the user profile page.
Click the user profile icon in the top-right corner of any BackOffice page.
Click Settings, which is opened in the same location, to navigate to the User details page.
On the User details page, scroll down to the Password section.
Enter the New password and Confirm password.
Click Change to save the changes.
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.
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:
Administration > Settings > System property.
From the content menu, choose account-api.
From the list of rules, find the USE_ACCOUNT_PARAMETER_RULES code > click the sign to update the system property.
Accounts > Settings > Account parameter rule.
On the account parameters page, click the Create rule button.
Fill in the > 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.
Once a new account rule is added, it appears on the account parameter rules page:
Accounts > Settings > Account parameter rule.
Accounts > Settings > Account parameter rule.
Click the in front of the rule that you want to modify.
Update the parameter rule > Save.
You can modify the following rule parameters:
Currencies,
Residency countries,
Accounts > Settings > Account parameter rule.
Click the cross sign in front of the rule that you want to disable.
Select the invalidate from date > Invalidate.
This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).
Financial data type *
Select the financial data type. Available options for a private person are:
Assets;
Expenses;
Financial data value type *
Select the financial data value type:
Currency;
Number;
Period *
Enter the duration of the period in months.
See the Financial data section below:
Editing an active account product means changing one or more of its parameters, such as the currency or class code.
After you make a change, the new parameter values apply only to accounts opened under this product from that point onward. Accounts opened before the change continue to use the parameter values that were in effect when they were created.
In an active account product, editable sections are indicated by an edit icon. Click Edit to open a detailed view of the section, where you can modify the available parameters.
To edit a section, follow these steps:
This list of parameters applies only to the creation of a private person.
CHANGE_PERSON_DOCUMENT
CHANGE_PERSON_PERSONAL_INFO
CHANGE_PERSON_STATUS_CODE_REASON
CHANGE_LEGAL_ENTITY_IDENTITY
CREATE_PERSON_CUSTOM_FIELD
CREATE_PERSON_CUSTOM_FIELD_VALUE
CREATE_PERSON_DOCUMENT
CREATE_PERSON_LOOKUP
DELETE_PERSON_GROUP
DELETE_PERSON_GROUP_TYPE
DELETE_EXTERNAL_CONTRACTS
DELETE_FINANCIAL_DATA
DELETE_LEGAL_ENTITY_IDENTITY
FORGET_CUSTOMER
INACTIVATE_CUSTOMER
CLOSE_REPRESENTATIVE
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
VIEW_RISK_TYPE
MANAGE_RISK_LEVEL
MANAGE_RISK_TYPE
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.


































































Change the system property value to Yes.
Tax residency countries,
Interest method assignments,
Customer groups,
Validity range from,
Validity range to.
















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 .
Currency range;Number range.
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.


Find the account product in question.
On the Account product details page, scroll to the relevant section and click Edit.
The sections you can edit are the following:
You can edit the product name, description, reporting product code, and the validity range. After making your changes, click Save.
You can enable or disable contractual overdrafts. After making your changes, click Save.
You can edit the allowed residency country codes and the allowed tax residency country codes. After making your changes, click Save.
You can edit the list of allowed currencies and the default currency code. After making your changes, click Save.
You can enable or disable all class codes, or select specific ones and set a default. After making your changes, click Save.
You can enable or disable all interest method assignment codes, or select specific ones and set a default. After making your changes, click Save.
You can edit the allowed and default price list customer groups selections. When a default price list customer group is selected, you can also choose a default price list type code. After making your changes, click Save.
You can edit or add the BIC key and select a numbering sequence key. After making your changes, click Save.
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 . Example values include:
Higher education;
Not available;
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 . Example values include:
Cohabitant;
Complicated;
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;
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.
See the Additional info section below as it appears when creating a private person:
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
There are two types of address formats: unstructured and structured.
The unstructured address is a non-standardised and less detailed representation of the address.
The structured address 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 (*).
See the Unstructured address format below:
See the Structured address format below:


































Primary;
Secondary;
Vocational school.
Divorced;
Married;
Single;
Widowed.
General governments;Households;
Non-financial corporations;
Other financial corporations.








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




Address line 1 *
Floor
Account type setup
/service provider code
/account type*
List
The same parameters apply to setting account limits for representatives.
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.
Country*
List
Select the account country from the list.
Currency code*
List
Select the account currency from the 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.
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.
Financial institution id type*
Jurisdiction country *
Jurisdiction country where the bank operates and the product is valid.
Banking mode *
Banking mode under which this product operates.
Available options are:
Conventional
Islamic
Product code *
Unique product code written with capital letters and underscores.
Example: MY_FIRST_ACC_PRODUCT
Product name *
Product commercial name.
Product description *
Product internal description.
Reporting product code *
Reporting product code to which this product is linked. The reporting product code represents the category of a product or service used for management reporting purposes through the whole platform.
Validity range from
The start date from which the product becomes available for use in new account creation or product changes.
Validity range to
The end date after which the product is no longer available for selection. Once this date is reached, the product is deactivated; however, existing accounts using the product remain valid.
Account type *
Specifies the account type for which this product is valid.
Account holder type *
Specifies the type of account holder for which this product is valid.
Allow contractual overdraft
Indicates whether contractual overdrafts are allowed for accounts created under this product.
Note: This field is displayed only when the account type is set to CURRENCY.
Allow joint accounts
Indicates whether multiple owners are allowed for accounts created under this product.
Note: This field is displayed only when the account holder type is set to Private and account type is set to CURRENCY.
Account type setup
Defines the configuration specific to the account type for this product. If left empty, no account type–specific restrictions apply.
Service provider
Defines the account service provider code for this product. If left empty, no service provider–specific restrictions apply.
Residency country codes
List of allowed residency country codes for accounts created under this product. If left empty, all ISO country codes are permitted.
Tax residency country codes
List of allowed tax residency country codes for accounts created under this product. If left empty, all ISO country codes are permitted.
Allowed currencies
List of currencies in which balances are allowed for accounts created under this product. If left empty, all currencies supported by the Account module are permitted.
Note: Attempting to create a balance in a currency not on this list will result in an error.
Default currency code
Specifies the default currency code used when opening an account under this product via the UI. If provided, it must be included in the Allowed currencies list. If Allowed currencies is empty, the value must be one of the currencies supported by the Account module.
Note: This field is not used for validation or defaulting during account creation.
Auto-create allowed currency balances
Indicates whether balances in all allowed currencies should be automatically created when a new account is opened under this product. If enabled, the system will initialise one balance per allowed currency at the time of account creation.
Allow all class codes
Indicates whether all account type–related class codes are allowed for accounts created under this product. If enabled, both Class codes and Default class code must be left empty.
Class codes
Class codes allow deposits, overdrafts, fees, and other items to be mapped to GL accounts more specifically than the account type alone. This is the list of class codes allowed for accounts created under this product.
If left empty:
When Allow all class codes is set to No, no class codes are allowed.
When Allow all class codes is set to Yes
Default class code
Specifies the default class code used when opening an account under this product via the UI. If provided, it must be included in the Class codes list.
Note: This field is displayed only when the Allow all class codes toggle is set to No. This value is not used for validation or defaulting during account creation.
Link to class codes
The link provides access to the full list of Account class code rules and allows new class codes to be added if needed. To learn more, see .
This section is visible when the banking mode is selected as CONVENTIONAL.
Allow all interest method assignment codes
Indicates whether all interest method assignment codes valid for the given organisational unit, account type, person type, and currency are allowed for accounts created under this product. If enabled, both Allowed interest method assignment codes and Default interest method assignment code must be left empty.
Allowed interest method assignment codes
The list of interest method assignment codes allowed for accounts created under this product.
If left empty and Allow all interest method assignment codes is disabled, no interest will be calculated.
If left empty and Allow all interest method assignment codes is enabled, all applicable interest method assignment codes from the relevant account type interest methods will be allowed.
Note: This field is displayed only when the Allow all interest method assignment codes
Default interest method assignment code
The default interest method assignment code used when opening an account under this product via the UI. If specified, it must also appear in the Allowed interest method assignment codes list.
Note: This field is displayed only when the Allow all interest method assignment codes toggle is set to No. This field is not used for validation or defaulting during account creation.
Link to interest methods
The link provides access to the Account type interest methods and allows new interest methods to be added if needed. To learn more, see .
Allowed price list customer groups
The list of allowed price list customer group codes for accounts created under this product. If not specified, all customer group codes defined on the ACCOUNT.PRICELIST lookup page, with CUSTOMER_GROUP selected as the lookup type, are allowed.
Default price list customer group
The default price list customer group code used when opening an account under this product via the UI. If specified, it must be included in the Allowed price list customer groups list.
Note: This field is not used for validation or defaulting during account creation.
Default price list type code
The default price list code used when opening an account under this product via the UI. It can be specified only if a Default price list customer group is provided, and must belong to one of the price lists under that group.
Note: This field is not used for validation or defaulting during account creation.
Link to customer groups
The link provides access to the full list of Account price list lookup codes and allows new lookup codes to be added if needed. To learn more, see .
Link to price list
The link provides access to the full list of Fee price lists and allows new price lists to be added if needed. To learn more, see .
BIC key
Specifies the BIC to be assigned to accounts created under this product.
Note: This field is optional and may be left empty.
Numbering sequence key
Specifies the numbering sequence to be used for accounts created under this product.
Note: This field is optional and may be left empty.
Link to BIC allocation rules
The link provides access to the full list of BIC allocation rules and allows new rules to be added if needed.
Link to numbering sequences
The link provides access to the full list of Numbering sequences and allows new numbering sequences to be added if needed.
Link to GL accounts configuration
The link provides access to the GL accounts setup for account component rules and allows new rules to be added if needed.
Organisational unit *
Organisational unit under which this product is defined.
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.
Note: This field is displayed only when the Allow all class codes toggle is set to No.
No