Core Components

The key building blocks that power the eVoucher platform

System Architecture

flowchart TD
    subgraph Platform["Platform (Ommiii)"]
        VMS[Voucher Management System]
        Admin[Admin Interface]
        API[API Services]
        Security[Security Layer]
    end
    
    subgraph Merchant["Merchant Components"]
        Portal[Merchant Portal]
        VerifyApp[Verification Application]
        POS[POS Integration]
    end
    
    subgraph User["User Components"]
        UI[User Interface]
        Wallet[Voucher Wallet]
        QR[QR Code Display]
    end
    
    VMS --> API
    Admin --> VMS
    API --> Portal
    API --> UI
    Portal --> VerifyApp
    VerifyApp --> POS
    UI --> Wallet
    Wallet --> QR

1. Platform (Ommiii) Components

Voucher Management System

The core data management system for all voucher operations.

Database Structure
  • Voucher Templates: Name, description, value, validity period, T&Cs
  • Generated Voucher Instances: Unique codes, status, redemption data
  • Merchant Profiles: Account details, branding, locations
  • User Voucher Wallets: Assigned vouchers, purchase/redemption history

Admin Interface

Management console for platform administrators.

Key Features
  • Voucher Approval Workflow:

    Review, approve/reject, and manage merchant voucher submissions with customizable approval criteria

  • Merchant Management:

    Onboarding, verification, account status, performance metrics

  • Analytics Dashboard:

    Sales performance, redemption rates, merchant adoption metrics

  • Ecosystem Partner Management:

    Integration settings, partner access controls, API usage monitoring

API Services

Secure endpoints connecting all platform components.

Core APIs
  • Voucher Creation API:

    Endpoints for merchants to design and submit vouchers for approval

  • Code Generation Service:

    Creates secure, unique voucher codes and QR codes for verification

  • Verification API:

    Validates voucher authenticity and eligibility for redemption

  • Redemption Tracking API:

    Records and processes voucher redemption events

Security Requirements

Comprehensive security measures to protect voucher integrity.

Security Features
  • Secure Code Generation Algorithm:

    Cryptographically secure codes with checksum validation and collision prevention

  • Anti-fraud Mechanisms:

    Rate limiting, unusual activity detection, duplicate redemption prevention

  • Encryption:

    End-to-end encryption for voucher data in transit and at rest

  • Authentication:

    OAuth 2.0 implementation for all API endpoints with role-based access control

2. Merchant-Side Components

Merchant Portal

Self-service interface for merchants to manage vouchers.

Key Features
  • Voucher Creation Interface:

    Drag-and-drop design tool with templates, custom branding, and value settings

  • Redemption History:

    Detailed logs of all voucher redemptions with time, location, and value data

  • Analytics Dashboard:

    Performance metrics, redemption trends, customer acquisition data

  • Account Management:

    Profile settings, staff access controls, integration configuration

Merchant Counter App

Dedicated application for merchants to validate and invalidate vouchers at the point of sale.

Key Features
  • QR Code Scanner:

    Scan customer voucher codes directly from the Ommiii app

  • Instant Validation:

    Real-time verification of voucher authenticity and validity

  • Voucher Invalidation:

    Immediately mark vouchers as used after successful redemption

  • Transaction History:

    Record of all redemptions with timestamps and staff identification

POS Integration Approach

Flexible options for integrating with existing merchant POS systems.

Minimal Approach

Uses existing discount/promotion code fields in the POS system.

  • No POS system changes required
  • Works with any existing POS
  • Lowest implementation effort
Implementation Steps:
  1. Merchant verifies voucher via Ommiii app
  2. Upon verification, enters code into POS
  3. POS treats it as a standard discount code
  4. Transaction completes in POS as normal

3. User-Side Components

User Interface

The end-user experience for discovering, acquiring, and using vouchers.

Key Features
  • Voucher Discovery:

    Browse available vouchers by category, merchant, or value

  • Purchasing/Claiming:

    Secure checkout process for paid vouchers or redemption flow for promotional offers

  • Voucher Wallet:

    Digital storage for all acquired vouchers with expiration notifications

  • QR Code Display:

    Easy access to voucher QR codes for in-store redemption

  • Redemption History:

    Transaction records for all voucher usage

  • Notification System:

    Alerts for new offers, expiring vouchers, and successful redemptions

User Flow Visualization
flowchart TD
    B[Browse Vouchers] --> C{Purchase or Claim}
    C -->|Purchase| D[Payment Process]
    C -->|Free Claim| E[Add to Wallet]
    D --> E
    E --> F[Use at Merchant]
    F --> G[Scan QR Code]
    G --> H[Verification]
    H --> I[Redemption Complete]

Typical user journey from discovery to redemption