Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/c00p75/takehome-payment-gateway
Web application that simulates a payment process and implements dynamic currency localization based on the user's location. Provide users with a seamless payment experience while dynamically displaying prices in their local currency.
https://github.com/c00p75/takehome-payment-gateway
Last synced: 2 days ago
JSON representation
Web application that simulates a payment process and implements dynamic currency localization based on the user's location. Provide users with a seamless payment experience while dynamically displaying prices in their local currency.
- Host: GitHub
- URL: https://github.com/c00p75/takehome-payment-gateway
- Owner: c00p75
- License: mit
- Created: 2023-09-10T17:52:41.000Z (over 1 year ago)
- Default Branch: dev
- Last Pushed: 2023-10-11T05:40:31.000Z (over 1 year ago)
- Last Synced: 2024-05-17T15:33:52.186Z (8 months ago)
- Language: TypeScript
- Homepage:
- Size: 7.93 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FutureEd
## 📗 Table of Contents
- [📗 Table of Contents](#-table-of-contents)
- [📖 FutureEd](#about-project)
- [🛠 Built With](#-built-with-)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [Deployment Link](#deployment-link)
- [💻 Getting Started with Vite](#getting-started)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Available Scripts](#available-scripts)
- [`npm start`](#npm-start)
- [`npm test`](#npm-test)
- [`npm run build`](#npm-run-build)
- [👥 Author](#-author-)
- [🔭 Future Features](#-future-features-)
- [🤝 Contributing](#-contributing-)
- [⭐️ Show Your Support](#️-show-your-support-)
- [🙏 Acknowledgments](#-acknowledgments-)
- [📝 License](#-license)
**FutureEd** is a web application that simulates a payment process using [SparcoPay](https://www.sparcopay.com/) and [Paypal](https://www.paypal.com/us/webapps/mpp/payflow-payment-gateway) payment gateways and implements dynamic currency localization based on the user's selected location. It provides users with a seamless payment experience while dynamically displaying prices in their local currency.
Programming languages
Technologies
Frameworks
Server
### Key Features
- Card payment integration.
- Mobile money payment integration.
- Dynamic currency conversion based on selected location.
- Responsive and visually appealing design.
## Deployment Link
Live demo: [Coming soon]()
## 💻 Getting Started with Vite
This project was bootstrapped with [Vite](https://vitejs.dev/).
To get a local copy up and running, follow these steps.
### Prerequisites
- Install git on your computer.
- Install a code editor.
- And a web browser to view the output.
### Setup
Clone this repository to your desired folder:
```bash
cd my-folder
git clone https://github.com/c00p75/takehome-payment-gateway.git
```
### Install
Navigate to the directory with:
```bash
cd my-project
```
To install the dependencies, run:
```bash
npm install
```
### Setup environment variables
Create a .env file to store PayPal client id as well as Sparcopay public and secrete keys
```env
# Must-have for mobile money
SPARCO_PUB_KEY="YOUR_SPARCO_PUBLIC_KEY"
SPARCO_SEC_KEY="YOUR_SPARCO_SECRET_KEY"
# Must-have for PayPal
CLIENT_ID="YOUR_CLIENT_ID_GOES_HERE"
``````
## Available Scripts
In the project directory, run:
```bash
npm start
```
This runs the app in development mode.\
Open [http://localhost:3000](http://localhost:3000) to view it in your browser.
The page will re-render when you make changes.\
You may also see some lint errors in the console.
To install the dependencies, run:
```bash
npm test
```
This launches the test runner in interactive watch mode.
```bash
npm run build
```
This builds the app for production to the `build` folder.
👤 **George M'sapenda**
- GitHub: [@github](https://github.com/c00p75)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/georgemsapenda/)
- **Utilize geolocation API to set the default currency based on a user's current location**
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](https://github.com/c00p75/takehome-payment-gateway/issues).
Please consider giving a ⭐️ if you like this project!
> Give credit to everyone who inspired your codebase.
I'd like to thank [ZONO ACADEMY](https://elearning.zonoacademy.com/) for providing the business requirements for this project.
P.S. Stack Overflow and Google 😉
### 📝 License
- This project is [MIT](./LICENSE) licensed.
## Disclaimer
**Please Note:** This project is intended for demonstration purposes only. It is not associated with or representative of any real charity organization, and will process actual financial transactions.
**Do Not Send Real Money:** I want to emphasize that you should not send real money or make real financial transactions through this project. Any payment or transaction made within this project is solely for testing and simulation purposes, and the funds will be received by the API credential holders for demonstration purposes only. I will not be responsible for any financial transactions made in error.
If you have any questions or concerns about the project, please feel free to create an issue for clarification.