Process Flow

This guide details the complete customer journey for digital lending, from application to disbursement and withdrawal.

The flow covers Application, Offer, Acceptance, Disbursement, Withdrawal, and Repayment.

Phase 1: Loan Application

1.1 Product Selection & Eligibility

The customer starts by viewing available loan products and answering eligibility questions.

List Products

View available loan products

Get Questions

View dynamic eligibility questions

Application Steps

1. Select Product

   Customer views the list of available loan products and selects one.

2. Check Eligibility

   System returns dynamic eligibility questions based on the selected product.

3. Submit Details

   Customer provides answers along with key details:

   • Employment Status
   • BVN
   • Phone Number
   • Monthly Income
   • Country

Phase 2: Processing & Offer

2.1 Status & Offer Generation

After submission, the application undergoes review (manual or automated).

Check History

View loan history

Get Offer

View loan offer

Phase 3: Acceptance

3.1 Accept or Reject Offer

The customer reviews the loan offer and terms.

1. Review Offer

   Customer sees the approved amount (which may be less than or equal to requested).

2. Accept/Reject

   Customer proceeds to accept or reject the loan offer.

3. Terms Agreement

   If accepting, customer accepts the specific loan terms.

Accept Offer

Accept loan offer

Reject Offer

Reject loan offer

Accept Terms

Accept loan terms

Phase 4: Disbursement & Wallet

4.1 Wallet Creation

Once the loan is disbursed by the admin:

1. A wallet account is automatically created for the customer.
2. The loan amount is credited to this wallet.
3. The customer can view their total approved loans.

Get Total Loan

View total approved loans

Phase 5: Withdrawal

5.1 Add Bank Account

To withdraw funds, the customer must first add a valid bank account.

Get Banks

View available banks

Verify Account

Verify bank account

5.2 Withdraw Funds

The customer transfers funds from their wallet to their bank account.

A processing fee (e.g., 10 Naira) is applied to withdrawals.

1. Select Source: Choose the DISBURSED loan/wallet.
2. Select Destination: Choose a saved customer bank account.
3. Enter Details: Input amount and optional narration.
4. Confirm: Send funds.

List Bank Accounts

View customer bank accounts

5.3 Track Transfers

Customers can view the history and status of their transfers.

Transfer History

View transfer history

Manage Loans

Manage loans

Phase 6: Repayment

After loan disbursement, customers need to make repayments according to their loan schedule. The system supports both partial repayments and full payoff.

6.1 View Repayment Information

Customers can view their pending repayments and get detailed repayment instructions.

Pending Repayments

View pending repayments

Repayment Instructions

Get repayment instructions

6.2 Make Repayment

Customers can make partial repayments or pay off the entire loan.

Partial Repayment:

1. Customer makes a bank transfer to the provided account with repayment reference
2. Customer records the repayment via API: POST /repay-loan/{user-id}
3. System records repayment with status PENDING_VERIFICATION
4. System verifies payment and updates loan balance

Full Payoff:

1. Customer initiates payoff: POST /payoff-loan
2. System calculates total balance (principal + accrued interest)
3. Customer makes payment and records it
4. System verifies and closes the loan

Repay Loan

Make partial repayment

Payoff Loan

Pay off entire loan

6.3 Track Repayment History

Customers can view their complete repayment history and loan details.

List Repayments

View repayment history

Loan Details

View loan with payment history

Complete Repayment Flow

See detailed repayment flow documentation with diagrams and examples.

Some loans may use third-party collection services. In such cases, manual repayments via API may not be allowed. Always check the loan’s repayment collection configuration.