PHPackages                             itsmurumba/laravel-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. itsmurumba/laravel-mpesa

ActiveLibrary[Payment Processing](/categories/payments)

itsmurumba/laravel-mpesa
========================

Laravel Package for Mpesa Daraja API

v1.0.8(3mo ago)191.6k↑230.8%4MITPHPPHP ^7.1|^8.0|^8.1|^8.2|^8.3|^8.4CI passing

Since Nov 2Pushed 2mo ago4 watchersCompare

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

READMEChangelog (10)Dependencies (4)Versions (15)Used By (0)

Introduction
============

[](#introduction)

This is a Laravel package for Safaricom Mpesa Daraja API. It includes all public available endpoints:

- Consumer to Business (C2B) payments
- Business to Consumer (B2C) payments
- Mpesa Express Payment (Lipa Na Mpesa Online)
- Transaction Status
- Account Balance
- Reversal
- Business to Business (B2B) payments

Installation
============

[](#installation)

Run the following command to install Laravel Mpesa package in your Laravel project:

```
composer require itsmurumba/laravel-mpesa

```

If you are using **Laravel 5.5** and above, skip to the [**Configurations**](https://github.com/ItsMurumba/laravel-mpesa#configurations) step.

After running the composer require above, you should add a service provider and alias of the package in config/app.php file.(For Laravel 5.4 and below)

```
Itsmurumba\Mpesa\MpesaServiceProvider::class

```

Configurations
==============

[](#configurations)

After installing the package, run the following command to install `mpesa.php` configuartion file in the `config` folder:

```
php artisan mpesa:install

```

or

```
php artisan vendor:publish

```

Add and define the following variables in your `.env` file

```
MPESA_CONSUMER_KEY=
MPESA_CONSUMER_SECRET=
MPESA_CALLBACK_URL=
MPESA_BASE_URL=https://sandbox.safaricom.co.ke
MPESA_PAYBILL_NUMBER=600978
LIPA_NA_MPESA_SHORTCODE=174379
LIPA_NA_MPESA_CALLBACK_URL=
LIPA_NA_MPESA_PASSKEY=
MPESA_CONFIRMATION_URL=
MPESA_VALIDATION_URL=
MPESA_INITIATOR_USERNAME=
MPESA_INITIATOR_PASSWORD=
MPESA_ENVIRONMENT=sandbox
MPESA_QUEUE_TIMEOUT_URL=
MPESA_RESULT_URL=

```

Usage
=====

[](#usage)

Add the following constructor inside your controller:

```
protected $mpesa;

public function __construct(){
    $this->mpesa = new Mpesa();
}

```

**1. Mpesa Express Payment (Lipa Na Mpesa Online)**

```
$this->mpesa->expressPayment($amount, $phoneNumber, $accountReference = 'CompanyXLTD', $transactionDescription = 'Payment of X');

```

- $phoneNumber = 254XXXXXXXXX
- $accountReference = Account Reference (maximum 12 characters)
- transactionDescription = Transaction Description (1-13 characters)

**2. Mpesa Express Payment Query (Lipa Na Mpesa Online)**

```
$this->mpesa->expressPaymentQuery($checkoutRequestId);

```

**3. C2B Register URLs**

```
$this->mpesa->c2bRegisterURLs();

```

**4. Consumer to Business (C2B) payments**

```
$this->mpesa->c2bPaymentc2bPayment($commandId, $amount, $phoneNumber, $billRefNumber);

```

- $commandId = can only be set to **CustomerPayBillOnline** or **CustomerBuyGoodsOnline**
- $billRefNumber = used on CustomerPayBillOnline option only e.g an Account Number. Set the value to `''` when commandId is **CustomerBuyGoodsOnline**

**5. Business to Consumer (B2C) payments**

```
$this->mpesa->b2cPayment($commandId, $amount, $phoneNumber, $remarks, $occassion = '');

```

**6. Transaction Status**

```
$this->mpesa->transactionStatus($transactionId, $identifierType, $remarks, $occassion = '');

```

**7. Account Balance**

```
$this->mpesa->accountBalance($identifierType, $remarks);

```

**8. Reversal**

```
$this->mpesa->reversals($transactionId, $amount, $receiverParty, $receiverIdentifierType, $remarks, $occasion = '');

```

**9. Business to Business Payment(B2B)**

```
$this->mpesa->b2bPayment($commandId, $amount, $receiverShortcode, $accountReference, $remarks);

```

Contribution
============

[](#contribution)

This is a community package and thus welcome anyone intrested to contribute in improving the package. Kindly go through the [Contribution.md](Contribution.md) before starting to contribute. Keep those PRs and Issues coming.

Buy Me Coffee
=============

[](#buy-me-coffee)

Give this repo a star and i will have my super powers recharged. You can also follow me on twitter [@ItsMurumba](https://twitter.com/ItsMurumba)

License
=======

[](#license)

This package is licensed under the MIT License. Please review the [License](LICENSE.md) file for details

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance83

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity71

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~147 days

Recently: every ~294 days

Total

9

Last Release

110d ago

PHP version history (4 changes)v1.0.5PHP ^7.1|^8.0

v1.0.6PHP ^7.1|^8.0|^8.1

v1.0.7PHP ^7.1|^8.0|^8.1|^8.2

v1.0.8PHP ^7.1|^8.0|^8.1|^8.2|^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/53953afbbecd70ed72b7b0f564e1ef0c44f55b4a1c81535402bc7de8dc3ad078?d=identicon)[ItsMurumba](/maintainers/ItsMurumba)

---

Top Contributors

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

---

Tags

daraja-apidaraja-mpesadaraja-mpesa-laravelhacktoberfestlaravel-mpesampesa-apimpesa-sdkpayment-integrationlaravellaravel 6laravel 7laravel 8laravel 9laravel 10laravel 11laravel 12paymentslaravel 5mpesadarajaitsmurumba

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/itsmurumba-laravel-mpesa/health.svg)

```
[![Health](https://phpackages.com/badges/itsmurumba-laravel-mpesa/health.svg)](https://phpackages.com/packages/itsmurumba-laravel-mpesa)
```

###  Alternatives

[ip2location/ip2location-laravel

Lookup for visitor's IP information, such as country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation and usage type.

83516.9k1](/packages/ip2location-ip2location-laravel)[ip2location/ip2proxy-laravel

Allows user to query an IP address if it was being used as open proxy, web proxy, VPN anonymizer and TOR exits.

1063.2k](/packages/ip2location-ip2proxy-laravel)[prevailexcel/laravel-nowpayments

A Laravel Package for NOWPayments

1414.2k](/packages/prevailexcel-laravel-nowpayments)

PHPackages © 2026

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