‘Stakeholder’s Details’ Widget

Product Feature Guide

Table of Contents

Introduction

Stakeholder's Details' Widget Features & Functionality
Adding a Stakeholder
‘Stakeholder’s Details’ Widget Tabs

‘Overview’ Tab

Client ID

‘Contacts’ Tab
‘Addresses’ Tab
‘Compliance’ Tab
‘PAD’ Tab
‘Custom Fields’ Tab

Editing a Stakeholder’s Details

Reassigning a Customer Type

Deleting a Stakeholder

Introduction

The “Stakeholder Details” widget is used to manage the stakeholders associated with an application. These stakeholders typically include borrowers, guarantors, lawyers, brokers, third parties, and signing officers, amongst others. Applications ingested through POS systems will automatically assign stakeholders to their appropriate customer types, and sort their information into the relevant fields. The different tabs of the widget allow  the stakeholder’s details to be segmented by their general information, contact information, current/previous addresses, compliance information, and PAD information.

Location

The ‘Stakeholder’s Details’ widget is located within the application dashboard. By default, it is positioned at the bottom of the dashboard as the last widget.

'Stakeholder's Details' Widget Features & Functionality
Stakeholder Widget

Stakeholder List - The list of all stakeholders for a given application.

Stakeholder Icon - The black icon positioned to the left of a stakeholder's name. When you hover your cursor over it, a pop-up will appear, indicating the stakeholder's role.

Stakeholder Icon

Customer Types

Stakeholder-Icon1

  • 3rd Party
  • Agent
  • Lawyer
  • Power of Attorney (POA)
  • Signing Officer
  • Submitting Agent
  • Brokerage 

Stakeholder-Icon2

  • Borrower
  • Co-Borrower
  • Guarantor 
  • Director
  • Beneficial Owner


Stakeholder-Icon3

  • Company
 


Stakeholder Badges
- You can view assigned brokers in the “Team” section of the left sidebar menu, as well as in the Stakeholder widget.

  • Green Badge: This means the broker is approved within the ‘Broker Management’ section of the Manager Portal.
  • Red Badge: This means the broker is verified within the ‘Broker Management’ section of the Manager Portal, but they are not an approved broker. 
  • Orange Badge: This indicates that a broker is unverified. Brokers on the ‘Unverified’ list within the ‘Broker Management’ section of the Manager Portal can not be added as stakeholders to existing files. They will only appear if they submit an application, and their lack of verification will be flagged in the ‘Stakeholder’s Details’ widget and the ‘Team’ section of the left-hand sidebar. 

stakeholders_icon_4

⇐ UNAPPROVED BROKER

 stakeholders_icon_5

⇐ VERIFIED BROKER

stakeholders_icon_6

⇐ UNVERIFIED BROKER

Adding a Stakeholder 

To add a stakeholder to an application: 

  1. Click on the Edit icon () in the top right corner of the widget .
  2. This will reveal an add stakeholder button beside the widget’s name. 

  3. Click on the add stakeholder button.
  4. From the dropdown menu, choose the type of stakeholder you wish to add to the application. 

Note: The drop down options of Borrower and Company are grayed out. The reason for this is that they act as a primary borrower. You can only have 1 primary borrower on the deal so you cannot add another primary borrower. However, you can change your customer type from Borrower to Company if you are changing the deal from a personal deal to a company deal.

We have included a "Beneficial Owner" Customer Type. When dealing with a company, lenders also need to capture the beneficial owner of the company. This is similar to a director and has the same attributes and tabs as the "Director" customer type.

Each type of Stakeholder has its own independent drop down menu of fields to be entered. The following table presents the Stakeholders in the same order as they consistently appear in the Stakeholder's Details Widget list:

Note: When it comes to the stakeholder list, either Borrower or Company will always be at the top as the Primary Borrower.

Icon

Customer Type 

‘Add Stakeholder’ Popup

