System Requirements Document (SRD)

Project Name: mint-payment

1. Introduction

The mint-payment project aims to create a seamless and efficient payment gateway system tailored for users in India. This system will integrate UPI-based payments, QR code scanning, and subscription management to simplify transactions for users and administrators. The design will follow the visual reference provided, ensuring a clean, functional, and user-friendly interface.

2. System Overview

The mint-payment system will provide the following core functionalities:

• UPI-based payment integration using identifier 9947852151.
• QR code scanning for quick payment processing.
• Subscription management for different tiers (Starter, Pro, Premium).
• Payment verification using UTR (Unique Transaction Reference) numbers.
• A responsive interface optimized for both web and mobile platforms.

The system will leverage modern technologies such as React, FastAPI, and MySQL to ensure scalability, security, and performance.

3. Functional Requirements

User Stories:

• As a User, I should be able to scan the provided QR code to initiate UPI payments.
• As a User, I should be able to input my UTR number to verify payment.
• As an Admin, I should be able to manage subscription tiers (Starter, Pro, Premium).
• As an Admin, I should be able to view and track payment statuses.
• As a Guest, I should be able to view subscription options and payment methods.

4. User Personas

1. User

• Primary user of the payment gateway.
• Can scan QR codes, make payments, and verify transactions.

2. Admin

• Manages subscription tiers and monitors payment statuses.
• Ensures system functionality and resolves payment issues.

3. Guest

• Browses subscription options and payment methods without making transactions.

5. Visuals Colors and Theme

Color Palette:

Based on the visual reference provided, the following color palette is proposed:

• Background: #F5F5F5 (Light Gray)
• Surface: #FFFFFF (White)
• Text: #333333 (Dark Gray)
• Accent: #4285F4 (Google Blue)
• Muted Tones: #E0E0E0 (Soft Gray)

6. Signature Design Concept

Concept: Interactive QR Code Payment Gateway

The homepage will feature a dynamic QR code interface as the centerpiece. Users will see the QR code prominently displayed, surrounded by animated elements that guide them through the payment process.

Features:

• Hover Animation: When users hover over the QR code, a subtle glow effect will highlight the code, emphasizing its importance.
• Interactive Payment Flow: Clicking the QR code will initiate a step-by-step guide overlay, explaining how to scan and complete the payment.
• Subscription Tiers: Below the QR code, subscription options (Starter, Pro, Premium) will be displayed as interactive cards that expand on hover to show details.
• Micro-Interactions: Buttons and fields will have smooth transitions and feedback animations (e.g., color shifts, slight scaling).

This design ensures the payment gateway is visually engaging and intuitive for users.

7. Non-Functional Requirements

• Performance: The system should process transactions within 2 seconds.
• Scalability: Must support up to 1 million users concurrently.
• Security: All payment data must be encrypted using AES-256.
• Availability: 99.9% uptime guaranteed.
• Localization: Default language set to English, with support for Hindi and other regional languages.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile

Backend

• Python
• FastAPI

Database

• MySQL (preferred)
• Alembic for migrations

AI Tools

• GPT 5.4 for user-friendly responses

Orchestration

• Docker for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

Assumptions:

• Users will primarily use UPI for payments.
• Admins will have access to a secure dashboard for managing subscriptions.

Constraints:

• The system must comply with Indian payment regulations (e.g., NPCI guidelines).
• Limited to UPI and QR code-based payments initially.

10. Glossary

• UPI: Unified Payments Interface, a real-time payment system developed by NPCI.
• UTR: Unique Transaction Reference, used to verify payments.
• NPCI: National Payments Corporation of India, governing body for payment systems in India.
• AES-256: Advanced Encryption Standard, a secure encryption method.