🏦 VaultX - Secure Payment Platform

Amazon HackOn Season 5 Submission
A middleware solution integrated with Amazon Pay with SmartCoins rewards and Offline Payment Storing (SnapPay).

🌐 Vercel Link

Live Demo: VaultX - Secure Payment Platform Default PIN: 123456

Presentation: Team What-If - VaultX Project Presentation

Demo Video in YT: Demo Video of showcasing the entire prototype and its functionalities

🚀 Overview

VaultX is a middleware prototype solution integrated with Amazon Pay, to help users experience a more smoother payment experience. Equipped with SnapPay, Our Offline Payment system with Smartcoins that refund whenever there is a price drop post-purchase, VaultX is a solution that not only benefits Tier 2/3 Rural Users who have low connectivity of internet, but also those people who have a hard time buying products with digital money.

🎯 Project Goals

Secure Payments: Biometric authentication and PIN-based security
Smart Rewards: SmartCoins system for customer loyalty
Trust Scoring: Advanced seller trust and safety metrics
Offline-First: Robust offline payment processing
Price Intelligence: Real-time price tracking and history
Automated Refunds: AWS Lambda-powered automatic refund processing

✨ Features

💳 Payment Features

Biometric Authentication: Face-ID and PIN-based security
Offline Processing: Payments work without internet connection
Transaction Sync: Automatic synchronization when online
Multi-factor Security: PIN lockout protection and retry limits

🪙 SmartCoins System

Refund Rewards: Earn SmartCoins from product refunds
Balance Tracking: Real-time SmartCoins balance
Transaction History: Complete refund and reward history
Price History Access: Direct access to product price charts

🛡️ Trust & Safety

Seller Trust Scoring: Multi-dimensional trust analysis
Safe Shopping Score: Comprehensive safety metrics
Price Drop Tracking: Monitor product price changes
Refund Rate Analysis: Seller reliability indicators

📊 Analytics & Insights

Price History Dashboard: Interactive price charts
Seller Performance: Detailed seller analytics
Transaction Monitoring: Real-time payment tracking
Network Status: Connectivity monitoring

🤖 Automated Refund Processing

Price Change Detection: AWS Lambda monitors product price changes
Automatic Refund Calculation: Intelligent refund amount computation
Backend Integration: Seamless refund processing through API
Frontend Updates: Real-time SmartCoins balance updates
Transaction History: Complete audit trail of automatic refunds

🏗️ Architecture

VaultX/
├── app/                          # Next.js App Router
│   ├── api/                      # API Routes
│   │   ├── products/             # Product management
│   │   ├── smartcoins/           # SmartCoins system
│   │   ├── seller-trust/         # Trust scoring
│   │   └── transactions/         # Payment processing
│   ├── components/               # React components
│   ├── dashboard/                # Analytics dashboard
│   ├── vaultx/                   # Main VaultX interface
│   └── auth/                     # Authentication pages
├── components/                   # Shared UI components
├── lib/                          # Utility functions
├── public/                       # Static assets
└── styles/                       # Global styles

AWS Infrastructure/
├── DynamoDB/                     # NoSQL database
│   ├── products/                 # Product data
│   ├── price_history/            # Price change tracking
│   ├── refunds/                  # Refund records
│   └── transactions/             # Payment transactions
├── Lambda Functions/             # Serverless processing
│   ├── price-change-monitor/     # Price change detection
│   ├── refund-calculator/        # Refund amount computation
│   └── smartcoins-updater/       # Balance updates

🛠️ Tech Stack

Frontend

Next.js 15.2.4 - React framework with App Router
TypeScript 5.0 - Type-safe JavaScript
Tailwind CSS 3.4.17 - Utility-first CSS framework
Radix UI - Accessible component primitives
Lucide React - Beautiful icons
Chart.js - Interactive charts and graphs

Backend & Database

