Bank Accounts

1. In the Main Information section, select the Banking Product Type from the available list.

   NOTE  
   If you choose to create banking products directly from the product category level, then Banking Product Factory automatically fills in the information inherited from the product category: banking product type, code, class, subclass, and other elements, such as currency, start and end date.

2. The Currency is automatically completed from the default value defined within the DefaultCurrencyBankingProduct Banking Product Factory system parameter. You can change it for the newly created product by selecting another currency from the drop-down list.

3. Banking Product Factory automatically generates the code based on the code of the product type + a sequencer. For example, the TLU854 code corresponds to a banking product based on an Unsecured Loan product type. You can modify the product code in the Banking Product Code field. It can have 10 characters.

4. Set the product validity by selecting the date when the product becomes available (Start Date) and the last date from when the product is available (End Date).

5. Enter the product Name.

6. Optionally you can set the following fields:

   • External Code: Select the code of the product imported from an external system, if applicable. It can have 10 characters and it is not used in the contract.

   • Description: Enter any description or additional text related to your new product.

   • Class, Subclass, Category, and Subcategory: Select the desired values to set the desired hierarchy for your product. For more information, see Product Hierarchy

7. Click the Save and Reload button. The product is now saved and you can further edit it for your needs.

After saving the product, the Product Classification section is populated with more options for your product. You can insert or remove existing product classification items.

1. To add a product classification item, click Insert Existing and select an already existing item.

   

2. You can also create a new product classification item by clicking the Insert existing button and then the Insert button.

3. On the newly displayed Add Product Classification page, fill in the fields:

   

   • Name: Enter the name of the classification item.

   • Code: Enter the unique code of the classification item.

   • Valid From: Select the date from which the product classification item is valid.

   • Valid To: Select the date until when the product classification item is valid.

   • Classification Type: Choose the classification type of the item. Possible values: Regulatory, Restructuring.

   • Is Default: Select the checkbox if this classification item is default.

   The Classified Banking Products section is displayed after you save the classification item record and allows you to insert existing banking products. The following information is displayed here: Code, Name, Class, SubClass, Category, SubCategory and Status.

   For more information on how to create a new product classification, see Banking Product Classification.

4. Click the Save and Reload button.

1. Fill in the following fields:

   • Minimum Period and the Maximum Period: Enter the minimum and the maximum duration of the product mentioned in the contract.

   • Minimum Amount and the Minimum Amount: Enter the minimum and the maximum amount of the product for which the bank opens a contract.

2. Click the Save and Reload button.

In the Availability Rules section you can select the item filters for your banking product.

1. Click the Insert button, the Add Product Availability Item Filter is displayed.

2. Select the desired filter from the Filter option.

3. Add the attributes of the selected filter.

4. Optionally, add a description for the added item filter.

5. Click the Save and Reload button.

For more details, see Product Filter.

In the Product Covenants section you can set certain conventions that applicants must abide by after getting the loan. This is usually applicable for corporate clients that must meet certain requirements in order to continue to receive disbursements.

1. Click the Insert button to add a covenant to the product. Each covenant can be attributed a value, an availability period, and a review frequency in months. Read more about covenants in the Covenant page.

2. Click the Save and Reload button.

1. To add an interest or a commission, click Insert in the Interest & Commissions section. The Add Interest & Commission Item page is displayed.

2. Select the banking product from the Banking Product list.

3. Enter the Item Name.

4. Enter the Start Date when the interest/ commission becomes effective and the End Date for the interest/ commission.

5. Fill in the following fields:

   • Code: Enter a code for this particular interest/ commission.

   • Interest List: Select from which list the interest is a part of.

   • Commissions List: Select from which list the commission is a part of.

   • Minimum Interest Rate (%): Enter the percent applicable as a minimum interest rate at the contract level.

   • Is Negotiable: Select the checkbox to specify that every interest, commission or margin field at the contract level is negotiable and can be edited.

6. Click the Save and Reload button.

7. In the Interest & Commission Item Filters section, click Insert to insert an item filter.

