jibrilmohamedahmed/Flamingo-Pay

Voice-first UPI & eKYC platform for financial inclusion in Africa # Flamingo Pay – Technical Documentation **Version:** 1.0 **Maintainer:** SahanTech Solutions **Contact:** jebrildomenico@gmail.com --- ## Overview **Flamingo Pay** is a **voice-first Unified Payment Interface (UPI)** app that empowers **visually impaired and digitally excluded users** to access and control their finances through **spoken commands**, **secure eKYC onboarding**, and **multilingual accessibility**. Flamingo is built in Ethiopia for Africa — focused on dignity, access, and inclusion. --- ## System Architecture ```text Flutter Mobile App ↕︎ Google Cloud Speech-to-Text (STT) Google Cloud Text-to-Speech (TTS) ↕︎ Backend API (Node.js + Express) ↕︎ UPI Engine (custom logic + EthSwitch gateway) ↕︎ Database (MongoDB Atlas) ↕︎ eKYC Engine (OCR, voice biometric, liveness) ``` --- ## Core Modules & Technologies ### 1. Voice Interaction (No Screen Required) - **Google Cloud Speech-to-Text** – Processes user voice commands - **Google Cloud Text-to-Speech** – Reads system responses aloud - **Flutter** – Front-end built with cross-platform UI toolkit - **Amharic + English** – Language selection via voice ### 2. Authentication & eKYC - **Voice PIN** – Spoken numeric PIN used to log in - **Voice Biometrics** – Used to confirm user identity - **eKYC Document Capture** – Via phone camera - **OCR** – Custom backend with Tesseract.js for ID scanning - **Liveness Check** – Randomized voice phrase matching ### 3. UPI Transaction Engine - Built in **Node.js (Express)** - Handles: - `check_balance` - `send_money` - `transaction_history` - Future-ready integration with **EthSwitch API** --- ## Security Stack | Layer | Tool | |-------|------| | HTTPS | TLS 1.3 via Nginx Reverse Proxy | | Data encryption | AES-256 for at-rest, TLS for in-transit | | Auth | JWT Tokens (signed + expiring) | | Biometric Handling | Stored as encrypted voice hash | | Logging | Winston logger + audit trail per transaction | --- ## API Overview | Endpoint | Method | Descript …