Provide the Lending Company with an option to verify the Customer's phone number. Such a verification can be enabled in the system configuration if SMS integration is enabled.
If the functionality is enabled, an SMS code is sent to the phone number provided by the Customer. To finalize the verification the Customer must enter the verification code on the Customer's Portal.
User interaction and design
Borrower
When the application form is submitted Borrower receives an SMS with the verification coderequired to complete an application. Borrower logs in toPersonal Account.
...
Enter the verification code to complete the application process;
Ask to resend the code;
Borrower should be able to edit
In case if Borrower has edited a phone number, he should be prompted to verify a new number.
Amount of SMS messages available for the borrower to Update Main Phone or to RESEND CODE should be limited. Max number of SMS messages available per day should be specified in the /wiki/spaces/TKL/pages/207781909
Borrower should be able to requests to resend the code by clicking RESEND CODE in case Phone number was updated.
Use cases
Preconditions:
Application form is submitted by the Borrower.
The Borrower is logged in to the Front Office.
The SMS with a verification code has been sent tothe Borrower's phone number (Customer details →Main Phone).
The default SMS Code Expiry Period is 5 minutes. The SMS Code Expiry Period is hardcoded.
Info
A verification code is sent to a Borrower's phone number which is specified using a globally selected SMS provider
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
The System validates the entered code for expiry.
In case if the code is NOT EXPIRED:
The System validates entered code (which is valid for this use case) and shows the corresponding Application complete notification.
The System changes the loan status to AutoProcessing.
...
The loan status changes to AutoProcessing.
Phone verification notification is hidden.
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
The System validates the entered code for expiry.
In case the code is EXPIRED the system shows the notification "Сode expired".
...
The loan remains in a Origination status.
The Loan Details panel contains the same list of Phone verification options.
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
The System shows notification "Invalid code".
After three unsuccessful attempts borrower will be Locked Image Removed
...
The loan remains in a Origination status.
The Loan Details panel contains the same list of Phone verification options.
...
Requests to
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
The System sends the customer a new code.
...
The SMS CodeExpiry Period the counter is reset.
The loan remains in a Origination status.
The Loan Details panel contains the same list of Phone verification options.
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
In case if Exceededthe system shows the notification "Too many attempts, try again tomorrow".
Originator
In case if this functionality is enabled SEND FOR APPROVAL button is replaced with SEND FOR VERIFICATION button
In case if the application form is submitted from the Back-Office, a verification code will be sent after Originator clicks on SEND FOR VERIFICATION
In case if Main Phone is Verified system automatically sends loan application for Approval
...
clickson SEND FOR VERIFICATION
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
The system opens a popup with phone verification window
...
The loan remains in a Origination status.
The System sends a verification code to the Borrower
...
The System validates the entered code for expiry.
In case if the code is NOT EXPIRED:
The System validates entered code (which is valid for this use case) and shows the corresponding Main Phone is Verified notification.
...
The System changes the loan status to AutoProcessing.
...
Enters the incorrect code and clicks VERIFY
...
The System shows notification "Invalid code".
...
The loan remains in a Origination status
The phone verification window contains the same list of options.
...
Enters the EXPIRED code and clicks VERIFY
...
The System validates the entered code for expiry.
In case the code is EXPIRED the system shows the notification "Сode expired".
...
The loan remains in a Origination status
The phone verification window contains the same list of options.
...
Requests to
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
The System sends the customer a new code.
...
The SMS CodeExpiry Period counter is reset.
The loan remains in a Origination status
The phone verification window contains the same list of options.
...
Exceeded Max number of SMS messages available per day
And Requests to
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
In case if Exceededthe system shows the notification "Too many attempts, try again tomorrow".
...
The loan remains in a Origination status
RESEND CODE button is disabled
...
Exceeded Max number of SMS messages available per day
clickson SEND FOR VERIFICATION
...
The System checks if Borrower has not Exceeded Max number of SMS messages available per day
In case if Exceededthe system shows the notification "Too many attempts, try again tomorrow".
...
The loan remains in a Origination status
Customers Workplace
In case if the application form is submitted from the Back-Office from the Customers Section, an a verification code will be sent after Borrower is applied for a loan
Search filters
In a filter list available onOriginationworkplace:
the systemshall have a filter to display all applications which are waiting for a phone verification (Phone Verification)
Front-Office
Mockup of the Phone verification notification area:
Image Removed
The specification of the control elements of the Phone verification notification area:
...
If enabled, verification is required for every new customer and each time the Customer’s phone number is changed (by the Customer or by a Back-Office User).
Primary Flow
The primary flow of the feature implies active participation of the Customer.
1. Customer Gets the Message
...
a. The Customer is registered or their phone number is updated in the system.
b. The Customer gets an SMS with a code where they are also requested to enter the code into the message in the Customer's Portal.
c. When the Customer opens the portal, they will see the message with a place for the verification code.
2. The Number is Verified
Verifying the number is very simple: It is enought to enter the code from the SMS and click the “Verify” button. However, the following numbers should be kept in mind:
Five codes per day: If the “Send code” button is clicked, a new code is send to the Customer’s phone number. (This value can be changed in the client web configuration.) If the limit is exceeded, the Customer has to wait and retry on the next day.
Five minutes per code: The codes are expired in 5 minutes. If the code is entered later, a message will appear to inform the customer that the code has expired. (This is a hardcoded value that can be updated in a custom implementation.)
Three attempts before lock:The Customer is locked after three unsuccessful attempts to enter the code. The Customer can be unlocked by the a Back-Office User with “Customer Management” permission.
Image Added
Should the customer decide to close the message without verifying the code, a reminder will be displayed in the Customer’s portal.
...
Actions of a Back-Office User
Assisting the Customer
...
The Back-Office Users are also notified that the phone number verification is required. The status will be changed to “Phone verification”
NOTE: If there a loan in the Origination state, the Back-Office User responsible for the Loan will see the Phone Number Verification form. This is done to allow the manager assist Customers with the phone number verifications at the point when it is crucial to move on with the loan application processing.
Unlocking the Customer
If the Customer has entered incorrect password for too many times and has been locked, the Back-Office User ( with “Customer Management” permission) can Unlock the user.
...
After the action is confirmed, the Customer’s will be unlocked and can verify the phone number. If the confirmation code is faulty, the Customer will be locked again.