Access your Back Office at your fingertips.
Download the app now on Google Play Store.
Scan the QR code
You can also scan QR code with your phone to download the app.
How to configure a restricted wallet on your loan products
What is a restricted wallet?
A restricted wallet enables you to manage how customers utilize the loan funds disbursed to their digital wallets. With this feature, you can manage actions like transfers, payments, bills, airtime purchases, and more. This ensures that loan funds are used as intended, offering a higher level of control and security for lenders.
Understanding the restricted wallet concept
The restricted wallet feature represents a significant advancement in digital lending control mechanisms. Traditional loan disbursements send funds directly to borrower accounts with no oversight over how those funds are used. Once money hits a borrower’s account, they have complete freedom to spend it however they choose, regardless of the stated loan purpose.
This lack of control creates several problems for lenders. Borrowers might take out a loan claiming they need it for business inventory but then use the funds for personal expenses or gambling. When the time comes to repay, the borrower no longer has the funds because they were not invested in income-generating activities as intended. The lender faces higher default risk simply because funds were diverted from their stated purpose.
Restricted wallets solve this problem by creating a controlled environment where loan funds can only be used in approved ways. When you disburse a loan to a restricted wallet, you maintain granular control over what the borrower can do with those funds. You can allow certain transaction types while blocking others, ensuring alignment between loan purpose and actual usage.
This control mechanism proves particularly valuable for specific-use loans. If you offer loans specifically for bill payments, you can restrict the wallet to allow only bill payment transactions. If you provide business inventory loans, you can enable transfers to approved vendors while blocking cash withdrawals and personal purchases.
The feature also enhances loan recovery rates. When borrowers can only use funds for productive purposes, they are more likely to generate the returns needed to repay the loan. A market trader who receives a business loan that can only be used for inventory purchases is more likely to invest properly and generate profits than one who receives unrestricted cash.
Understanding the technical implementation helps you configure restricted wallets effectively for your specific lending scenarios.
At the core of the restricted wallet system is a configuration payload that defines which transaction types are permitted and which are blocked. This payload uses a simple JSON structure where each transaction type has a corresponding setting that determines whether it is restricted.
In this configuration structure, each key represents a different transaction type that borrowers might attempt. The value assigned to each key determines whether that transaction type is restricted. When a setting is enabled or set to true, the corresponding action becomes restricted. This means users will be prevented from performing that specific activity within their app.
For example, if “transfer” is set to true, borrowers cannot make transfers from their restricted wallet. If “bills” is set to true, they cannot pay bills. This might seem counterintuitive at first, since “true” usually means something is enabled, but in this context, “true” means the restriction is enabled, which blocks the action.
Conversely, setting a value to false means that restriction is disabled, allowing the transaction type. If “payments” is set to false, borrowers can make payments from their restricted wallet. If “airtime” is set to false, they can purchase airtime.
This configuration system gives you precise control over wallet functionality. You can create highly restrictive wallets that only allow one or two transaction types, or you can create more permissive wallets that block just a few specific actions while allowing everything else.
Advanced configurations for conditional restrictions
Beyond simple enable or disable settings, the restricted wallet system supports conditional logic that applies restrictions based on the borrower’s current status. This advanced functionality creates more nuanced control policies.
For example, you might want to allow transfers normally but restrict them when a borrower has an outstanding loan balance. This encourages borrowers to repay before moving funds around. The configuration for this scenario looks like this:
In this advanced configuration, most settings remain simple true or false values. However, the transfer setting uses conditional logic expressed as an if statement. The logic checks whether the variable “loan.outstanding_balance” is greater than zero. If the outstanding balance is greater than zero, meaning the borrower still owes money, the transfer restriction is set to false, which means transfers are allowed. If the outstanding balance is zero or less, the restriction is set to true, blocking transfers.
This might seem backwards because you might expect to block transfers when there is an outstanding balance. However, remember that in this system, true means restricted or blocked. The conditional logic returns false when there is a balance, which means do not restrict or allow the action. When the balance reaches zero, it returns true, which restricts transfers.
You can create various conditional restrictions based on different variables including loan status, days past due, number of previous defaults, total amount borrowed, or custom fields specific to your lending operation. This flexibility enables sophisticated risk management strategies encoded directly into wallet behavior.
Setting up a restricted wallet on the admin console
Configuring the restricted wallet feature through the Lendsqr admin console establishes the default restriction policy that applies across your platform. Here is how to set it up step by step.
Step 1: Click on the “Settings” icon
Locate the “Settings” icon at the top right corner of your admin console screen. This icon typically appears as a gear or cog symbol and provides access to various system-wide configurations. Click on this icon to open the settings menu.
Step 2: Select “System configurations” under “Settings”
After clicking the Settings icon, you will see a page with multiple settings categories. Look for the section labeled “System Settings” which contains platform-wide configurations that affect all users and products. Within this section, select “System Configurations.” This takes you to a page with various technical and operational settings that control how your lending platform functions.
Step 3: Click on “Transaction security settings”
Click on “Transaction Security Settings” to expand this section and view the available options.” This section contains controls for managing how transactions are processed and what security measures apply.
Step 4: Locate and edit the “Restricted wallet transactions” setting
Within the Transaction Security Settings section, look for the specific setting labeled “Restricted Wallet Transactions.” Each setting in this section has associated actions accessible through an icon on the far right, typically represented by three dots or an actions menu. Click on the three dot icon by the far right of the Restricted Wallet Transactions setting. A dropdown menu will appear with available actions. Click on “Edit” from this menu to modify the current settings. This opens an interface where you can adjust the JSON configuration that defines which transaction types are restricted.
Step 5: Edit settings and save changes
After editing the restricted wallet settings to match your preferences, click on “Save” to apply the changes. The system will validate your configuration and, if correct, apply it as the new default restricted wallet policy.
Configuring a restricted wallet on specific loan products
While the system-wide restricted wallet configuration establishes defaults, you can also configure restricted wallet behavior for individual loan products. This allows different loan products to have different restriction policies based on their specific purposes.
Step 1: Navigate to “Loan products” under “Product management”
From the main navigation menu in your admin console, locate and click on “Product Management.” Within Product Management, select “Loan Products.” This displays a list of all loan products you have created on your platform.
Step 2: Locate and edit the specific loan product
Browse through the list of loan products to find the specific product you want to configure for restricted wallet disbursement.Navigate to the product in the list and click on the “Edit” button next to it. This opens the loan product configuration interface where you can modify various settings including interest rates, tenors, fees, and disbursement options.
Step 3: Select “restricted-wallet” in disbursement details
Once in the loan product edit interface, scroll down through the various configuration sections until you reach the “Disbursement Details” section. This section controls how loan funds are delivered to borrowers when their applications are approved. Within Disbursement Details, locate the “Disburse To” field. This dropdown field presents several options for where loan funds should be sent. The options might include borrower account, third-party account, restricted wallet, or other disbursement destinations. Select “restricted-wallet” from the “Disburse To” field. This tells the system that when loans from this product are approved, funds should be disbursed to a restricted wallet with the configured transaction limitations.
Step 4: Save changes to the loan product
After selecting restricted wallet as the disbursement destination, review all other settings on the loan product to ensure everything is configured correctly. Check interest rates, fees, tenor options, and eligibility criteria to confirm they match your intended product design. Scroll to the bottom of the loan product form and click on “Save Changes.”The restricted wallet disbursement setting will be updated immediately on the loan product, affecting all new loan applications for this product going forward.
Best practices for implementing restricted wallets
Always communicate restriction policies clearly before borrowers accept loans Borrowers should understand exactly what they can and cannot do with the funds before committing to the loan.
Design restriction policies that match loan purposes. Alignment between restrictions and loan purpose reduces borrower frustration.
Start with moderate restrictions and adjust based on data. Overly restrictive wallets might drive borrowers to competitors even if your other terms are attractive.
Consider offering both restricted and unrestricted loan products at different price points. Those preferring flexibility can pay a premium for unrestricted access.
Implement clear error messages when restricted transactions are attempted.Poor error messaging creates confusion and support burden.
Provide a grace period or partial restriction relief as borrowers build repayment history. A borrower who has successfully repaid three loans might earn access to less restrictive wallets on future loans.
