The goal is to build a controlled digital lending operation that captures and converts leads into compliant customers, originates and approves loans with proper governance, disburses and collects funds reliably via M-Pesa, automatically reconciles repayments, tracks portfolio health, enforces accountability through audit logs and role controls, and produces real-time financial and operational visibility.
The core platform serves as the foundation for everything else. It establishes a single source of truth for all loan and customer data, ensuring that financial reporting, compliance, and reconciliation are reliable. Authentication and identity access management is role-based, with a clear separation of duties: Loan Officers capture leads and create applications, Credit Managers approve or reject loans, and Admin/Finance monitors disbursement and collections. No user can approve their own loan, which enforces internal controls by design.
Every material action in the system is logged to an audit trail — recording who did what, when, and to which record. This protects against internal risk and supports compliance or investor due diligence. The backend is cloud-native, meaning it is built to scale as loan volume increases without operational breakdown, with reliability and uptime prioritized especially around payment processing.
The LOS standardizes and controls how capital is deployed. It begins with lead management — staff can capture walk-in or referral leads via a simple form, and leads are tracked through a pipeline (New → Contacted → Qualified → Converted). With one action, a qualified lead becomes a formal customer record, with KYC documents such as a national ID and business permit uploaded and stored to support compliance and reduce fraud risk.
Once a customer exists, a Loan Officer creates a loan proposal specifying the principal, interest rate, fees, and repayment schedule (daily, weekly, or monthly). The system auto-calculates repayment amounts and generates a full amortization schedule. The proposal then enters a maker-checker approval workflow: the Officer submits, the Manager reviews, and only approved loans proceed. Upon approval, the system auto-generates a formal PDF loan agreement containing the loan terms, repayment schedule, fees, and penalties — formalizing the borrower's obligations and reducing the risk of disputes.
Disbursement can be handled in two ways. If funds are sent offline, staff must record the amount, date, and M-Pesa reference manually — ensuring every loan marked as disbursed has traceable evidence. For automated disbursement, the system sends funds directly to the borrower's phone via Safaricom M-Pesa B2C integration. It triggers the payment, tracks the transaction state, prevents duplicate payouts through idempotency controls, and only transitions the loan status from Approved to Active upon confirmed receipt. The borrower receives an SMS notification on success.
Collections are handled through M-Pesa C2B integration. Incoming payments arrive in real time via secure webhooks, are automatically matched to the correct loan, applied to the repayment schedule, and the outstanding balance is updated. Partial payments reduce the next due installment or the outstanding balance. Overpayments can be configured to either credit future installments or be flagged for refund review. Loan Officers can also initiate an STK Push directly from the system to prompt a borrower to pay, which accelerates collections without requiring manual follow-up.
Every loan automatically generates a repayment schedule (daily, weekly, or monthly) that drives both tracking and borrower communication. A daily automated check scans for missed payments. When a payment is overdue, the loan status transitions from Active to Overdue and late fees or penalties are applied per the configured rules — no manual intervention required.
Automated SMS reminders are sent at each stage: payment due today, payment missed, and escalated overdue. These are delivered via Africa's Talking, enabling reliable outbound communication at scale. This replaces manual chasing with system-driven collections discipline.
Leadership has access to an operational dashboard showing live totals for active loans, daily/weekly/monthly disbursements, collections, portfolio at risk (PAR), and overdue balances. Financial reports track interest income, fee income, yield, default rates, and collection efficiency, and can be exported to Excel for finance and board review. Staff performance is also tracked — loans originated, disbursement volume, and collection performance are attributed per officer, enabling incentive alignment and accountability.
The following controls are embedded throughout the system to protect capital as it scales: maker-checker approval so no single person can unilaterally deploy funds, mandatory KYC before any disbursement, automated state transitions that prevent manual status manipulation, audit logs for every action, idempotent disbursement logic to eliminate duplicate payouts, and automated overdue detection with penalty application.
The build is sequenced across five phases to allow revenue to begin early while controls are progressively strengthened.
Phase 1 establishes the secure data layer, role-based access, and structured lead conversion. Phase 2 enables controlled underwriting and digital contract generation. Phase 3 integrates M-Pesa B2C for automated disbursement and accurate loan activation. Phase 4 brings in C2B payments and auto-reconciliation for collections. Phase 5 activates automated arrears logic and the executive reporting dashboard.
The following modules are complete: Auth, Leads (CRUD and stage updates), Customers (create, search, findById), Loans (create, approve, list), Repayments (process and inbound with suspense routing), Collections (suspense queue, PTP, interaction logs), and Audit logs.
What remains: PATCH /loans/:id for loan restructuring and the Disbursement endpoints (B2C trigger) are the two priority gaps. Reports/dashboard aggregates and SMS trigger endpoints are also outstanding but not yet urgent.
Adequate Capital operates as a controlled, technology-enabled lending engine where capital is deployed with governance, collections are automated and traceable, risk is visible in real time, staff accountability is measurable, and leadership has continuous financial clarity. The result is a lending operation designed not just to issue loans, but to reliably recover them and grow portfolio yield with discipline.