PHPackages                             sivehost/fossbilling-pesapal-mpesa - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. sivehost/fossbilling-pesapal-mpesa

ActiveLibrary[Payment Processing](/categories/payments)

sivehost/fossbilling-pesapal-mpesa
==================================

Pesapal MPESA Payment Gateway Module for FOSSBilling

001PHP

Since Mar 9Pushed 1y ago1 watchersCompare

[ Source](https://github.com/sivehost/fossbilling-pesapal-mpesa)[ Packagist](https://packagist.org/packages/sivehost/fossbilling-pesapal-mpesa)[ RSS](/packages/sivehost-fossbilling-pesapal-mpesa/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

### **📌 FOSSBilling Mpesa Payment Module for Pesapal**

[](#-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**.

[![Claim Status Graph](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/pAccount.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/pAccount.png?raw=true)

[![Invoice PDF Export](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/pcard.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/pcard.png?raw=true)

[![Invoice Status Graph](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/pCart.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/pCart.png?raw=true)

[![Claims page](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/PChoose.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/PChoose.png?raw=true)

[![Invoices page](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/pConfig.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/pConfig.png?raw=true)

[![Config page](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/pPayNow.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/pPayNow.png?raw=true)

[![Config page](https://github.com/sivehost/fossbilling-pesapal-mpesa/raw/main/pPayWithMpesa.png?raw=true)](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/pPayWithMpesa.png?raw=true)

---

**🌍 Supported Payment Methods**
-------------------------------

[](#-supported-payment-methods)

### **📲 Mobile Money Payments**

[](#-mobile-money-payments)

✅ **MPESA (Kenya, Tanzania)**
✅ **Airtel Money (Multiple countries)**
✅ **MTN Money**
✅ **Vodacom MPESA**
✅ **Tigo Pesa**

### **💳 Card Payments**

[](#-card-payments)

✅ **Visa**
✅ **MasterCard**
✅ **American Express**
✅ **Diners Club**
✅ **JCB Cards**

---

**📥 Installation**
------------------

[](#-installation)

### **1️⃣ Install via FOSSBilling Extension Directory**

[](#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**

[](#2️⃣-manual-installation)

1. **Download the latest release** from [GitHub Releases](https://github.com/sivehost/fossbilling-pesapal-mpesa/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**
--------------------

[](#️-configuration)

Once installed, configure Pesapal in **FOSSBilling**:

### **🔑 Enter API Credentials**

[](#-enter-api-credentials)

1. Navigate to **System → Payment Gateways → Pesapal**.
2. Enter your **Pesapal API Keys** .
    - **Find these in your Pesapal Dashboard**.

### **🔧 Customize Preferences**

[](#-customize-preferences)

- Enable **sandbox mode** for testing transactions before going live.
- Enable **transaction logging** for debugging.

### **✅ Save &amp; Test**

[](#-save--test)

1. Click **Save Changes**.
2. Run a **test transaction** in sandbox mode.
3. Once successful, switch to **live mode** to start accepting real payments.

---

**🚀 Why Use This Module?**
--------------------------

[](#-why-use-this-module)

✔ **Fast &amp; Secure**: Accept payments in multiple currencies and payment methods.
✔ **Easy Setup**: Install in just a few clicks.
✔ **Seamless Integration**: Works directly with **FOSSBilling’s invoicing system**.
✔ **Automatic Settlements**: Funds are settled into your **local bank account**.

---

**🤝 Contributing**
------------------

[](#-contributing)

We welcome contributions! 🚀

- **Found a bug?** Open an issue in GitHub.
- **Want to improve the module?** Submit a pull request.

To contribute:

```
git clone https://github.com/sivehost/fossbilling-pesapal-mpesa.git
cd fossbilling-pesapal-mpesa
git checkout -b feature-branch
```

Make your changes, commit, and submit a pull request.

---

**📜 License**
-------------

[](#-license)

This module is licensed under the **GNU General Public License v3.0**.
See [LICENSE](https://github.com/sivehost/fossbilling-pesapal-mpesa/blob/main/LICENSE) for details.

---

**📞 Support**
-------------

[](#-support)

For help, visit:

- **Pesapal Developer Docs**:
- **FOSSBilling Community**:
- **Sive.Host Support**: [https://sive.host/](https://Sive.Host/)

---

### **📢 Start Accepting Payments Today!**

[](#-start-accepting-payments-today)

➡ **[Download the latest version](https://github.com/sivehost/fossbilling-pesapal-mpesa/releases)** and get started! 🚀

---

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/08613b5d0468ff69d13a23b50614e16f022ec2b2afb116a53e404096865f0f39?d=identicon)[sivehost](/maintainers/sivehost)

---

Top Contributors

[![sivehost](https://avatars.githubusercontent.com/u/66014725?v=4)](https://github.com/sivehost "sivehost (4 commits)")

### Embed Badge

![Health badge](/badges/sivehost-fossbilling-pesapal-mpesa/health.svg)

```
[![Health](https://phpackages.com/badges/sivehost-fossbilling-pesapal-mpesa/health.svg)](https://phpackages.com/packages/sivehost-fossbilling-pesapal-mpesa)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