borrower_icon

 

 

 

 

 

 

 

 

 

 

company_icon

Borrower

 

 

 

 

 

 

 

 

 

 

Company

 

 

borrower_icon

Co-Borrower

borrower_icon

Director

borrower_icon

Beneficial Owner

borrower_icon

Guarantor

3rd_party_icon

POA

poa_popup

3rd_party_icon

Signing Officer

3rd_party_icon

3rd Party

3rd_party_icon

Agent

3rd_party_icon

Lawyer

3rd_party_icon

Submitting Agent

3rd_party_icon

Brokerage


Fill in all the necessary information for the stakeholder you are adding and click on the "Create Stakeholder" button once you are done. This will add the stakeholder to the application and they will appear in the Stakeholder list.

Note: All phone number fields require an area code

Note: The Stakeholder widget list will include both the Submitting Broker and any additional agents added to the deal. However, only the agent will be displayed in the 'Team' list on the left-hand sidebar.

Note: If ‘FICO Score Override’ is checked off for a given stakeholder, the system will consider that applicant’s score for pricing purposes. The system’s default is to use the FICO score from the applicant with the highest income regardless of score for pricing purposes. This is tied to how the products and rate matrices are set up in the Manager Portal. 

‘Stakeholder’s Details’ Widget Tabs

‘Overview’ Tab

The 'Overview' tab houses all the basic details about a given stakeholder. It aligns with the fields available when adding a new stakeholder to an application. As a result, certain types of stakeholders may have fewer or unique fields in their 'Overview' tab.

To enhance the user experience, we have incorporated search functions for fields that contain a large number of options in the dropdown menu. This feature eliminates the need for users to manually scroll through the entire list to find the desired option. Instead, users can simply start typing in the search field and the list will automatically update with relevant matches as they type. An example of such a field is the "Country of Residence" field.     

Client ID

client_id

The 'Client ID' field allows users to assign unique IDs to borrowers that can be used to match them in the future. When a new deal or applicant is added to the system, it will search for existing applicants with the same first name, last name, middle name (if applicable), and date of birth. If a match is found, the client ID from the matched applicant will be assigned to the new applicant. If no match is found, a new unique ID will be generated.

If there are multiple matches based on these criteria, the system will attempt to determine a match using phone numbers, email addresses, and SIN (Social Insurance Number). If there are still multiple matches, the system will use the client ID of the latest created applicant. Additionally, users have the option to generate a new unique client ID in cases where the system detects two individuals with the same name and date of birth.

Once a match is found, the client ID will be displayed in the bottom right corner of the 'Overview' tab.

match_found


The generation of client IDs and matching applicants based on these IDs is a feature that can be toggled in the ‘Settings’ section of the Manager Portal. Currently, we only offer numeric IDs. 

match_applicants

Note: For lenders that assign the client ID outside the FundMore system, we have also exposed a new WebHook wherein we can send the payload for both the old and new client ID.

The ‘Overview’ tab also includes a Citizenship status field. The options for this field can be configured by Admin Users in the Custom Fields section of the Manager Portal.

‘Contacts’ Tab

In the 'Contacts' tab, you will find all the contact information for the stakeholder. You can easily choose the stakeholder's preferred method of contact by selecting the radio button next to each field (only one method can be selected at a time).  

Note: All phone number fields require an area code

‘Addresses’ Tab

The ‘Addresses’ tab houses all the address details for a given stakeholder, including current and previous addresses. You can identify the Stakeholder’s current address by clicking the radial button in the middle column labeled ‘Current’ (only one address may be selected at a time). The address fields correspond with the fields that are available upon adding a new stakeholder type to an application. This means that certain kinds of stakeholders will have far fewer fields or unique fields in their ‘Addresses’ tab.

Borrower Address:

borrower_address


Lawyer Address:

lawyer_address


