• Multi-Merchant Support - Onboard and manage multiple merchants
• T+0/T+1/T+2 Settlement Cycles - Configurable per merchant
• Double-Entry Ledger - Append-only accounting for all financial events
• Batch Processing - Handle high-volume transaction settlement

• Exact Matching - 100% field match
• Fuzzy Matching - Configurable tolerance for amounts
• Partial Matching - Match on subset of fields
• Manual Resolution - Admin override for edge cases

• Dashboard KPIs - Transaction volume, match rate, settlement status
• 7-Day Trends - Volume and count charts
• Alert System - Threshold-based notifications
• Audit Trail - Immutable action logging

• JWT Authentication - Secure token-based auth
• Role-Based Access Control - Admin, Finance Ops, Merchant roles
• Rate Limiting - Protect against abuse
• Idempotent Operations - Prevent duplicate transactions

The platform features a Violet/Emerald gradient theme with:

• 🌌 Mesh gradient backgrounds with animated floating elements
• 💜 Glassmorphism cards with violet glow effects
• ✨ Gradient accents throughout the interface
• 🎯 Responsive design for all screen sizes

• Node.js 18+
• PostgreSQL 14+
• npm or yarn

# Clone repository
git clone https://github.com/yourusername/payment-settlement.git
cd payment-settlement

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

Create .env file in /backend:

# Environment
NODE_ENV=development
PORT=3001

# Database
DATABASE_URL="postgresql://postgres:YOUR_PASSWORD@localhost:5432/payment_settlement?schema=public"

# JWT
JWT_SECRET=your-secure-secret-key
JWT_EXPIRES_IN=24h

# Settlement
SETTLEMENT_CUTOFF_HOUR=23
SETTLEMENT_CUTOFF_MINUTE=59
DEFAULT_MERCHANT_FEE_PERCENT=2.5

# Rate Limiting
RATE_LIMIT_MAX_REQUESTS=1000

cd backend

# Generate Prisma client
npx prisma generate

# Push schema to database
npx prisma db push

# Seed sample data
npm run db:seed

# Terminal 1: Backend (port 3001)
cd backend
npm run dev

# Terminal 2: Frontend (port 5173)
cd frontend
npm run dev

payment-settlement/
├── backend/
│   ├── prisma/
│   │   ├── schema.prisma     # Database schema (14 models)
│   │   └── seed.js           # Sample data seeder
│   └── src/
│       ├── config/           # Configuration & database
│       ├── middleware/       # Auth, RBAC, validation
│       ├── routes/           # API endpoints
│       ├── services/         # Business logic
│       └── jobs/             # Cron jobs
│
├── frontend/
│   └── src/
│       ├── components/       # Layout, UI components
│       ├── context/          # Auth context
│       ├── pages/            # 10 main pages
│       └── services/         # API client
│
└── README.md

MIT License - See LICENSE for details.