Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mchamoudadev/payments
A robust payment system designed to integrate Somali local payment methods such as EVC, Zaad, Sahal, and Premier Bank Gateway (powered by Mastercard). This project aims to simplify online transactions across Somalia using the most widely adopted local payment solutions.
https://github.com/mchamoudadev/payments
evc payments-gateway premier-payment-gateway sahal zaad
Last synced: about 2 months ago
JSON representation
A robust payment system designed to integrate Somali local payment methods such as EVC, Zaad, Sahal, and Premier Bank Gateway (powered by Mastercard). This project aims to simplify online transactions across Somalia using the most widely adopted local payment solutions.
- Host: GitHub
- URL: https://github.com/mchamoudadev/payments
- Owner: mchamoudadev
- Created: 2024-08-07T22:45:23.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-10-24T12:20:28.000Z (2 months ago)
- Last Synced: 2024-10-25T12:47:20.665Z (2 months ago)
- Topics: evc, payments-gateway, premier-payment-gateway, sahal, zaad
- Language: TypeScript
- Homepage:
- Size: 101 KB
- Stars: 6
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Here’s the updated README with the correct `.env` keys and environment setup details:
---
# Somali Local Payment System
[](LICENSE)
[](https://github.com/mchamoudadev/payments/graphs/contributors)
[](https://github.com/mchamoudadev/payments/issues)
A robust payment system designed to integrate Somali local payment methods such as **EVC**, **Zaad**, **Sahal**, and **Premier Bank Gateway** (powered by Mastercard). This project aims to simplify online transactions across Somalia using the most widely adopted local payment solutions.
---
## 🚀 Key Features
- **Support for Somali Local Payment Methods**: Seamless integration with EVC, Zaad, Sahal, and Premier Bank Gateway (Mastercard).
- **High Security**: Implements secure protocols to ensure safe and encrypted transactions.
- **Real-time Payment Processing**: Instant verification and processing of payments for quick transaction completions.
- **Customizable Integration**: Easy API setup to integrate with e-commerce platforms, websites, and mobile apps.
- **Detailed Documentation**: Clear and concise instructions to help developers quickly set up and use the system.
- **Scalable Infrastructure**: Handles large transaction volumes efficiently with minimal downtime.
---
## 🏗️ Installation
1. Clone the repository:
```bash
git clone https://github.com/mchamoudadev/payments.git
```
2. Navigate into the project directory:
```bash
cd payments
```
3. Install dependencies:
```bash
npm install
```
4. Configure environment variables:
- Set up the following environment variables in your `.env` file:
```env
MASTER_CARD_MERCHANT_ID=your_mastercard_merchant_id
MASTER_CARD_API_PASSWORD=your_mastercard_api_password
MERCHANT_U_ID=your_merchant_u_id
MERCHANT_API_USER_ID=your_merchant_api_user_id
MERCHANT_API_KEY=your_merchant_api_key
```
5. Run the development server:
```bash
npm start
```
---
## 🌐 Supported Payment Methods
- **EVC**: Mobile payment service widely used across Somalia.
- **Zaad**: Popular mobile money platform from Telesom.
- **Sahal**: Digital payment solution for easy transfers.
- **Premier Bank Gateway**: Mastercard-powered payment gateway for secure transactions.
---
## 🤝 Contributing
We welcome contributions to improve and expand this project! To contribute:
1. Fork the repository.
2. Create a new feature branch (`git checkout -b feature-branch`).
3. Commit your changes (`git commit -m 'Add new feature'`).
4. Push the branch (`git push origin feature-branch`).
5. Create a Pull Request.
---
## 📜 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
---
## ✨ Acknowledgements
- **EVC** - For providing the mobile payment platform used by millions.
- **Zaad** - For creating a reliable mobile money service.
- **Sahal** - For enabling easy digital transactions across the country.
- **Premier Bank** - For powering online transactions through Mastercard.
---