How to configure a loan request checklist on your loan product

Unexpected requirements in the loan process can lead to frustration, causing borrowers to abandon their applications. To tackle this, incorporating a loan request checklist into your loan product ensures that borrowers are fully informed about what’s required upfront.

Imagine a small business owner applying for a loan to expand their operations. Without a checklist, they might begin the application without knowing they need documents like tax returns, business registration certificates, or a bank statement. Midway through the process, they’re asked for additional documents they weren’t prepared for. This unexpected request can create frustration, delay the process, and possibly cause them to abandon the application altogether.

However, with a loan request checklist clearly presented upfront, listing all required documents and eligibility criteria, the borrower knows exactly what’s needed and can gather everything before starting the application. This approach simplifies the application journey, builds trust, and reduces abandoned applications significantly.

Lendsqr lets you configure this checklist directly on each loan product, using JSON to define the title, the checklist items, and whether borrowers see the system defaults or your own custom conditions. This article explains the JSON structure and walks through each configuration option.

What the loan request checklist does

When a borrower opens a loan product on your app, the checklist screen appears during the flow of the application form. Each condition is displayed with a label and a short description. The borrower must acknowledge each item by ticking each checkbox before proceeding with their loan request.

Borrowers must tick each checkbox individually before proceeding with their loan application. They cannot proceed without checking all items; the system requires all checklist items to be checked to move forward.

How to configure the checklist

Here’s how you can set up a Loan Request Checklist to enhance your customer experience:

  1. Log in to the Lendsqr admin console
Lendsqr admin console showing navigation to Loan products
  1. From the main dashboard, go to “Product Management” and select “Loan Products“. This displays all your existing loan products.
  2. Click on the loan product you want to configure, or click “Create loan product” to start a new one.
Lendsqr admin console Product Management page showing the Loan Products list
  1. Navigate to the “Product Attributes” tab on the loan product page.
Lendsqr loan product settings page with the Product Attributes tab selected
  1. Scroll through the attributes list until you find “Loan Request Checklist“. Click the more options button (⋯) and select “Edit“.
Lendsqr Product Attributes page showing the Loan Request Checklist row with the more options menu open and Edit selected
  1. Update the JSON value as required. See the configuration options below for the full details.
  2. Click “Save” to apply the changes to the loan product.
Lendsqr loan product attribute edit field showing the JSON value with the Save button below

Understanding the JSON configuration

The checklist is configured using a JSON object with the following fields:

  • active: Controls whether the checklist screen is shown to borrowers. Set to true to enable it, or false to hide it. When set to false, borrowers skip the checklist screen entirely and proceed directly to the application.
  • title: The heading text that appears at the top of the checklist screen on the borrower’s app. You can customise this to match your platform’s tone.
  • is_custom_conditions: Determines whether the platform uses Lendsqr’s system defaults (false) or your own custom conditions (true). When set to false, the conditions defined in this JSON are ignored, and the platform shows its built-in checklist items instead.
  • conditions: An array of checklist items. Each item has two fields:
    • label: the short title of the checklist item, displayed as a heading.
    • description: the supporting text explaining the requirement in more detail.

Option 1: Use the system default checklist

By default, the checklist is active and uses Lendsqr’s system-configured conditions. You do not need to change anything, this is the state when you first open the attribute. To explicitly apply the system defaults, paste the following JSON into the attribute field:

{"active":true,"title":"There are a few things you need to do first","is_custom_conditions":false,"conditions":[{"label":"Direct debit","description":"You must have an account you can use for your direct debit mandate"},{"label":"Debit card validity","description":"We require debit cards to have validity at least 3 months beyond the last payment schedule"},{"label":"Location","description":"Your location must be turned on for your loan request to be processed successfully"},{"label":"Maximum loan amount","description":"The maximum loan amount we give to first time customer is N100. However, this would be increased as you take loans and repay"}]}

Option 2: Disable the checklist

To hide the checklist screen entirely, so borrowers skip it and go straight to the application form, set active to “false”:

{"active":false,"title":"There are a few things you need to do first","is_custom_conditions":false,"conditions":[{"label":"Direct debit","description":"You must have an account you can use for your direct debit mandate"},{"label":"Debit card validity","description":"We require debit cards to have validity at least 3 months beyond the last payment schedule"},{"label":"Location","description":"Your location must be turned on for your loan request to be processed successfully"},{"label":"Maximum loan amount","description":"The maximum loan amount we give to first time customer is N100. However, this would be increased as you take loans and repay"}]}

Option 3: Use your own custom conditions

To define your own checklist items, set is_custom_conditions to “true” and update the label and description values in the conditions array. You can also add more items or remove default ones:

{"active":true,"title":"There are a few things you need to do first","is_custom_conditions":true,"conditions":[{"label":"Direct debit","description":"You must have an account you can use for your direct debit mandate"},{"label":"Debit card validity","description":"We require debit cards to have validity at least 3 months beyond the last payment schedule"},{"label":"Location","description":"Your location must be turned on for your loan request to be processed successfully"},{"label":"Maximum loan amount","description":"The maximum loan amount we give to first time customer is N100. However, this would be increased as you take loans and repay"}]}

Replace the label and description values with the specific requirements for your loan product. You can add as many condition items as needed.

What borrowers see

After saving, borrowers applying for that loan product will see the checklist screen before they can submit their application. Each condition is displayed with its label and description. They must acknowledge all items before proceeding.

Borrower mobile app screen showing the loan request checklist with four items the borrower must confirm before proceeding

Related: Approving and declining a loan request

Was this page helpful?