Technical Specifications v1.0

This documentation serves as the authoritative blueprint for Edupro Pay, a high-concurrency payment gateway integrated with ESMS. The system is designed for Zimbabwe’s regulatory environment with strong focus on data sovereignty, dual-currency reconciliation, and high-performance infrastructure.

1. System Architecture Overview

Logic Layer: Python / Frappe (Event-driven)

Database: MariaDB (Primary) + Redis (Caching)

Infrastructure: ZCHPC (High Performance Computing)

Communication: REST APIs + ISO 8583 bridge

2. Technology Stack

Layer	Technology	Purpose
Backend	Python / Frappe	Business logic & API routing
Database	MariaDB	Financial & student records
Caching	Redis	High concurrency performance
Frontend	Vue.js / Tailwind	Mobile-first UI
Hosting	ZCHPC	Local data residency
Security	AES-256 / HMAC-SHA256	Encryption & verification

3. Core Modules & API Integrations

3.1 Zimswitch ISO 8583 Bridge

Protocol: TCP/IP Socket
Encryption: TMK / Session Keys
Function: Processes bank transfers & card payments

3.2 Ecocash API

Endpoint:

https://api.ecocash.co.zw/v1/transaction

Push-to-pay USSD requests
Dynamic USD / ZiG routing

3.3 Diaspora Portal

Visa / Mastercard integration
Direct settlement to Nostro accounts
Donation tracking via unique IDs

4. Compliance Engine (IAS 21)

Stores:

Functional Amount (USD)
Exchange Rate
Presentation Amount (ZiG)

Generates real-time audit-ready reports.

5. Security & Data Protection

5.1 Data Sovereignty

Hosted locally at ZCHPC in compliance with Zimbabwe Data Protection laws.

5.2 Offline Sync Protocol

Transactions logged locally
Marked PENDING_RECON if timeout occurs
Auto-reconciled via background workers

6. Implementation Roadmap

Phase 1: ISO 8583 Sandbox Testing

Phase 2: Migration to ZCHPC

Phase 3: Ecocash Gateway Launch

Phase 4: National Rollout