hachther/mesomb

This package is abandoned and no longer maintained. The author suggests using the hachther/mesomb-php package instead.

MeSomb PHP Library

3.0.0 2025-03-04 12:46 UTC

Requires

• ext-curl: *
• ext-json: *
• ext-mbstring: *
• ext-openssl: *

Requires (Dev)

• phpdocumentor/shim: ^3.6
• phpunit/phpunit: ^9.5

MIT

• Hachther LLC

• api
• payment processing
• mobile money
• Orange Money
• mesomb

README

PHP client for MeSomb services.

You can check the full documentation of the api here

🏠 Requirements

PHP 5.6.0 and later.

Composer

You can install the bindings via Composer. Run the following command:

composer require hachther/mesomb-php

To use the bindings, use Composer's autoload:

require_once 'vendor/autoload.php';

Manual Installation

If you do not wish to use Composer, you can download the latest release. Then, to use the bindings, include the init.php file.

require_once '/path/to/mesomb-php/init.php';

Dependencies

The bindings require the following extensions in order to work properly:

• curl, although you can use your own non-cURL client if you prefer
• json
• mbstring (Multibyte String)

If you use Composer, these dependencies should be handled automatically. If you install manually, you'll want to make sure that these extensions are available.

Getting Stated

Collect money from an account

<?php
use MeSomb\Operation\PaymentOperation;

$applicationKey = 'application key';
$accessKey = 'access key';
$secretKey = 'secret key';
$client = new PaymentOperation($applicationKey, $accessKey, $secretKey);

$response = $client->makeCollect([
    'payer' => '670000000',
    'amount' => 10000,
    'service' => 'MTN',
    'country' => 'CM',
    'currency' => 'XAF',
    'customer' => [
        'email' => '[e-mail]',
        'first_name' => 'Dan',
        'last_name' => 'Fisher',
        'town' => 'Douala',
        'region' => 'Littoral',
        'country' => 'CM',
        'address' => 'Bepanda',
    ],
    'products' => [
        [
            'id' => 'SKU001',
            'name' => 'Sac a Dos',
            'category' => 'Sac',
            'quantity' => 1,
            'amount' => 10000
        ]
    ],
    'location' => [
        'town' => 'Douala',
        'region' => 'Littoral',
        'country' => 'CM'
    ]
]);
$response->isOperationSuccess();
$response->isTransactionSuccess();

Depose money in an account

<?php
use MeSomb\Operation\PaymentOperation;

$applicationKey = 'application key';
$accessKey = 'access key';
$secretKey = 'secret key';
$client = new PaymentOperation($applicationKey, $accessKey, $secretKey);

$response = $client->makeDeposit([
    'receiver' => '670000000',
    'amount' => 10000,
    'service' => 'MTN',
    'country' => 'CM',
    'currency' => 'XAF',
    'customer' => [
        'email' => '[e-mail]',
        'first_name' => 'Dan',
        'last_name' => 'Fisher',
        'town' => 'Douala',
        'region' => 'Littoral',
        'country' => 'CM',
        'address' => 'Bepanda',
    ],
    'products' => [
        [
            'id' => 'SKU001',
            'name' => 'Sac a Dos',
            'category' => 'Sac',
            'quantity' => 1,
            'amount' => 10000
        ]
    ],
    'location' => [
        'town' => 'Douala',
        'region' => 'Littoral',
        'country' => 'CM'
    ]
]);
$response->isOperationSuccess();
$response->isTransactionSuccess();

Get application status

<?php
use MeSomb\Operation\PaymentOperation;
use MeSomb\Util\RandomGenerator;

$client = new PaymentOperation('<applicationKey>', '<AccessKey>', '<SecretKey>');
$application = $client->getStatus();
print_r($application->getStatus());
print_r($application->getBalance());

Get transactions by ids

<?php
use MeSomb\Operation\PaymentOperation;

$applicationKey = 'application key';
$accessKey = 'access key';
$secretKey = 'secret key';
$client = new PaymentOperation($applicationKey, $accessKey, $secretKey);
$response = $client->getTransactions(['a483a9e8-51d7-44c9-875b-1305b1801274']);
print_r($response);

Documentation

Payment

All API related to the payment service available in MeSomb\Operation\PaymentOperation

Method	Endpoint	Description
makeCollect	payment/collect/	Collect money from a mobile account
makeDeposit	payment/deposit/	Make a deposit in a receiver mobile account
updateSecurity	payment/security/	Update security settings of your service on MeSomb
getStatus	payment/status/	Get the current status of your service on MeSomb
getTransactions	payment/transactions/	Get transactions from MeSomb by IDs.

Author

👤 Hachther LLC [e-mail]

• Website: https://www.hachther.com
• Twitter: @hachther
• Github: @hachther
• LinkedIn: @hachther

Show your support

Give a ⭐️ if this project helped you!