PHPackages                             geekabel/mobile-money-payment - 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. geekabel/mobile-money-payment

ActiveLibrary[Payment Processing](/categories/payments)

geekabel/mobile-money-payment
=============================

A flexible and extensible PHP package for integrating mobile money payment services, supporting Tmoney and Flooz payment providers.

v1.1.0(1y ago)01MITPHPPHP >=8.2

Since Sep 23Pushed 1y ago1 watchersCompare

[ Source](https://github.com/geekabel/mobile-money-payment)[ Packagist](https://packagist.org/packages/geekabel/mobile-money-payment)[ RSS](/packages/geekabel-mobile-money-payment/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (6)Versions (4)Used By (0)

Mobile Money Payment Package
============================

[](#mobile-money-payment-package)

Overview
--------

[](#overview)

The Mobile Money Payment package provides a flexible and extensible solution for integrating mobile money payment services into PHP applications. It currently supports Tmoney and Flooz payment services, with an architecture that allows easy addition of new payment providers.

Features
--------

[](#features)

- Support for multiple payment services (currently Tmoney and Flooz)
- Extensible architecture using the Strategy pattern
- Standardized payment responses across different services
- Flexible Flooz counter management system
- Easy integration with various PHP applications, including Symfony

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Symfony HTTP Client

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

[](#installation)

Install the package via Composer:

```
composer geekabel/mobile-money-payment
```

Basic Usage
-----------

[](#basic-usage)

### Setting up the Payment Manager

[](#setting-up-the-payment-manager)

```
use MobileMoneyPayment\PaymentManager;
use MobileMoneyPayment\Service\TmoneyService;
use MobileMoneyPayment\Service\FloozService;
use MobileMoneyPayment\Service\DefaultFloozCounterManager;

// Create service instances
$tmoneyService = new TmoneyService(
    $httpClient,
    $logger,
    'tmoney_username',
    'tmoney_password',
    'tmoney_alias',
    'https://tmoney-api-url.com'
);

$floozService = new FloozService(
    $httpClient,
    $logger,
    new DefaultFloozCounterManager(),
    'flooz_username',
    'flooz_password',
    'flooz_key',
    'flooz_merchant_name',
    'flooz_partner_msisdn',
    'https://flooz-api-url.com'
);

// Create and set up the Payment Manager
$paymentManager = new PaymentManager();
$paymentManager->addService('tmoney', $tmoneyService);
$paymentManager->addService('flooz', $floozService);
```

### Making a Payment

[](#making-a-payment)

```
$response = $paymentManager->pay('tmoney', '1234567890', 100.00, 'REF123', 'Payment for order #123');

if ($response->success) {
    echo "Payment successful! Transaction ID: " . $response->transactionId;
} else {
    echo "Payment failed: " . $response->message;
}
```

### Checking Payment Status

[](#checking-payment-status)

```
$status = $paymentManager->checkStatus('flooz', 'REF123');

echo "Payment status: " . $status->status;
```

Extending the Package
---------------------

[](#extending-the-package)

### Adding a New Payment Service

[](#adding-a-new-payment-service)

1. Create a new class that implements `PaymentServiceInterface`:

```
use MobileMoneyPayment\Interface\PaymentServiceInterface;
use MobileMoneyPayment\Model\PaymentResponse;

class NewPaymentService implements PaymentServiceInterface
{
    public function pay(string $phone, float $amount, string $reference, string $description = ''): PaymentResponse
    {
        // Implement payment logic
    }

    public function checkStatus(string $reference): PaymentResponse
    {
        // Implement status check logic
    }
}
```

2. Add the new service to the Payment Manager:

```
$newService = new NewPaymentService(/* ... */);
$paymentManager->addService('new_service', $newService);
```

### Custom Flooz Counter Manager

[](#custom-flooz-counter-manager)

1. Create a class that implements `FloozCounterManagerInterface`:

```
use MobileMoneyPayment\Interface\FloozCounterManagerInterface;

class CustomFloozCounterManager implements FloozCounterManagerInterface
{
    public function getAndIncrementCounter(): int
    {
        // Implement custom counter logic
    }
}
```

2. Use the custom manager when creating the Flooz service:

```
$customCounterManager = new CustomFloozCounterManager();
$floozService = new FloozService(
    $httpClient,
    $logger,
    $customCounterManager,
    // ... other parameters
);
```

Advanced Usage
--------------

[](#advanced-usage)

### Error Handling

[](#error-handling)

The package uses `PaymentException` for specific payment-related errors. It's recommended to catch these exceptions:

```
use MobileMoneyPayment\Exception\PaymentException;

try {
    $response = $paymentManager->pay('tmoney', '1234567890', 100.00, 'REF123');
} catch (PaymentException $e) {
    echo "Payment error: " . $e->getMessage();
} catch (\Exception $e) {
    echo "Unexpected error: " . $e->getMessage();
}
```

### Logging

[](#logging)

The package accepts a PSR-3 compatible logger. You can provide your own logger implementation for custom logging behavior:

```
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$logger = new Logger('payment');
$logger->pushHandler(new StreamHandler('path/to/your.log', Logger::DEBUG));

$tmoneyService = new TmoneyService(
    $httpClient,
    $logger,
    // ... other parameters
);
```

Symfony Integration
-------------------

[](#symfony-integration)

For detailed instructions on how to integrate this package with Symfony 6.4, 7.0, 7.1, and superior versions, please refer to our [Symfony Integration Guide](docs/SYMFONY_INTEGRATION.md).

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

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance45

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 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 ~172 days

Total

2

Last Release

424d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

phpsymfonypaymentmobile-moneytmoneyflooz

###  Code Quality

TestsPHPUnit

Static AnalysisRector

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/geekabel-mobile-money-payment/health.svg)

```
[![Health](https://phpackages.com/badges/geekabel-mobile-money-payment/health.svg)](https://phpackages.com/packages/geekabel-mobile-money-payment)
```

###  Alternatives

[yandex-money/yandex-money-sdk-php

Yandex.Money API SDK for PHP

105167.4k2](/packages/yandex-money-yandex-money-sdk-php)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1322.1k12](/packages/mahocommerce-maho)[miracode/stripe-bundle

Symfony bundle to integrate Stripe PHP SDK. Ability to save Stripe objects in database using Doctrine.

1016.1k](/packages/miracode-stripe-bundle)[fpt/stripe-bundle

Stripe bundle for Symfony 5.4 / 6 / 7

1521.2k](/packages/fpt-stripe-bundle)[cryptonator/merchant-php-sdk

Cryptonator.com Merchant API SDK for PHP

2713.7k](/packages/cryptonator-merchant-php-sdk)

PHPackages © 2026

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