TsogoloPay API, DB, ActiveMQ Artemis and Redis Cache - Payments (Collection, Disbursement and Settlement) Platform

Development of a payments platform for TsogoloPay, a small, minimal direct charge-style payment gateway for small businesses in Malawi

Contents

• Ecoride API, DB and Redis Cache - Rideshare Platform
  • Contents
  • Developers
  • Technology Stack
  • Features
    • Core Platform Features
    • API Capabilities
    • Security
  • Frontend Applications
    • driver-admin (Admin Portal)
    • Shared UI Components
  • Repository Management
  • Documentation
    • Quick Navigation
    • API Documentation
    • Architecture Documentation
    • Implementation Guides
    • Database Setup
    • Integration Documentation
    • Technical References
  • Project Structure
  • Quick Start
    • Prerequisites
    • Google Maps Setup
    • Preferred 1: Docker Compose (Recommended)
    • Option 2: Local Development
  • API Documentation
    • Feeding in External API Keys
    • Base URL
    • Authentication Endpoints
      • Register New User
      • Login with Email/Password
      • Request OTP (Phone Login)
      • Login with Phone/OTP
      • Refresh Access Token
    • Ride Endpoints
      • Get Pricing Estimate
      • Request Ride (Immediate)
      • Request Scheduled Ride
      • Get Ride Details
      • Cancel Ride
      • Get Ride History
    • Driver Endpoints
      • Find Nearby Drivers
    • Places & Navigation Endpoints (Google Maps Integration)
      • Autocomplete Place Search (All Users)
      • Get Place Details (All Users)
      • Geocode Address (All Users)
      • Reverse Geocode (All Users)
      • Get Turn-by-Turn Navigation (Drivers Only)
      • Get Route Alternatives (Drivers Only)
  • Configuration
    • Environment Variables - Only the Production Version
    • Pricing Formula
    • Driver Matching Algorithm
    • Scheduled Ride Dispatch
  • Testing
  • Docker Commands
  • Database Schema
  • Security
  • Monitoring
  • Development
    • Adding a New Entity
    • Adding a New Endpoint
  • Roadmap
    • Completed
    • In Progress
    • Planned
  • Contributing
  • License
  • Author
  • GitHub: Paul Namalomba

Developers

• Front-End + Web + Me + Backend + DBs + APIs + Cache: Mr. Paul Namalomba - GitHub | Email

Technology Stack

Component	Technology	Version
Backend API	C# .NET 8 + ASP.NET Core	8.0
ORM	Entity Framework Core + NetTopologySuite	8.0
Database	PostgreSQL + PostGIS	15+
Cache/Sessions	Redis	7.0+
Message Broker & Job Queue	ActiveMQ Artemis	2.30+
Real-time	SignalR	8.0
Dependency Injection	Built-in .NET DI	8.0
PayChangu	PayChangu API	1.0+
Authentication	JWT + BCrypt	-
API Docs	Swagger/OpenAPI	6.5
Logging	Serilog	8.0

Features

We seek s simple cycle of features centered around core payment functionalities:

• In-store QR Code Payments