CyberDemon73 / Transaction-Fraud-Detection-System

This system merges card management with transaction processing, emphasizing real-time fraud detection. It uses advanced algorithms to identify suspicious activities, offering a user-friendly interface and robust technologies like Python and Flask for secure financial operations.

Card Management and Transaction Processing System

The Card Management and Transaction Processing System integrates card management (CMS) with advanced transaction processing (TXN), focusing on real-time fraud detection. It employs sophisticated algorithms to flag unusual transaction patterns, enhancing security in financial operations. The system combines user-friendly interfaces with robust back-end technologies, including Python, Flask, and SQLite, to efficiently manage and monitor card-related services and transactions. Its standout feature is the proactive detection and mitigation of fraudulent activities, showcasing practical applications of fraud detection in digital finance.

Table of Contents

• Architecture
• Features
  • Card Management System (CMS)
  • Transaction Processing System (TXN)
• Technologies Used
• Setup
• Docker Setup
• Usage
• Error Handling
• Logging
• Security
• Monitoring
• Key Functions
  • Card Generation
  • Risk Calculations
  • Fraud Detection Cases
• Contributing
• License

Architecture

The Card Management and Transaction Processing System is designed as a client-server architecture with two main components:

Card Management System (CMS):

• Responsible for managing cards, including card issuance, balance adding, and bin management.
• Handles user authentication and authorization.
• Provides a user-friendly web interface for administrators.

Transaction Processing System (TXN):

• Manages real-time transaction tracking and risk assessment.
• Calculates transaction risk scores based on various factors.
• Includes fraud detection mechanisms and logs suspicious transactions.

Both components share a common database to store card and transaction data, allowing seamless integration and communication between the CMS and TXN.

Features

Card Management System (CMS)

• Bin Adding:
  • Add and manage BIN (Bank Identification Number) details.
  • Perform operations related to BIN management.
• Card Issuing:
  • Issue new cards to customers.
  • Configure card details such as card number, cardholder name, expiry date, and CVV.
• Balance Adding:
  • Add funds to existing cards.
  • Manage card balances efficiently.

Transaction Processing System (TXN)

• Transaction Tracking:
  • Track card transactions in real-time.
  • Calculate transaction risk scores based on various factors.
  • Log transaction details for auditing and monitoring.

Technologies Used

• Frontend: HTML, CSS, JavaScript
• Backend: Python with Flask framework
• Database: SQLite for data storage
• Authentication: Flask-Login for user authentication
• Logging: Python logging library

Setup

Follow these steps to set up the Card Management and Transaction Processing System on your local machine:

# Clone the repository
git clone https://github.com/CyberDemon73/Transaction-Fraud-Detection-System.git

# Navigate to the project directory
cd cms-txn-project

# Create a virtual environment (recommended)
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS and Linux:
source venv/bin/activate

# Install project dependencies
pip install -r requirements.txt

# Initialize the database
flask db init
flask db migrate
flask db upgrade

# Start the application
flask run

#OR
python3 CMS.py

# In another window in the same directory
python3 TXN.py

Open your web browser and go to http://localhost:5000 to access the CMS (Card Management System).

Open your web browser and go to http://localhost:5002 to access the TXN (Transaction Server).

Docker Setup

To create a Docker image for your project and launch CMS.py on port 5000 and TXN.py on port 5002, you can follow these steps:

Create a Dockerfile in your project directory:

# Use an official Python runtime as a parent image
FROM python:3.8-slim

# Set the working directory in the container
WORKDIR /app

# Copy the current directory contents into the container at /app
COPY . /app

# Install any needed packages specified in requirements.txt
RUN pip install -r requirements.txt

# Expose ports
EXPOSE 5000
EXPOSE 5002

# Define environment variables
ENV FLASK_APP "CMS.py"
ENV FLASK_RUN_HOST "0.0.0.0"

# Run the application
CMD ["flask", "run", "--port=5000"]

Building the Docker Image

# Build the Docker image from the Dockerfile in the current directory
docker build -t my-project-image .

Replace my-project-image with a suitable name for your Docker image.

Running the Docker Containers

For CMS.py on Port 5000:

To run the CMS component of your application, execute the following command:

# Run the container for CMS.py, mapping the host's port 5000 to the container's port 5000
docker run -d -p 5000:5000 my-project-image

For TXN.py on Port 5002:

Similarly, to run the TXN component, use this command:

# Run the container for TXN.py, mapping the host's port 5002 to the container's port 5002
docker run -d -p 5002:5002 -e FLASK_APP="TXN.py" my-project-image

These commands start containers based on the image you built, mapping the container ports to the specified host ports.

Accessing the Application

CMS Interface: Access your CMS at http://localhost:5000

TXN Interface: Access TXN at http://localhost:5002

Usage

Card Management System (CMS):

• Click on "Bin Adding" to manage BIN details.
• Navigate to "Card Issuing" to issue new cards to customers.
• Go to "Balance Adding" to add funds to existing cards.

Transaction Processing System (TXN):

• Visit "Transaction Tracking" to track card transactions and view transaction risk scores.

Error Handling

Both the CMS and TXN components include robust error handling to ensure smooth operation and a user-friendly experience. Errors are logged for debugging purposes, and users receive appropriate error messages when issues occur.

Logging

The application implements logging to capture various events, errors, and user interactions. Logs are stored for auditing, monitoring, and debugging. Log files can be configured to rotate periodically to prevent excessive disk usage.

Security

The CMS and TXN components take security seriously. User authentication is handled with Flask-Login, ensuring that only authorized users can access sensitive functionalities. Additionally, input validation and sanitation are enforced to prevent common security vulnerabilities, such as SQL injection and cross-site scripting (XSS) attacks.

Monitoring

The application includes monitoring features to track user interactions, system performance, and potential issues. Monitoring tools can be integrated to provide real-time insights into the application's health.

Key Functions

Card Generation

The "Card Issuing" feature in the CMS allows administrators to generate new cards for customers. It includes functionality to configure card details like card number, cardholder name, expiry date, and CVV.

Risk Calculations

The "Transaction Tracking" feature in the TXN component calculates transaction risk scores based on various factors, such as CVV attempts, transaction amount, cardholder age, and the country of the transaction. These risk scores help identify potentially fraudulent transactions.

Fraud Detection Cases

The TXN component includes fraud detection mechanisms that trigger when certain conditions are met, such as multiple incorrect CVV attempts on an active card, large transaction amounts with a high number of transactions in a short time, or transactions flagged as suspicious by a fraud detection system. These cases are logged and monitored for further investigation.

Contributing

Contributions are welcome! If you would like to contribute to the project, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature: git checkout -b feature-name
3. Commit your changes: git commit -m 'Add feature-name'
4. Push to your fork: git push origin feature-name
5. Submit a pull request.

License

This project is licensed under the MIT License.