8. Select a filter created earlier in the Product Filter.

9. Set the following fields:

   • Value/ Date: Select the beginning value/ date for the filter.

   • Until Value/ Until Date: Select the maximum value/ date for the filter.

   • Description: This field is automatically filled in after clicking the Save and Reload button. The values/ dates inserted above are turned into an expression.

   For Lookup attributes, the following fields are available:

   • Filter Entity: Entity on which the filter was defined.

   • Description: It is left blank. Add a description if needed.

   • Grid of Options: This field is automatically filled in after clicking the Save and Reload button. The values of the option set are displayed. Select the Boolean for the values you wish to include in the filter.

10. Click the Save and Reload button.

For any banking product, you can select a pre-existing insurance or create a new one.

1. To add a new insurance, in the Insurances section, Click the Insert button and set the following fields:

   • Banking Product: Select the banking product.

   • Code: Insert a code for this particular insurance.

   • Item Name: Insert a name.

   • Start Date: Enter the start date when the insurance becomes effective.

   • End Date: Enter the end date for the insurance.

   • Details: It is left blank. Add a description if needed.

   • Insurance List: Select from which list the insurance is a part of.

2. Click the Save and Reload button.

3. In the Insurance Item Filters section, click Insert and fill in the following fields:

   • Filter: The name inserted earlier.

   • Value: The starting value for the attribute.

   • Until Value: The ending value of the interval.

   • Description: Insert the proper description for the availability filter.

4. Click the Save and Reload button.

   

For any banking product, you can add discounts of any nature. You can select a pre-existing discount or create a new one.

1. To add a new discount, Click the Insert button in the Discounts section.

2. In the Details Page, insert the appropriate Name for the discount.

3. Choose one of the pre-configured types of discounts available in the Discount field, or create a new one. According to the selected type, new fields appear on the page requiring to be filled in.

4. Insert the value of the discount to be applied, e.g. 15.

5. Set the start date when the discount becomes effective (Start date), and the end date for the discount (End date).

6. Optionally, you can fill in the following fields:

   • Applied to dimension: Specifies for which product dimension this discount is applicable (interest, commission or insurance). This is autocompleted by the selected discount's dimension.

   • Commission type: This field appears if the selected Discount = Commission discount or Management Fee Discount. Specifies for which commission type this discount is applicable. This is autocompleted by the selected discount's default commission type.

   • Commission: This field appears if the selected Discount = Commission discount or Management Fee Discount. Specifies for which commission this discount is applicable. This is autocompleted by the selected discount's default commission.

   • Insurance class: This field appears if the selected discount = Discount Life Insurance or Interest Discount. Specifies for which insurance class this discount is applicable (credit, home, life or other insurance class). This is autocompleted by the selected discount's insurance class.

   • Insurance: This field appears if the selected discount = Discount Life Insurance. Specifies for which insurance this discount is applicable. This is autocompleted by the selected discount's insurance.

   • Interest type: This field appears if the selected discount = Interest discount. Specifies for which interest type this discount is applicable.

   • Use Banking Formula: If you select this checkbox, the discount is calculated using the Banking Formula engine.

   • Is optional discount? : Selecting this checkbox results in the discount being applied only if the customer agrees to the discount.

   • Is percentage: If you select this checkbox, the discount is calculated as a percentage from the contract's amount.

   • Destination entity: Select the entity where to register the discount. This field opens when the Is optional discount? checkbox is selected.

   • Destination entity attribute: Select the attribute where to register the discount. This field opens when the Is optional discount? checkbox is selected.

7. Click the Save and Close button.

8. In the Product Discount Item Filter section, click Insert and fill in the fields as specified in the Product Filter page. The fields displayed depend on the selected filter.
   

   For example, you can define a filter based on a formula:

   

   In this case, select a filter based on a formula from the list of already existing draft of approved formulas. After selecting the formula, select its mapping or enter the formula input JSON.

9. Click the Save and Close button.

You can choose one or more questions to add to the banking product, or insert a new one.

1. To insert a new question, in the Questions section, Click the Insert existing button, then click Insert.

