Skip to main content
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.

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).

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.

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.

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.

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.

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

6.3 Track Repayment History

Customers can view their complete repayment history and loan details.

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.