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
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.Phase 4: Disbursement & Wallet
4.1 Wallet Creation
Once the loan is disbursed by the admin:- A wallet account is automatically created for the customer.
- The loan amount is credited to this wallet.
- 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.
- Select Source: Choose the DISBURSED loan/wallet.
- Select Destination: Choose a saved customer bank account.
- Enter Details: Input amount and optional narration.
- 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:- Customer makes a bank transfer to the provided account with repayment reference
- Customer records the repayment via API:
POST /repay-loan/{user-id} - System records repayment with status
PENDING_VERIFICATION - System verifies payment and updates loan balance
- Customer initiates payoff:
POST /payoff-loan - System calculates total balance (principal + accrued interest)
- Customer makes payment and records it
- 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.
