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.
## β¦