The orange 'Address' button utilizes Google integration to simplify the process of searching for addresses and automatically splitting them. For flexibility, users also have the option to manually modify any parts of the address. Please note that the address cannot be edited directly within the pop-up window, as it is populated based on a match with the Google Maps database. However, there is an 'X' button next to the matched address in the address tab, which allows you to remove the address entirely and search again in the Google Maps database. If necessary, you can still update the address details within the details section. 

If the applicant is renting, this can be captured by selecting ‘Rent’ in the ‘Residential Status’ and the monthly rent can be entered in the ‘Rent’ field. The ‘Include rent in calculations’ checkbox allows the user to include or exclude the monthly rent as a liability in calculations for TDS as needed. It is important to not that for applications ingested from Finmo, we have modified the mapping to have the “Include Rent in Calculations” checkbox default to false/unchecked.

rent_options

We have also included the options of "Owner Occupied" and "Rental" to the drop down options when adding an address for the applicants in the Stakeholder widget. It is important to note that selecting these options may impact debt servicing. 

To delete an address, click on the ellipsis icon positioned on the same line as the address you want to remove. This icon is usually located to the far-right of the line. Then, select the "Delete" option from the drop-down menu.

‘Compliance’ Tab

The 'Compliance' tab contains all the information related to a stakeholder's potential risks and the compliance measures taken to assess these risks. This tab was implemented to help lenders manage the compliance requirements for mortgage underwriting. It provides details about PEP and AML, if such information is available for the applicant.

Note: This tab will not populate for any 3rd party stakeholders such as brokers, lawyers, etc.

The following fields and their options are available for each borrower under this section::

  • Politically Exposed Person
    • Head of an International Organization (HIO)
    • Not a PEP
    • PEDP & HIO
    • PEFP & HIO
    • Politically Exposed Domestic Person (PEDP)
    • Politically Exposed Foreign Person (PEFP)
  • Fraud/AML Risk
    • Demarketed Client (No New Business Permitted)
    • High Risk Client
    • No New Business
    • SATR Filed
    • STR Filed
  • Third Party Determination
    • No
    • Yes
  • Client Risk Score
  • Request Name Screening
    • No
    • Yes
  • Client Identified In Name Screening
  • Client Screening Completed - This field can be set by the user through the interface and represents a flag indicated when an AML/Fraud check has been completed.
  • Client Screening Completed Date - This field can only be set programmatically through the API and can be leveraged when integrating with third-party tools to indicate when a screening has been completed. 
  • Client Last Screening Date - This field can only be set programmatically through the API and can be used to capture the last time a screening was completed.

The value of all option fields can be customized within the Manager Portal.

‘PAD’ Tab

The ‘PAD’ tab stores a stakeholder’s pre-authorized debit details so that they can be relayed through integrations with the different servicing platforms. The following fields are available within this section:

  • Financial Institution
    • Allows the user select from all financial institutions in Canada. The user can find the desired institution by using either the institution name or number.
  • Account Type
    • Savings
    • Chequing
  • Transit Number
  • Account Number

pad_tab

Payment Source Field

Note: This is a tenant specific field and as such may not be visible in your environment. 

The Payment Source field in the PAD tab facilitates the selection of either external or internal banking information when setting up PAD details. With this field, users can indicate if the payment is coming from an external or internal account and depending on the source selected, the PAD set up will differ.  


If External Account is selected, 4 fields open up:  Financial Institution, Account Type, Transit Number, and Account Number.  

Alternatively, if an internal Account is selected, 3 fields open up:  Member Number, Account Type, and Sub Number. The options for Account Type can be managed via Custom Fields in the Manager Portal. 

Depending on the needs of the company, there is an option to block stage transition until the banking information is provided. For example, you can configure the system to ensure the banking information is completed prior to advancing past the Document Review stage. This can be managed by marking the fields as required in the Custom Fields section of the Manager Portal, or by creating a Task to manage the requirement. 

Manually add or edit External Financial Institutions

