FOSSBilling payment module for Pesapal MPESA integration
### **📌 FOSSBilling Mpesa Payment Module for Pesapal**
**Seamless payment processing for businesses in Kenya, Uganda, Tanzania, Malawi, Rwanda, Zambia, and Zimbabwe.**
This module integrates **Pesapal** with **FOSSBilling**, enabling you to accept payments via **credit cards, debit cards, and mobile money**. Payments are settled directly into your **local bank account**.
---
## **🌍 Supported Payment Methods**
### **📲 Mobile Money Payments**
✅ **MPESA (Kenya, Tanzania)**
✅ **Airtel Money (Multiple countries)**
✅ **MTN Money**
✅ **Vodacom MPESA**
✅ **Tigo Pesa**
### **💳 Card Payments**
✅ **Visa**
✅ **MasterCard**
✅ **American Express**
✅ **Diners Club**
✅ **JCB Cards**
---
## **📥 Installation**
### **1️⃣ Install via FOSSBilling Extension Directory**
The easiest way to install this module is using the **FOSSBilling extension directory**.
1. Upload the Mpesa.php file into /library/Payment/Adapter/ and then Go to **FOSSBilling Admin Panel**.
2. Navigate to **System → Payment Gateways**.
3. Search for **Pesapal** and click **Install**.
4. Configure your API credentials and preferences.
---
### **2️⃣ Manual Installation**
1. **Download the latest release** from GitHub Releases.
2. **Create a new folder** named **Pesapal** inside your **FOSSBilling installation**:
```
/library/Payment/Adapter/Pesapal/
```
3. **Extract the downloaded files** into the new **Pesapal** directory.
4. Go to **Admin Panel → System → Payment Gateways**.
5. Find **Pesapal** under the **"New Payment Gateway"** tab.
6. Click the **cog icon** to **install and configure Pesapal**.
---
## **⚙️ Configuration**
Once installed, configure Pesapal in **FOSSBilling**:
### **🔑 Enter API Credentials**
1. Navigate to **System → Payment Gateways → Pesapal**.
2. Enter your **Pesapal API Keys** .
- **Find these in your Pesapal Dashboard**.
### **🔧 Customize Preferences**
- Enable **sandbox mode** for testing transactions before going live.
- Enable **transaction logging** for debugging.
## …