Test payments effortlessly, build confidently.

Table of Contents

1. Introduction
2. Problem Statement
3. Solution Statement
4. Project Overview
5. Features
6. Installation
7. Usage
8. Team & Collaboration
   • Dugsiiye Team
   • QuickPay Team & Contributors
9. Lessons Learned
10. Frequently Asked Questions (FAQ)
11. License
12. Contact
13. Acknowledgments

---

Introduction

dhaqsoPay is an open‐source payment testing solution designed to empower students and developers to simulate payment transactions without any financial risk. By providing a robust, sandboxed environment, the project allows users to test payment integrations and identify issues before integrating with live payment APIs.

---

Problem Statement

Developers and students often face several challenges when testing payment integrations:

• Risk: Testing with live payment APIs can inadvertently trigger real transactions.
• Complexity: Building a realistic payment testing environment usually requires integrating multiple third-party services.
• Limited Coverage: Existing testing tools often fail to simulate every possible payment scenario.

---

Solution Statement

dhaqsoPay was developed to address these issues by offering:

• Mock Payment Endpoints: Simulate a wide range of payment outcomes (successful transactions, failures, refunds).
• Sandbox Environment: A secure, isolated space for safely testing payment flows without any financial consequences.
• Developer Tools: Easily integrate the solution via a Browser Extension and NPM/PIP packages, streamlining the testing process.

---

Project Overview

dhaqsoPay provides a comprehensive environment for simulating payment processes. Key aspects include:

• API Simulation: Emulate real-world payment scenarios in a controlled setting.
• User-Friendly Tools: Leverage a browser extension and integration packages for quick setup.
• Detailed Reporting: Access comprehensive logs and reports to monitor and debug payment flows.

For further details, please visit the dhaqsoPay Repo.

---

Features

• Payment Simulation API:
  Simulate various payment scenarios such as successful transactions, failures, and refunds.

• Browser Extension:
  Test payment flows directly from your browser with an intuitive extension.

• NPM/PIP Package Integration:
  Integrate dhaqsoPay effortlessly into Node.js or Python projects.

• Sandbox Environment:
  Conduct tests in a safe, controlled environment without risking real funds.

• Detailed Logging:
  Generate comprehensive logs and reports to analyze payment processes and troubleshoot issues.

---

Installation

Clone the repository and install the necessary dependencies:

# Clone the repository
git clone https://github.com/dugsiiyeinc/dhaqsoPay.git
cd dhaqsoPay

# For Node.js projects
npm install

# For Python projects
pip install -r requirements.txt

---

Usage

import { processPayment } from "dhaqsoPay";

const paymentDetails = {
  amount: 100,
  phone: "+25261XXXXXXX",
  method: "EVC",
};

processPayment(paymentDetails)
  .then((response) => console.log("Payment Successful", response))
  .catch((error) => console.error("Payment Failed", error));

---

Team & Collaboration

Dugsiiye Team

This project was initiated as part of a collaborative effort by a group of students passionate about software development.

dhaqsoPay Team & Contributors

The following contributors played a key role in the success of dhaqsoPay:

• Abdinasir Mursal - Fullstack Developer
• Faarax Abdullahi - Frontend Developer
• Iftin Awil - Frontend Developer
• Mohamed Abdirahim - Frontend Developer
• Abdiqafar - Backend Developer
• Abdihakim Adan - Frontend Developer
• Nasro Muuse - Frontend Developer
• Ayanle Osman - Frontend Developer
• A-M-Ahmed - Frontend Developer
• View all contributors

---

Lessons Learned

Throughout this project, the team learned:

• Effective collaboration using GitHub Discussions.
• The importance of detailed API documentation.
• Real-world payment gateway challenges.

---

Frequently Asked Questions (FAQ)

Is dhaqsoPay a real payment service?

No, it is a test environment for developers.

Does dhaqsoPay store real payment data?

No, the system does not process or store any real payment data. All transactions are simulated for testing purposes only.

Can I use dhaqsoPay in production environments?

No, dhaqsoPay is strictly for development and testing purposes. It is not intended for live payment processing.

How can I integrate dhaqsoPay with my project?

You can use the NPM package, PIP package, or browser extension as described in the Usage section.

What payment methods are supported in the simulation?

The simulation supports various mock payment methods such as EVC, Somnet, and Edahab.

Can I simulate failed transactions?

Yes, you can configure mock responses to simulate failed transactions, refunds, and other scenarios

---

Additional Resources

• Project Documentation
• API Reference
• Getting Started Guide

---

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Contact

For any inquiries, reach out via dugsiiye.

---

Acknowledgments

Special thanks to everyone who contributed to this project!