2. In the Add Banking Product Question page, fill in the following fields:

   • Question: Enter the appropriate name.

   • Answer Type: Select the type of answer the customer has to give: text, numeric or option set.

   • Answer Entity: Select the entity where the answer is stored.

   • Answer Field: Select the attribute where the answer is stored.

3. Click the Save and Reload button.

The Banking Products List shows where the question is used.

4. Click the Save and Close button.

For example, this is how a question is displayed in a customer journey in the FintechOS Portal:

In the Banking Product Formulas section, choose an already defined formula or click Insert to configure a new one, for example a formula for eligibility or scoring purposes. For information on how to build a formula, see Define Formula Inputs.

1. In the Add Banking Product Formula page, fill in the following fields:

   

   • Name: Enter an appropriate name.

   • Formula Type: Select the type of formula configured before, e.g. scoring /eligibility.

   • Formula: Select the previously configured formula.

     IMPORTANT!  The formula must be activated before attaching it to a product.

   • Data Mapping: Select the previously configured data mapping.

   The name of the banking product is inserted automatically in Banking Product.

2. After selecting the desired formula, click Save and reload, then click Map Data.

3. In the Formula Mapping page, click Input and configure the input data for the formula.

4. Click Output and configure the output for the formula.

   

5. Click the Save and Close button.

   Such formulas can be used in customer journey steps, for example when the customer inserts their financial data.

   

The Banking Product Underwriting section at the bottom of the page holds the formulas associated to this product which are used in underwriting. The section only displays the formulas that are added through API integration. To view the information available about such a formula used in underwriting, follow these steps:

1. Double-click a formula in the Banking Product Underwriting section. The Edit Banking Product Formula page is displayed.
   

2. View the following information about the formula used for underwriting, attached to the current product: banking product name, formula name and scope, name and external id of the record, as they were added through API integration.

3. You can't edit any of the information.

Any previously associated documents are displayed in the Banking Product Documents section.

1. To attach a new document to the banking product, in the Banking Product Documents section, click Insert. The Add Banking Product Document page is displayed.

   

2. Set the following fields:

   • Operation Code: Enter a code for the document.

   • Banking Copies: Insert the number of copies made.

   • Report: Select a document from the list.

   • Document Type: Select a document type from the list.

   • Is Mandatory: Select if the document is mandatory.

   • Includes Debtor: Select if the document includes the debtor.

   • Includes Coborrower: Select if the document includes the co-borrower.

   • Requires Signature: Select if the document requires to be signed.

   • Is accord: Select if the document represents the accord.

3. Click the Save and Reload button.

The agreements that a customer needs to go through are displayed in the Banking Products Agreements section.

1. To attach a new agreement to the banking product, in the Banking Products Agreements section, click Insert. The Add Banking Products Agreements page is displayed.

   

2. Fill in the following fields:

   • Agreements: Select an agreement from the list.

   • Banking Product: It is automatically filled in.

   • Code: Insert the corresponding code.

   • Is Mandatory: Select if the agreement is mandatory for the product.

3. Click the Save and Reload button.

For more information on how to configure a contract or an agreement, see the Digital Document Processor.

1. In the Self Bank Account Associated with the Product, for each banking product, you must select a reconciliation account, which is the bank account to be used for transactions, for money movements.

   

   NOTE  
   This account must have the same currency as the product, because the conversions are performed from and into this account.

