Skip to main content
Welcome to the lending platform documentation. This guide will help you understand how our digital lending system works and how to integrate it into your application.

What is Digital Lending?

Our lending platform enables fast, secure, and automated loan processing for customers. The system supports:
  • Loan Applications - Customers can apply for loans through multiple channels
  • Automated Underwriting - Automated credit assessment and risk evaluation
  • Fast Disbursement - Funds are electronically disbursed to customer wallets
  • Repayment Management - Automated repayment tracking and collection

Key Features

Automated Credit Assessment

Automated credit scoring and risk evaluation using credit bureaus, history and alternative data.

Multiple Loan Products

Configure different loan products with varying interest rates, tenures, and eligibility criteria.

Flexible Disbursement

Disburse loans to customer wallets or bank accounts.

Automated Repayment Tracking

Track repayments, generate schedules, and manage collections automatically.

Real-Time Processing

Fast loan application processing with automated eligibility checks and instant decisions where applicable.

API-First Design

RESTful APIs with comprehensive documentation and sandbox environment for seamless integration.

How It Works

The lending flow consists of five main phases:
1

Loan Application

Customers apply for loans by selecting a product, providing required information, and answering eligibility questions.
2

Application Processing

System processes the application, performs eligibility checks, and may trigger automated credit assessment.
3

Underwriting & Approval

Loan officers can manually review applications, approve or reject based on risk assessment, and set loan terms.
4

Disbursement & Withdrawal

Approved loans are disbursed to a newly created customer wallet. Customers can then withdraw funds to their verified bank accounts.
5

Repayment & Collection

Customers make repayments according to schedule, with automated tracking and collection management.
For detailed visual flow, see the Process Flow and Loan Lifecycle pages.

Core Concepts

Loan Application Lifecycle

Every loan application moves through defined states from submission to completion:
REQUESTED → APPROVED → OFFER_SENT → ACCEPTED → DISBURSED
Applications can also transition to REJECTED or CANCELLED at various stages.

Learn More

See detailed state transitions and what triggers each status change.

Loan Products

Loan products define the terms and conditions for different types of loans:
  • Interest Rates - Fixed or variable rates
  • Tenure Options - Available loan periods (e.g., 3, 6, 12, 24 months)
  • Eligibility Criteria - Requirements customers must meet
  • Fee Structure - Processing fees, late fees, etc.
  • Min/Max Amounts - Loan amount limits

Learn More

Understand how loan products are configured and selected.

Credit Assessment

The platform uses multiple data sources for credit assessment:
  • Credit Bureau Integration - Access to credit history and scores
  • Transaction Analysis - Analysis of customer transaction patterns
  • Alternative Data - Employment, income, and other verification data
  • Risk Models - Custom risk scoring algorithms

Learn More

Explore credit assessment methods and risk models.

Repayment Schedules

Repayment schedules are automatically generated based on:
  • Loan Amount - Principal amount disbursed
  • Interest Rate - Annual interest rate
  • Tenure - Loan period in months
  • Repayment Frequency - Monthly, weekly, or custom intervals

Learn More

Understand repayment calculation and schedule generation.

Integration Quick Start

Before you begin:
1

Get API Credentials

Contact our team to receive your sandbox API keys and base URL.
2

Review API Documentation

Familiarize yourself with our Lending API Reference.
3

Understand the Flow

Read through the Application Flow to understand the complete loan journey.

Complete API Reference

Explore all available lending endpoints with request/response examples.

Loan Application Process

1. Customer Applies for Loan

Customers select a loan product and submit an application with:
  • Requested loan amount
  • Preferred tenure (if applicable)
  • Eligibility question answers
  • Additional documentation (if required)

2. System Processing

The system automatically:
  • Validates application data
  • Checks eligibility criteria
  • Performs initial credit assessment
  • Routes to appropriate workflow

3. Manual/Automatic Underwriting Review

Loan officers review applications and:
  • Assess creditworthiness
  • Verify customer information
  • Make approval/rejection decisions
  • Set final loan terms (amount, rate, tenure)

4. Offer & Acceptance

Once approved:
  • System sends loan offer to customer with terms
  • Customer reviews and accepts the offer
  • And then proceeds to also accept the loan terms
  • Application status updates to ACCEPTED

5. Loan Disbursement & Withdrawal

Once the offer is accepted:
  • A wallet account is automatically created for the customer
  • The loan amount is disbursed into this wallet
  • Customers can view their total approved loans
To access the funds:
  1. Add Bank Account - Customer verifies and adds their bank account
  2. Withdraw Funds - Initiate transfer from wallet to bank account
  3. Transfer History - Track status of all withdrawals
Withdrawals attract a small processing fee (e.g., 10 Naira) applied by the payment processor.

6. Repayment Management

Customers make repayments and the system:
  • Tracks payment history
  • Updates loan balance
  • Manages overdue accounts
  • Generates reports

View Complete Flow

Detailed step-by-step process flow.

Supported Features

Automated Eligibility Checks

  • Product-specific eligibility rules
  • Dynamic field requirements
  • Real-time validation
  • Automated decision making (where applicable)

Credit Bureau Integration

  • Real-time credit checks
  • Credit score retrieval
  • Credit report analysis
  • Risk assessment

Flexible Repayment Options

  • Multiple payment methods (wallet, bank transfer, cash)
  • Partial repayments
  • Early settlement
  • Payment rescheduling (with approval)

Learn More

Explore repayment options and processes.

Testing & Sandbox

We provide a full-featured sandbox environment for testing:
  • Sandbox URL: https://{domain}.fincode.software
  • Test credentials: Provided upon registration
  • Mock credit bureau: Simulate credit checks
  • No real money: All transactions are simulated
Use the sandbox to test all flows, edge cases, and error handling before going live.

Integration Models

We support flexible integration approaches:

End-to-End Integration

Build the complete lending experience within your application, managing the entire customer journey from application to repayment.Flow:
  1. Customer registration and KYC
  2. Loan product selection
  3. Application submission
  4. Underwriting and approval
  5. Disbursement
  6. Repayment management
Documentation:

Next Steps