This project is a payment gateway implementation, developed as part of a backend challenge. It provides a RESTful API for processing payments using credit or debit cards.

Before running the application, make sure you have the following installed:

• Python (version 3.7 or higher): You can download Python from the official website: https://www.python.org/downloads/
• make is installed (for running the provided Makefile).
• pip (Python package installer): pip is usually installed by default with Python. You can check if it's available by running pip --version in your terminal. If it's not installed, you can install it using the instructions here: https://pip.pypa.io/en/stable/installing/

Additionally, you may need to install SQLite if you're using a different database. You can download SQLite from the official website: https://www.sqlite.org/download.html

Make sure to verify the installation by running python3 --version, pip --version, and sqlite3 --version in your terminal.

Note: If in any of the steps python3 doesn't work, try the commands with python

1. Clone the repository:

   git clone https://github.com/KamalMaharana/Fatakpay-assignment.git
   cd Fatakpay-assignment

2. Install dependencies:

   make install

   OR

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

3. To run the application:

   make run

   OR

   uvicorn main:app --reload

   This will start the FastAPI server and the application will be accessible at http://localhost:8000.

4. To run unit tests:

   make test

   OR

   python3 -m unittest Test/test_payment.py

   This will run the unit tests.

POST /process_payment: Processes a payment request. Expects a JSON payload with payment details. Returns the payment response in JSON format. Examples Process a payment Endpoint: POST /process_payment

Request Body:

{
  "amount": 100.0,
  "currency": "USD",
  "type": "creditcard",
  "card": {
    "number": "4111111111111111",
    "expirationMonth": "12",
    "expirationYear": "2023",
    "cvv": "123"
  }
}

Response:

{
  "amount": 100.0,
  "currency": "USD",
  "type": "creditcard",
  "card": {
    "number": "4111111111111111"
  },
  "status": "success",
  "authorization_code": "a1b2c3d4",
  "time": "2023-05-12T10:00:00",
  "http_status_code": 200
}

Note: The API documentation is automatically generated using Swagger UI. You can access the documentation by visiting http://localhost:8000/docs in your browser while the application is running.

The project directory structure is as follows:

• Main.py: The main entry point of the application.
• Models/: Contains the database models.
• Database/: Contains the database-related files.
• Test/: Contains unit test cases for the application.
• Validation/: Contains the validation checks.