Note: This is tenant specific and as such may not be applicable in your environment. 

Users have the ability to add or edit a financial institution name and number. We have split these fields so they are no longer combined into a single field. This gives users the flexibility to update them when necessary. 

If the borrower provides an institution that is not on the existing list, you can use the option of “Other” in the Financial Institution drop down list to enter a new one. 

Note: This action does not add the institution to the master list. It only adds it to the specific application being worked on. The information is also not retained in the database.  

Here is a video demonstrating this functionality: Manually add or edit External Financial Institutions. You can also use the same functionality to edit an already existing entry if necessary.

‘Custom Fields ’ Tab

The Custom Fields tab holds all the fields created within the Application Entity in the Custom Fields section of the Manager Portal. These fields are created by your System Administrators or Managers as per the needs of your company.

Note: We do not map custom fields due to their dynamic nature. These fields can be created, changed, and deleted at any time so we cannot count on them to be reliable inputs for mappings in general.

Custom Fields are displayed alphabetically in ascending order, making it easier to identify the position of a specific field within the list.

Edit the Custom Fields Tab - To edit fields in the Custom Fields tab, follow these steps:

  1. Click on the edit pencil in the top right corner of the widget to enter edit mode.
  2. Click on the Custom Fields tab.
  3. Locate the field you would like to update.
  4. Click on the field and edit it.
  5. When you done editing, click the Close Edit Mode button at the top right corner of the widget.

Editing a Stakeholder’s Details

To edit a Stakeholder's details, follow these steps:

edit_stakeholder

  1. Select the edit pencil on the top right hand corner of the widget to switch to edit mode.
  2. Select the stakeholder you wish to edit from the stakeholder's list on the left.
  3.  From the top menu bar, click the tab that houses the information you want to change.
  4. Find the field you would like to update and adjust as needed.
  5. Once you are done editing,  go to the top right corner of the widget and click the ‘Close Edit Mode’ button. 

Reassigning a Customer Type

To provide lenders with the necessary flexibility to make adjustments to the deal and accurately reflect the reality, we have included the option to change customer types and reassign the primary applicant on the file. The system will always require a primary applicant (Borrower) so when you are trying to change an existing primary applicant to some other type, users will be prompted to select a new primary applicant first. 

Within the applicant’s ‘Overview’ tab, select the new Customer Type that you would like to reassign. 

reassign_customer_type

When changing the type for co-applicants or guarantors, you can simply select the desired type from the drop-down list and assign it to the applicant.

If you need to change the primary applicant (Borrower), a pop-up will appear where you can select a new borrower from the list of other applicants on the file. Simply choose the appropriate stakeholder by selecting the corresponding radial button and click the ‘Confirm Replacement’ button to assign the new primary applicant. 

It is recommended to begin with the primary applicant (Borrower) when changing the applicant type. This ensures a smooth transition and accurate reflection of the changes in the application.

replace_primary_applicant

For lenders that are using our FundMore DM solution, the ability to reassign a primary applicant is only available before a document request is issued. 

Users also have the ability to remove any selected option from the Stakeholders widget. With the exception of the customer type, all dropdown menus can now be easily cleared. For instance, if the primary applicant is changed, the relationship to the primary applicant can be cleared from a stakeholder. 

replace_primary_applicant_2This feature is especially useful when you need to change the Customer Type for your existing Stakeholders. It allows you to update the Relationship to Primary Applicant at the same time, making it convenient and efficient. 

To see a demonstration, click here to watch a quick video.

Deleting a Stakeholder

delete_stakeholder

To delete a stakeholder, follow these steps: 

  1. Hover over the stakeholder’s name or click on the stakeholder.
  2. This will reveal an ellipsis to the right of the stakeholder’s name,
  3. Click on the ellipsis and select the 'Delete' option. This will remove the stakeholder from the list.

Note: The primary applicant cannot be deleted from the stakeholder section.