2. Select a value for the Negative Value Treatment drop-down to specify how Loan Management treats situations when the funds of the reconciliation account associated with the banking product used in the contract would go below zero if a disbursement event would be approved. The possible values are:

   • Error - there is an error message displayed if the disbursement event that is being approved would result in a negative balance of the associated reconciliation account. The event can't be approved and the balance can't go below zero. Select this value if you want to block any transactions that would result in a negative balance of the reconciliation account associated to the banking product.

   • Warning - there is a warning message displayed if the disbursement event that is being approved would result in a negative balance of the associated reconciliation account. The event can be approved and the balance can go below zero.

   • NoMessage - there is no error or warning message displayed if the disbursement event that is being approved would result in a negative balance of the associated reconciliation account. The event can be approved and the balance can go below zero.

   NOTE  
   Loan Management also has a system parameter, ReconciliationAccountTreatment. That is a system-wide setting, applicable to events for contracts based on all banking products without a specified Negative balance treatment value. Loan Management takes into consideration the settings used at the banking product level (the Negative balance treatment field's value). Thus, if the value is specified at the banking product level, then that value takes precedence over the system parameter's setting.

If you associate the same reconciliation account to more than one banking product, then the setting selected in banking product A is applied for contract events based on banking product A, while for the banking product B, Loan Management would apply the setting selected at the level of banking product B.

In the Payment Allocation Settings section you can decide which allocation method should be used to determine the order in which credit items are prioritized when repaying loans, credit accounts, and so on. You can also define the grace period settings.

1. Fill in the following fields:

   • Payment Allocation Method: The payment allocation method represents the recovery order of amounts from payment notifications. Select a payment allocation method from the list.

   • Grace Days for Repayment: Insert the number of days for which the bank expects a payment without calculating penalty.

   • Penalty for grace period: If you select the checkbox, the penalty interest is applied on the loan contract without taking into consideration the grace period defined at contract level, being calculated for the difference between system date - due date, if the grace period passed and the customer didn't pay the due amounts. If you leave this checkbox unselected, the penalty interest is applied on the loan contract taking into consideration the grace period defined at contract level, being calculated for system date - due date + grace days for repayment.

   • Direct Debit Settlement Account: If you select the checkbox, the banking product has the automated settlement of repayment notification functionality (the payment allocation) turned on by default at the contract level. You can turn the automated settlement off either at the banking product level or at the contract level in Loan Management. Default value: true.

     NOTE  The automated settlement of repayment notification, or direct debit settlement account, is the functionality whereby, if funds are available on the settlement account and the contract has repayment notifications pending for recovery, Loan Management automatically uses the available balance up to full settlement of repayment notifications.
     In Loan Management, the automated settlement of Installment type repayment notification functionality (the payment allocation) can be turned on or off, thus allowing the financial institution to manage the contracts in case of blocked accounts and control the allocation of funds to outstanding notifications in case of need to impose a block on the settlement account, or manage the settlement of multiple loans from the same settlement account when short on funds and exceptional rules might apply.
     If the functionality is turned off, the contract is pending for manual allocation. You can turn it back on and leave Loan Management to allocate the funds according to its automated processes, using any funds that become available in the settlement account in order to cover pending notifications.

2. Click the Save and Reload button.

In the Mandatory Roles section you can add the roles of the participants that are mandatory to exist at the contract level for contracts based on this banking product. In other words, when creating contracts based on banking products with Merchant role in this section, you must add a customer with the same Merchant role as contract participant, otherwise, the contract cannot be approved. When Search Limit is selected for a role on a banking product, Loan Management checks if the contract participant with this role has an attached limit configured with a limit type associated to the same role, in this case Merchant Exposure.

1. In the Mandatory Roles section, click Insert and fill in the following fields:

   

   • Banking Product: The banking product for which you define mandatory roles. This is automatically completed with the current banking product.

   • Role: Select the role of the participants that are mandatory to exist at the contract level for contracts based on this banking product.

   • Search Limit: When Search Limit is selected for a role on a banking product, Loan Management checks if the contract participant with this role has an attached limit configured with a limit type associated to the same role.
     If you select a role not associated with a customer limit type in Loan Management, the Search Limit field becomes read-only and unselected.

2. Click the Save and Reload button.

In the Return Of Goods, you can define whether a contract based on the banking product can have Returned Amount or Goods transactions or not, and the specific conditions for these transactions. The Returned Amount or Goods transaction type can be used when a customer returns all or part of a loan or mortgage in a short while after contract creation, if the banking product was defined to allow such transactions. You can set up Return Fee type commissions, to return all or some of the claimed commission to the borrower.

1. Fill in the following fields:

   • Allow Return Of Goods: Select this checkbox if the contracts based on this banking product accept Return of Goods transactions. Default value: False. If selected, the Accepted Days For Return and Return Message fields are displayed, otherwise, these fields are not visible.

   • Accepted Days For Return: Specify the number of days after contract creation during which the return of goods transaction can be created and approved.

   • Return Message: Select the behavior of messages generated by Loan Management for situations when the Returned Amount or Goods transaction's approval date + the number of accepted days for return >= the current date. Possible values are taken from the Warning Error Treatment option set. According to the desired behavior, choose:

     • Error, if the transaction should not be approved and an error message should be displayed;

     • Warning, if the transaction can be approved, but a warning message should be displayed;

     • NoMessage, if the transaction can be approved without any messages.

2. Click the Save and Reload button.

In the Closing Contract Settings section, you can configure the default closure settings for contracts based on this banking product.

1. Fill in the following fields:

   • Buffer Close Days: Enter the number of days used as buffer before automatically closing the contract when the contract reaches maturity and its balance reaches zero. If Buffer Close Days > 0, then Contract Is Closed Automatically = False.

   • Close Real Time: If you select this checkbox, the contract based on this banking product is closed in real-time, when the contract reaches maturity and its balance reaches zero, without waiting for the end of day processes. If Close Real Time = True, then Buffer Close Days = 0 and Contract Is Closed Automatically = True.

   • Closing Is Flexible: If you select this checkbox, the closure details of the contract based on this banking product can be modified at the contract creation.

   • Contract Is Closed Automatically: If you select this checkbox, the contract based on this banking product is closed automatically at maturity, if the balance reaches zero. If Contract Is Closed Automatically = False, then Close Real Time = False.

2. Click the Save and Close button.

The write off functionality is intended for non-performing loans. Using the settings within this section, Loan Management can automatically write off non-performing loan contracts after their maturity day passes and the remaining value on the contract is under the specified threshold. Loan Management also allows you to perform write-off transactions, even if the remaining amounts on the contract are above the defined threshold. The write-off transaction takes the remaining amount from the specified internal write-off account and credits the loan account.

In the Write Off section, you can configure the default write-off settings for contracts based on this banking product.

1. Fill in the following fields:

   • Write Off Account: Select the financial institution's internal write-off account to be used for write-off transactions for contracts based on this banking product. The DefaultWriteOffReconciliationAccountBankingProduct Loan Management system parameter holds the internal write-off account defined for the system's default currency and automatically populates this field, but you can change the account according to your needs.

   • Write Off Threshold: Enter the maximum value of remaining amounts on the contract for Loan Management to perform automated write off after the contract's maturity day passes.

2. Click the Save and Close button.

Banking Product Factory automatically displays in the Allowed Transactions section the transaction types associated at the selected banking product type level. If you need to associate other transaction types with the selected banking product, follow these steps:

1. Click Insert existing and select the desired transaction types to be associated.

2. Double-click a selected transaction type to edit it.

   

3. In the Edit Transaction Type > Settings section, fill in the following fields:

   • Name: Enter the name of the transaction type.

   • Transaction Code: Enter the code of the transaction type.

   • Process Type: This field associates the process type with the transaction operation type, which makes the connection with the transaction motor of bank accounts. Select one of the processes defined within the system.

     NOTE   There is no integration at this point with a payment gateway.

   • Edit Form: Select the form used to edit this transaction type. You can choose only from the forms defined on the Contract Event entity.

   • Transaction Operation Type: The transaction operation type makes the connection with the transaction motor of bank accounts. Select one of the transaction operation types defined within the system.

   • Is System Transactions: If you select this checkbox the transaction is marked as being neither a credit of the account, nor an allocation of funds, but a transaction that does not influence other transactions within the account. System transactions are meant to be used only for accounting.

   • Is Automatic Transaction: If you select this checkbox here, then you cannot select it within the contract operations. The Is Automatic Transaction checkbox marks the transaction as automatic.

   • Real Time Process: This checkbox marks the transaction as to be processed in real-time. If selected, then the transaction is processed right away. If not selected, then the transaction is inserted as a bank account transaction queue record.

   • Only One Draft: If you select this checkbox, there can be only one record of this transaction type in Draft status created at the contract level.

   • Generate New Contract Version: This checkbox allows you to specify if a new contract version should be generated by this transaction type.

   • Commission Type: Select the commission type applicable for this transaction type. Return fee commissions are filtered out and can't be selected.

   • Return Commission Type: Select the return fee commission type applicable for this transaction type. Only return fee commissions can be selected.

   • Is Clawback Transaction: If selected, this checkbox marks the transaction as generating a clawback commission. The transaction type is to be used in third-party management invoicing activities. Default value: False.

4. In the Edit Transaction Type > Accounting Configurations section, fill in the following fields:

   • Generates Accounting Entry: Select this checkbox to create an entry in the Subledger. It generates records in the Accounting Entry entity.

   • OL Master Entity: Select the entity referenced by the accounting systems.

5. In the Edit Transaction Type > Purge Configurations section, fill in the following fields:

   • To Be Purged: This checkbox marks the transaction as purgeable. If you select it, you can purge or archive records in Draft status.

   • Purge Number of Days: Enter the default number of calendar days that a record can be kept in Draft status before it is purged. For additional information, see the Loan Management System Parameters page. This field is displayed only when To Be Purged = True.

   • Master Purge Entity: Select the master purge entity under which the draft records are. This field is displayed only when To Be Purged = True.

6. You can also edit the information in the Transaction Value Types, Transaction Item Accounting Configurations and Transaction Accounting Models sections. Read more details about Transaction Types in the Subledger User Guide.

7. Click the Save and Close button.

Transaction types typically used for bank accounts

• Top Up Account - If added at banking product level, the customer is allowed to make top ups at the contract level. When a top up transaction is recorded in a contract, at the next maturity date the customer receives the interest for the initial amount up until the top up date, plus the interest for the full amount (initial amount + top up amount) proportional from top up to payment date.
  This transaction type is automatically added in the Associated Transactions tab if Allow Top Ups was selected in the Details tab.

• Withdraw - If added at banking product level, the customer is allowed to make withdrawals at the contract level.
  This transaction type is automatically added in the Associated Transactions tab if Allow Withdrawals was selected in the Details tab.
  

• Transfer between my bank accounts - If added at banking product level, the customer is allowed to move funds between their accounts at the contract level.
  This transaction type is automatically added in the Associated Transactions tab if Allow Withdrawals was selected in the Details tab.

• Accruals and Provisions - System transaction. If added at banking product level, the accruals and provisions for contracts can be calculated on a daily basis.
  This transaction type is not added automatically. Make sure you insert it in the Associated Transactions tab.

• Revert Transfer between my bank accounts - System transaction. If added at banking product level, transfers between the same customer's bank account can be reverted after being performed.
  This transaction type is not added automatically. Make sure you insert it in the Associated Transactions tab.

NOTE  
If you selected the Allow Top Ups and Allow Withdrawals checkboxes within the Details tab, then the Top Up Account, Transfer between my bank accounts and Withdraw transaction types are automatically attached in the Associated Transactions tab.

In the Product Features section, you can insert, delete or export features.

1. To add a feature, Click the Insert button and fill in the following fields:

   • Feature: Enter the name of the product feature.

   • Is Main Feature: Select the checkbox if it is the major feature.

   • Display Name: Enter the display name of the feature.

2. Click the Save and Reload button.

In the Product Destination Types section , you can insert or remove the existing product destination types:

1. Click Insert existing and select one of the existing destination types, or insert a new one.

2. To create a new destination type, insert a name and specify if it is default. For this case, the following have been configured: Loan Collateral, Loan disbursements, Personal, Repayments.

In the Associated Products section you can insert or remove an existing products. It is especially useful when you wish to create a link between two products.

To insert or remove a product from the list or create a new one:

1. Click Insert existing and select one of the existing destination types, or insert a new one.

2. Click the Save and Reload button.