PHPackages                             karson/mpesa-php-sdk - 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. karson/mpesa-php-sdk

ActiveLibrary[Payment Processing](/categories/payments)

karson/mpesa-php-sdk
====================

3.1.0(2mo ago)172.2k↓50%15MITPHPPHP >=8.1CI passing

Since Jan 14Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/karson/mpesa-php-sdk)[ Packagist](https://packagist.org/packages/karson/mpesa-php-sdk)[ Docs](https://github.com/karson/mpesa-php-sdk)[ GitHub Sponsors](https://github.com/karson)[ RSS](/packages/karson-mpesa-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (27)Used By (0)

Mpesa Mozambique PHP SDK
========================

[](#mpesa-mozambique-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/ee1a10eaf442cf0ee05a18874252e834c7bb587535f8cb0ca74e19a1c6ed15af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6172736f6e2f6d706573612d7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/karson/mpesa-php-sdk)[![Build Status](https://camo.githubusercontent.com/113fb3feccd848f985ff1cc467fffc8fde51e980675687a13df857ce6d8f380c/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6b6172736f6e2f6d706573612d7068702d73646b2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/karson/mpesa-php-sdk)[![Quality Score](https://camo.githubusercontent.com/b1a40eb65b0c04ae15913b6dc14c6b80b3ded4f0d3295b85c818cbe1113a6e70/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6b6172736f6e2f6d706573612d7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/karson/mpesa-php-sdk)[![Total Downloads](https://camo.githubusercontent.com/1828c8154f59d5d074371fc9d0097acc65b03ec8cb47142f8ebb5143c79be71f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b6172736f6e2f6d706573612d7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/karson/mpesa-php-sdk)

A comprehensive PHP SDK for integrating with M-Pesa Mozambique APIs. This package provides a clean, modern interface for all M-Pesa operations with robust error handling, callback processing, and extensive validation.

Features
--------

[](#features)

- **🚀 Modern PHP 8.1+ Support**: Built with modern PHP features including typed properties, named arguments, and enums
- **📦 Unified Response Architecture**: Streamlined response classes with eliminated code duplication (~90% reduction)
- **🔄 Callback Handler System**: Complete callback processing with event-driven architecture (TODO)
- **✅ Type Safety**: Strongly typed responses with specific methods for each operation
- **🏗️ Clean Architecture**: Organized structure with dedicated response classes and clear inheritance
- **🔐 Security First**: Built-in signature validation, parameter sanitization, and secure token management
- **📊 Transaction Operations**: Full support for C2B, B2C, B2B transactions with sync/async modes
- **🔍 Query Operations**: Transaction status queries and customer name lookups
- **💰 Refund/Reversal**: Complete transaction reversal support with partial refund capabilities
- **🎯 Smart Validation**: Comprehensive parameter validation with detailed error messages
- **📱 Laravel Integration**: Native Laravel service provider with configuration publishing
- **🔧 Developer Experience**: Extensive examples, comprehensive documentation, and debugging tools

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require karson/mpesa-php-sdk
```

Usage
-----

[](#usage)

### Basic Setup

[](#basic-setup)

```
use Karson\MpesaPhpSdk\Mpesa;

// Initialize with your credentials from M-Pesa Developer Console (https://developer.mpesa.vm.co.mz/)
$mpesa = new Mpesa(
    publicKey: 'your_public_key',
    apiKey: 'your_api_key',
    isTest: true, // false for production
    serviceProviderCode: '171717' // Your service provider code
);
```

### Customer to Business (C2B) Transactions

[](#customer-to-business-c2b-transactions)

```
// C2B Transaction (Unified API)
$response = $mpesa->c2b(
    transactionReference: 'TXN001',
    customerMSISDN: '258841234567',
    amount: 100,
    thirdPartyReference: 'REF001'
);

if ($response->isTransactionSuccessful()) {
    echo "Transaction ID: " . $response->getTransactionId();
    echo "Conversation ID: " . $response->getConversationId();
    echo "Third Party Reference: " . $response->getThirdPartyReference();
} else {
    echo "Error: " . $response->getResponseDescription();
    echo "Error Code: " . $response->getResponseCode();
}

// Check transaction status
if ($response->isTransactionInitiated()) {
    echo "Transaction initiated. Use Conversation ID for status tracking.";
}
```

### Business to Customer (B2C) Transactions

[](#business-to-customer-b2c-transactions)

```
// B2C Transaction (Unified API)
$response = $mpesa->b2c(
    customerMSISDN: '258841234567',
    amount: 100,
    transactionReference: 'TXN002',
    thirdPartyReference: 'REF002'
);

if ($response->isTransactionSuccessful()) {
    echo "Transaction ID: " . $response->getTransactionId();
    echo "Conversation ID: " . $response->getConversationId();
    echo "Third Party Reference: " . $response->getThirdPartyReference();
} else {
    echo "Error: " . $response->getResponseDescription();
}
```

### Transaction Status Query

[](#transaction-status-query)

```
$response = $mpesa->status(
    thirdPartyReference: 'REF001',
    queryReference: 'QUERY001'
);

// Access status information
echo "Transaction Status: " . $response->getTransactionStatus();
echo "Amount: " . $response->getAmount();
echo "Currency: " . $response->getCurrency();
```

### Customer Name Query

[](#customer-name-query)

```
$response = $mpesa->queryCustomerName(
    customerMSISDN: '258841234567',
    thirdPartyReference: 'REF003'
);

if ($response->isSuccessful()) {
    echo "Customer Name: " . $response->getCustomerName();
    echo "First Name: " . $response->getFirstName();
    echo "Last Name: " . $response->getLastName();
}
```

### Business to Business (B2B) Transactions

[](#business-to-business-b2b-transactions)

```
// B2B Transaction (Unified API)
$response = $mpesa->b2b(
    transactionReference: 'TXN003',
    amount: 100,
    thirdPartyReference: 'REF003',
    primaryPartyCode: '171717', // Sender business code
    receiverPartyCode: '979797'  // Receiver business code
);

if ($response->isTransactionSuccessful()) {
    echo "B2B Transaction ID: " . $response->getTransactionId();
    echo "Conversation ID: " . $response->getConversationId();
    echo "Third Party Reference: " . $response->getThirdPartyReference();
} else {
    echo "Error: " . $response->getResponseDescription();
}
```

### Transaction Refund/Reversal

[](#transaction-refundreversal)

```
$response = $mpesa->reversal(
    transactionID: 'TXN123456',
    securityCredential: 'your_security_credential',
    initiatorIdentifier: 'your_initiator',
    thirdPartyReference: 'REF004',
    reversalAmount: '50' // Optional: partial refund
);

if ($response->isReversalSuccessful()) {
    echo "Refund Transaction ID: " . $response->getReversalTransactionId();
    echo "Refund Amount: " . $response->getReversalAmount();

    if ($response->isPartialReversal()) {
        echo "This was a partial refund";
    }
} else {
    echo "Refund failed: " . $response->getResponseDescription();
}
```

### Response Objects

[](#response-objects)

All methods return strongly typed response objects based on a unified architecture:

#### BaseResponse (Unified Response Class)

[](#baseresponse-unified-response-class)

All transaction responses now inherit from `BaseResponse` with common methods:

```
// Common methods available on all responses
$response->getTransactionId();          // Transaction ID
$response->getConversationId();         // Conversation ID for tracking
$response->getResponseCode();           // M-Pesa response code
$response->getResponseDescription();    // Response description
$response->getThirdPartyReference();    // Third party reference
$response->isTransactionSuccessful();   // Check if transaction succeeded
$response->isTransactionInitiated();    // Check if transaction was initiated
$response->getStatusCode();             // HTTP status code
$response->getRawResponse();            // Raw API response
$response->isSuccessful();              // HTTP success check
$response->isApiSuccess();              // M-Pesa API success check
```

#### Transaction Response Classes

[](#transaction-response-classes)

- **TransactionResponse**: Unified response for C2B, B2C, B2B transactions
- **TransactionStatusResponse**: For transaction status queries
- **CustomerNameResponse**: For customer name lookups
- **ReversalResponse**: For refund/reversal operations

#### Transaction Status Response Methods

[](#transaction-status-response-methods)

- `getTransactionId()`: Get the transaction ID
- `getConversationId()`: Get the conversation ID
- `getTransactionStatus()`: Get the current transaction status
- `getAmount()`: Get the transaction amount
- `getCurrency()`: Get the transaction currency
- `getReceiverParty()`: Get the receiver party information
- `getTransactionCompletedDateTime()`: Get completion timestamp
- `isTransactionCompleted()`: Check if transaction is completed
- `isTransactionPending()`: Check if transaction is pending
- `isTransactionFailed()`: Check if transaction failed

#### Customer Name Response Methods

[](#customer-name-response-methods)

- `getCustomerMSISDN()`: Get the customer phone number
- `getFirstName()`: Get the customer's first name (obfuscated)
- `getSecondName()`: Get the customer's second name (obfuscated)
- `getCustomerName()`: Get the full customer name
- `isCustomerFound()`: Check if customer was found

#### Refund/Reversal Response Methods

[](#refundreversal-response-methods)

- `getTransactionId()`: Get the original transaction ID
- `getReversalTransactionId()`: Get the reversal transaction ID
- `getReversalAmount()`: Get the reversed amount (for partial reversals)
- `getConversationId()`: Get the conversation ID
- `isReversalSuccessful()`: Check if reversal was successful
- `isPartialReversal()`: Check if it was a partial reversal

#### Response Class Architecture

[](#response-class-architecture)

The SDK v2.0 features a completely refactored response architecture that eliminates ~90% of code duplication:

```
BaseResponse (unified base class)
├── TransactionResponse (unified for C2B, B2C, B2B)
├── TransactionStatusResponse (transaction status queries)
├── CustomerNameResponse (customer name lookups)
└── ReversalResponse (refund/reversal operations)

```

**Key Improvements:**

- **Unified API**: All transaction types (C2B, B2C, B2B) now return the same `TransactionResponse` class
- **Eliminated Duplication**: Removed redundant sync/async response classes
- **Better Type Safety**: Specific methods for each response type with proper return types
- **Consistent Interface**: All responses share common methods from `BaseResponse`
- **Simplified Usage**: No need to remember different method names for different transaction types

Project Structure
-----------------

[](#project-structure)

The SDK v2.0 features a streamlined, organized structure:

```
src/
├── Mpesa.php                    # Main SDK class with unified API
├── Auth/                        # Authentication management
│   └── TokenManager.php        # Token generation and caching
├── Constants/                   # API constants and enums
│   ├── ResponseCodes.php       # Response code constants
│   └── TransactionStatus.php   # Transaction status constants
├── Validation/                  # Parameter validation
│   └── ParameterValidator.php  # Input validation utilities
├── Exceptions/                  # Custom exceptions
│   ├── ValidationException.php
│   ├── AuthenticationException.php
│   ├── ApiException.php
│   └── CallbackException.php
├── Providers/
│   └── ServiceProvider.php     # Laravel service provider
├── config/
│   └── mpesa.php               # Configuration file
├── Callback/                    # Callback handling system (NEW)
│   ├── CallbackHandler.php     # Main callback processor
│   └── Events/                  # Callback event classes
│       ├── CallbackEvent.php   # Base event class
│       ├── TransactionCompletedEvent.php
│       └── TransactionFailedEvent.php
└── response/                    # Unified response classes
    ├── BaseResponse.php         # Unified base response
    ├── TransactionResponse.php  # For C2B, B2C, B2B transactions
    ├── TransactionStatusResponse.php
    ├── CustomerNameResponse.php
    └── ReversalResponse.php

```

**Key Architectural Improvements:**

- **Unified Response System**: Single `TransactionResponse` class for all transaction types
- **Callback Handler System**: Complete event-driven callback processing
- **Streamlined Structure**: Eliminated redundant directories and classes
- **Better Organization**: Clear separation of concerns with dedicated folders
- **Enhanced Security**: Comprehensive exception handling and validation

API Reference
-------------

[](#api-reference)

For detailed API documentation including all endpoints, request/response parameters, and examples, see the [API Documentation](API.md).

Laravel Integration
-------------------

[](#laravel-integration)

### Installation in Laravel

[](#installation-in-laravel)

Add the following environment variables to your `.env` file:

```
MPESA_API_KEY="Your API Key"
MPESA_PUBLIC_KEY="Your Public Key"
MPESA_ENV=test # 'live' for production environment
MPESA_SERVICE_PROVIDER_CODE=171717
```

### Service Provider Registration

[](#service-provider-registration)

The package includes a Laravel service provider that automatically registers the M-Pesa service. You can inject it into your controllers:

```
use Karson\MpesaPhpSdk\Mpesa;
use Karson\MpesaPhpSdk\Callback\CallbackHandler;

class PaymentController extends Controller
{
    public function __construct(
        private Mpesa $mpesa,
        private CallbackHandler $callbackHandler
    ) {
    }

    public function processPayment(Request $request)
    {
        $response = $this->mpesa->c2b(
            transactionReference: $request->transaction_ref,
            customerMSISDN: $request->phone_number,
            amount: $request->amount,
            thirdPartyReference: $request->reference
        );

        if ($response->isTransactionSuccessful()) {
            // Handle successful payment
            return response()->json([
                'success' => true,
                'transaction_id' => $response->getTransactionId(),
                'conversation_id' => $response->getConversationId(),
                'third_party_reference' => $response->getThirdPartyReference()
            ]);
        }

        return response()->json([
            'success' => false,
            'message' => $response->getResponseDescription(),
            'error_code' => $response->getResponseCode()
        ], 400);
    }

    public function handleCallback(Request $request)
    {

            $response = $request->getContent(),

          ...

    }
}
```

Error Handling
--------------

[](#error-handling)

All response objects provide comprehensive error information with the unified API:

```
$response = $mpesa->c2b('TXN001', '258841234567', 100, 'REF001');

// Check HTTP status
if (!$response->isSuccessful()) {
    echo "HTTP Error: " . $response->getStatusCode();
}

// Check transaction status
if (!$response->isTransactionSuccessful()) {
    echo "Transaction Error: " . $response->getResponseDescription();
    echo "Error Code: " . $response->getResponseCode();
}

// Check if transaction was initiated (for async processing)
if ($response->isTransactionInitiated()) {
    echo "Transaction initiated. Conversation ID: " . $response->getConversationId();
}

// Get raw response for debugging
var_dump($response->getRawResponse());
```

Response Structure
------------------

[](#response-structure)

### Unified Transaction Responses

[](#unified-transaction-responses)

All transaction methods (C2B, B2C, B2B) now return a unified `TransactionResponse` object:

```
// All transaction types use the same response structure
$c2bResponse = $mpesa->c2b('TXN001', '258841234567', 100, 'REF001');
$b2cResponse = $mpesa->b2c('258841234567', 100, 'TXN002', 'REF002');
$b2bResponse = $mpesa->b2b('TXN003', 100, 'REF003', '171717', '979797');

// All responses have the same methods available
foreach ([$c2bResponse, $b2cResponse, $b2bResponse] as $response) {
    if ($response->isTransactionSuccessful()) {
        echo "Transaction ID: " . $response->getTransactionId();
        echo "Conversation ID: " . $response->getConversationId();
        echo "Third Party Reference: " . $response->getThirdPartyReference();
    }
}
```

### Transaction Status Tracking

[](#transaction-status-tracking)

Use the conversation ID to track transaction status:

```
// Initiate transaction
$response = $mpesa->c2b('TXN001', '258841234567', 100, 'REF001');

if ($response->isTransactionInitiated()) {
    $conversationId = $response->getConversationId();

    // Later, check the status
    $statusResponse = $mpesa->queryTransactionStatus('REF001', 'QUERY001');

    if ($statusResponse->isTransactionCompleted()) {
        echo "Transaction completed successfully";
        echo "Amount: " . $statusResponse->getAmount();
        echo "Currency: " . $statusResponse->getCurrency();
    } elseif ($statusResponse->isTransactionPending()) {
        echo "Transaction is still pending";
    } elseif ($statusResponse->isTransactionFailed()) {
        echo "Transaction failed";
    }
}
```

Exception Handling
------------------

[](#exception-handling)

The SDK provides comprehensive error handling with custom exceptions:

```
use Karson\MpesaPhpSdk\Exceptions\ValidationException;
use Karson\MpesaPhpSdk\Exceptions\AuthenticationException;
use Karson\MpesaPhpSdk\Exceptions\ApiException;
use Karson\MpesaPhpSdk\Exceptions\CallbackException;

try {
    $response = $mpesa->c2b('TXN001', '258841234567', 100, 'REF001');

} catch (ValidationException $e) {
    echo "Validation Error: " . $e->getMessage();
    foreach ($e->getErrors() as $error) {
        echo "- " . $error . "\n";
    }

} catch (AuthenticationException $e) {
    echo "Authentication failed: " . $e->getMessage();

} catch (ApiException $e) {
    echo "API Error: " . $e->getMessage();
    echo "Response Code: " . $e->getResponseCode();
    echo "Response Description: " . $e->getResponseDescription();

} catch (CallbackException $e) {
    echo "Callback Error: " . $e->getMessage();
    if ($e->getCallbackData()) {
        echo "Callback Data: " . json_encode($e->getCallbackData());
    }

} catch (Exception $e) {
    echo "General Error: " . $e->getMessage();
}
```

### Exception Types

[](#exception-types)

- **ValidationException**: Thrown when input parameters fail validation
- **AuthenticationException**: Thrown when API authentication fails
- **ApiException**: Thrown when M-Pesa API returns an error

Token Management
----------------

[](#token-management)

The SDK includes intelligent token management with caching and optimization:

```
// Get token manager
$tokenManager = $mpesa->getTokenManager();

// Get token (generated automatically if needed)
$token = $mpesa->getToken();
echo "Token: " . substr($token, 0, 20) . "...";

// Clear stored token
$tokenManager->clearToken();
```

### Token Management Features

[](#token-management-features)

- **Automatic Generation**: Tokens are generated automatically when needed
- **Smart Reuse**: Existing tokens are reused to improve performance
- **Manual Control**: Clear tokens when needed
- **Thread Safe**: Safe for use in concurrent environments

### Best Practices

[](#best-practices)

```
// Get token (automatically generated if needed)
$token = $mpesa->getToken();

// For long-running processes, clear and regenerate periodically
while ($process->isRunning()) {
    // Clear token periodically (e.g., every hour) to force regeneration
    if ($shouldRefreshToken) {
        $tokenManager->clearToken();
    }

    // Your API calls here (token will be generated automatically if needed)
    $response = $mpesa->receive(...);

    sleep(60);
}
```

Parameter Validation
--------------------

[](#parameter-validation)

The SDK includes built-in parameter validation to ensure data integrity:

```
use Karson\MpesaPhpSdk\Validation\ParameterValidator;

// Validate MSISDN format
if (!ParameterValidator::validateMSISDN('258841234567')) {
    echo "Invalid phone number format";
}

// Validate transaction parameters
$params = [
    'transactionReference' => 'TXN001',
    'customerMSISDN' => '258841234567',
    'amount' => 100,
    'thirdPartyReference' => 'REF001',
    'serviceProviderCode' => '171717'
];

$errors = ParameterValidator::validateC2BParameters($params);
if (!empty($errors)) {
    foreach ($errors as $error) {
        echo "Validation Error: " . $error . "\n";
    }
}
```

Response Code Constants
-----------------------

[](#response-code-constants)

Use predefined constants for consistent response handling:

```
use Karson\MpesaPhpSdk\Constants\ResponseCodes;
use Karson\MpesaPhpSdk\Constants\TransactionStatus;

$response = $mpesa->receive('TXN001', '258841234567', 100, 'REF001');

// Check using constants
if ($response->getResponseCode() === ResponseCodes::SUCCESS) {
    echo "Transaction successful!";
}

// Check transaction status using constants
$statusResponse = $mpesa->status('REF001', 'QUERY001');
if (TransactionStatus::isCompleted($statusResponse->getTransactionStatus())) {
    echo "Transaction completed successfully";
} elseif (TransactionStatus::isPending($statusResponse->getTransactionStatus())) {
    echo "Transaction is still pending";
} elseif (TransactionStatus::isFailed($statusResponse->getTransactionStatus())) {
    echo "Transaction failed";
}
```

Testing
-------

[](#testing)

The SDK includes comprehensive unit tests to ensure reliability:

```
# Run all tests
composer test

# Run tests with coverage
./vendor/bin/phpunit --coverage-html coverage

# Run specific test suite
./vendor/bin/phpunit tests/Unit/Constants/
./vendor/bin/phpunit tests/Unit/Validation/
```

### Test Coverage

[](#test-coverage)

The test suite covers:

- **Constants**: Response codes and transaction status validation
- **Validation**: Parameter validation for all transaction types
- **Authentication**: Token management and expiration
- **Response Classes**: All response parsing and methods
- **Exceptions**: Custom exception handling

### Running Tests

[](#running-tests)

```
# Install dependencies
composer install

# Run tests
./vendor/bin/phpunit

# Run with verbose output
./vendor/bin/phpunit --verbose

# Run specific test
./vendor/bin/phpunit tests/Unit/Constants/ResponseCodesTest.php
```

What's New in v2.0
------------------

[](#whats-new-in-v20)

### 🚀 Major Improvements

[](#-major-improvements)

- **Unified API**: All transaction methods (C2B, B2C, B2B) now return the same `TransactionResponse` class
- **Eliminated Code Duplication**: ~90% reduction in response class code through unified architecture
- **Enhanced Type Safety**: Better IDE support with specific typed methods
- **Improved Performance**: Optimized response parsing and memory usage
- **Better Security**: Enhanced validation, signature verification, and error handling

### 🔄 Breaking Changes

[](#-breaking-changes)

#### Response Classes Unified

[](#response-classes-unified)

```
// Before v2.0 (multiple response classes)
$c2bResponse = $mpesa->c2b(...); // Returns C2BSyncResponse
$b2cResponse = $mpesa->b2c(...); // Returns B2CSyncResponse
$b2bResponse = $mpesa->b2b(...); // Returns B2BSyncResponse

// v2.0+ (unified response)
$c2bResponse = $mpesa->c2b(...); // Returns TransactionResponse
$b2cResponse = $mpesa->b2c(...); // Returns TransactionResponse
$b2bResponse = $mpesa->b2b(...); // Returns TransactionResponse
```

#### Removed getData() Method

[](#removed-getdata-method)

```
// Before v2.0
$transactionId = $response->getData()['output_TransactionID'];

// v2.0+ (better type safety)
$transactionId = $response->getTransactionId();
```

### 📦 New Features

[](#-new-features)

#### Enhanced Response Methods

[](#enhanced-response-methods)

```
// New methods available on all responses
$response->getThirdPartyReference();  // Available on all transaction responses
$response->isTransactionInitiated();  // Check if async transaction started
$response->isApiSuccess();            // Check M-Pesa API success
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Karson Adam](https://github.com/karson)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

PHP Package Boilerplate
-----------------------

[](#php-package-boilerplate)

This package was generated using the [PHP Package Boilerplate](https://laravelpackageboilerplate.com).

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance86

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 98.5% 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 ~90 days

Recently: every ~2 days

Total

26

Last Release

67d ago

Major Versions

1.5.0 → 2.0.02025-09-22

2.2.9 → 3.0.02026-03-09

PHP version history (3 changes)1.0.0PHP ^7.1

1.4.0PHP >=7.3

2.0.0PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/dc1132a3e4d77cdbacfc1b3f51d5b05273895a4f25f9ddcd5d1ebd56468f0978?d=identicon)[karson](/maintainers/karson)

---

Top Contributors

[![karson](https://avatars.githubusercontent.com/u/755840?v=4)](https://github.com/karson "karson (65 commits)")[![joseseie](https://avatars.githubusercontent.com/u/18400142?v=4)](https://github.com/joseseie "joseseie (1 commits)")

---

Tags

mpesampesa-apimpesa-apismpesa-onlinempesa-php-sdkmpesa-sdkonline-paymentspayment-gatewayphpsdkpayment gatewaympesakarsonmpesa-apimpesa-sdkvodacom-mozambique

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/karson-mpesa-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/karson-mpesa-php-sdk/health.svg)](https://phpackages.com/packages/karson-mpesa-php-sdk)
```

###  Alternatives

[shetabit/multipay

PHP Payment Gateway Integration Package

291348.2k3](/packages/shetabit-multipay)[luigel/laravel-paymongo

A laravel wrapper for Paymongo API

7956.2k1](/packages/luigel-laravel-paymongo)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)[itsmurumba/laravel-mpesa

Laravel Package for Mpesa Daraja API

191.6k](/packages/itsmurumba-laravel-mpesa)

PHPackages © 2026

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