AWS DynamoDB - NoSQL database for scalability
AWS Lambda - Serverless functions for automated processing
Next.js API Routes - Serverless API endpoints
IndexedDB - Client-side data storage
LocalStorage - Fallback storage

Authentication & Security

Biometric Auth - Face-ID and PIN security
PIN Management - Secure PIN storage and validation
Offline Security - Local data encryption

Development Tools

ESLint - Code linting
PostCSS - CSS processing
Autoprefixer - CSS vendor prefixing

📦 Installation

Prerequisites

Node.js 18+
npm or pnpm
AWS Account (for DynamoDB)

Setup Instructions

Clone the repository

git clone https://github.com/yourusername/Amazon-HackOn-Season-5.git
cd Amazon-HackOn-Season-5

Install dependencies

npm install (if this fails then use npm install -legacy -peer -deps)
# or
pnpm install

Environment Configuration Create a .env.local file:

AWS_REGION=eu-north-1
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key

Run the development server
```
npm run dev
# or
pnpm dev
```
Open your browser Navigate to http://localhost:3000

🔧 Configuration

AWS DynamoDB Setup

Create DynamoDB Tables

# Products table
aws dynamodb create-table \
  --table-name products \
  --attribute-definitions AttributeName=id,AttributeType=N \
  --key-schema AttributeName=id,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

# Price history table
aws dynamodb create-table \
  --table-name price_history \
  --attribute-definitions AttributeName=id,AttributeType=S \
  --key-schema AttributeName=id,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

# Refunds table
aws dynamodb create-table \
  --table-name refunds \
  --attribute-definitions AttributeName=id,AttributeType=S \
  --key-schema AttributeName=id,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

# Transactions table
aws dynamodb create-table \
  --table-name transactions \
  --attribute-definitions AttributeName=id,AttributeType=S \
  --key-schema AttributeName=id,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

Configure IAM Permissions Ensure your AWS credentials have DynamoDB read/write permissions.

Seller Trust Modal

// Comprehensive seller trust analysis
<SellerDetailModal 
  sellerId="seller_001"
  isOpen={true}
  onClose={handleClose}
/>

🚀 Usage

For Customers

Browse Products: Visit the homepage to see featured products
Make Payment: Click "Pay Now" and authenticate with PIN
Earn SmartCoins: Get rewarded for refunds and price drops
Track History: View transaction and price history

For Developers

API Integration: Use the RESTful API endpoints
Custom Components: Extend the UI component library
Database Operations: Work with DynamoDB tables
Authentication: Implement custom auth flows

📊 API Endpoints

Products

GET /api/products/[id] - Get product details
PATCH /api/products/[id]/price - Update product price
POST /api/products/[id]/price-drop - Process price drop
GET /api/products/[id]/price-history - Get price history

SmartCoins

GET /api/smartcoins?userId={id} - Get user's SmartCoins balance

Seller Trust

GET /api/seller-trust - Get all sellers with trust scores
GET /api/seller-trust?sellerId={id} - Get specific seller details

Transactions

POST /api/transactions - Process payment transactions

🎯 Key Components

BiometricAuth Component

// Secure PIN-based authentication with offline support
<BiometricAuth 
  onSuccess={handleTransactionSuccess}
  onError={handleError}
  amount={100}
  productId="123"
/>

Price History Dashboard

// Interactive price charts with real-time data
<PriceHistoryChart 
  productId="123"
  data={priceHistoryData}
/>

Seller Trust Modal

🔐 Security Features

Authentication

6-digit PIN: Secure numeric authentication
Lockout Protection: 5 failed attempts trigger 20-second lockout
Biometric Support: Face-ID authentication ready
Offline Security: Local data protection

Data Protection

Encrypted Storage: Sensitive data encryption
Secure APIs: Parameterized queries prevent injection
Network Security: HTTPS enforcement
Session Management: Secure session handling

Privacy

User Anonymization: User ID generation
Data Minimization: Only necessary data collection
Local Processing: Offline-first approach

🤖 AWS Lambda Configuration

Automated Refund Processing Setup

Create Lambda Functions

# Price Change Monitor Lambda
aws lambda create-function \
  --function-name vaultx-price-change-monitor \
  --runtime nodejs18.x \
  --handler index.handler \
  --role arn:aws:iam::YOUR_ACCOUNT:role/lambda-execution-role \
  --zip-file fileb://price-change-monitor.zip

# Refund Calculator Lambda
aws lambda create-function \
  --function-name vaultx-refund-calculator \
  --runtime nodejs18.x \
  --handler index.handler \
  --role arn:aws:iam::YOUR_ACCOUNT:role/lambda-execution-role \
  --zip-file fileb://refund-calculator.zip

# SmartCoins Updater Lambda
aws lambda create-function \
  --function-name vaultx-smartcoins-updater \
  --runtime nodejs18.x \
  --handler index.handler \
  --role arn:aws:iam::YOUR_ACCOUNT:role/lambda-execution-role \
  --zip-file fileb://smartcoins-updater.zip

Lambda Function Workflow

// Price Change Monitor Lambda
export const handler = async (event: any) => {
  const { productId, oldPrice, newPrice } = event.detail;
  
  // Check if refund is applicable
  if (newPrice < oldPrice) {
    const refundAmount = oldPrice - newPrice;
    
    // Trigger refund calculation
    await lambda.invoke({
      FunctionName: 'vaultx-refund-calculator',
      Payload: JSON.stringify({ productId, refundAmount })
    });
  }
};

Environment Variables

# Lambda Environment Variables
DYNAMODB_TABLE_NAME=vaultx_refunds
API_ENDPOINT=https://your-api.vercel.app/api
SMARTCOINS_RATE=1.0

📱 Screenshots

Main Interface

SmartCoins Dashboard

Price History Charts

Seller Trust Analysis

🙏 Acknowledgments

Amazon Web Services for DynamoDB and Lambda infrastructure
Next.js Team for the amazing framework
Tailwind CSS for the utility-first CSS framework
Radix UI for accessible components
HackOn Season 5 organizers for the opportunity
Nikhil for building the APIs and Backend
Shreelekha for building the Face-ID Biometric and PPT
Mansi for building the Seller Trust and UI and PPT

Built with ❤️ for Amazon HackOn Season 5

Name		Name	Last commit message	Last commit date
Latest commit History 23 Commits
app		app
components/ui		components/ui
hooks		hooks
lib		lib
public		public
screenshots		screenshots
.gitignore		.gitignore
README.md		README.md
Team What-If_National Institute of Technology, Jamshedpur.pdf		Team What-If_National Institute of Technology, Jamshedpur.pdf
components.json		components.json
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

🏦 VaultX - Secure Payment Platform

🌐 Vercel Link

📋 Table of Contents

🚀 Overview

🎯 Project Goals

✨ Features

💳 Payment Features

🪙 SmartCoins System

🛡️ Trust & Safety

📊 Analytics & Insights

🤖 Automated Refund Processing

🏗️ Architecture

🛠️ Tech Stack

Frontend

Backend & Database

Authentication & Security

Development Tools

📦 Installation

Prerequisites

Setup Instructions

🔧 Configuration

AWS DynamoDB Setup

Seller Trust Modal

🚀 Usage

For Customers

For Developers

📊 API Endpoints

Products

SmartCoins

Seller Trust

Transactions

🎯 Key Components

BiometricAuth Component

Price History Dashboard

Seller Trust Modal

🔐 Security Features

Authentication

Data Protection

Privacy

🤖 AWS Lambda Configuration

Automated Refund Processing Setup

📱 Screenshots

Main Interface

SmartCoins Dashboard

Price History Charts

Seller Trust Analysis

🙏 Acknowledgments

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages