PHPackages uzhlaravel/maishapay - 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. uzhlaravel/maishapay ActiveLibrary[Payment Processing](/categories/payments) uzhlaravel/maishapay ==================== This is a laravel way to interact with maishapay.net providing good design and make it easy to use v1.0.1(2mo ago)053[2 PRs](https://github.com/Uzziahlukeka/maisha-pay/pulls)MITPHPPHP ^8.3CI passing Since Sep 9Pushed 1mo agoCompare [ Source](https://github.com/Uzziahlukeka/maisha-pay)[ Packagist](https://packagist.org/packages/uzhlaravel/maishapay)[ Docs](https://github.com/uzhlaravel/maishapay)[ GitHub Sponsors](https://github.com/uzhlaravel)[ RSS](/packages/uzhlaravel-maishapay/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (13)Versions (4)Used By (0) This is a laravel way to interact with maishapay.com ==================================================== [](#this-is-a-laravel-way-to-interact-with-maishapaycom) [![Latest Version on Packagist](https://camo.githubusercontent.com/55d36b16585f82a7f2e9355d49527808650ee10edc9e9ed3fcf144026e8ced7b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f757a686c61726176656c2f6d61697368617061792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/uzhlaravel/maishapay)[![GitHub Tests Action Status](https://github.com/uzziahlukeka/maisha-pay/actions/workflows/run-tests.yml/badge.svg)](https://github.com/uzziahlukeka/maisha-pay/actions/workflows/run-tests.yml/badge.svg)[![GitHub Code Style Action Status](https://github.com/uzziahlukeka/maisha-pay/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/uzziahlukeka/maisha-pay/actions/workflows/fix-php-code-style-issues.yml/badge.svg)[![Total Downloads](https://camo.githubusercontent.com/15a4d0c07ee656cc5b0326b6edf99302c9dbcf4931db1e14cbbcf11c06447d05/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f757a686c61726176656c2f6d61697368617061792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/uzhlaravel/maishapay)[![License](https://camo.githubusercontent.com/07a7d0169027aac6d7a0bfa8964dfef5fbc40d5a2075cabb3d8bc67e17be3451/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d79656c6c6f772e737667)](LICENSE.md) Installation ------------ [](#installation) You can install the package via composer: ``` composer require uzhlaravel/maishapay ``` - if you want to have a live account, you need to register at or - if you want to have a sandbox account, you need to register at or - you need to get your public and secret keys from the dashboard - you can set the gateway mode to 0 for sandbox and 1 for live ### automated installation [](#automated-installation) ``` php artisan maishapay:install ``` You can publish and run the migrations with: ``` php artisan vendor:publish --tag="maishapay-migrations" php artisan migrate ``` You can publish the config file with: ``` php artisan vendor:publish --tag="maishapay-config" ``` This is the contents of the published config file: ``` return [ 'public_key' => env('MAISHAPAY_PUBLIC_KEY'), 'secret_key' => env('MAISHAPAY_SECRET_KEY'), 'gateway_mode' => env('MAISHAPAY_GATEWAY_MODE', 0), ]; ``` Usage Mobile Money Payment -------------------------- [](#usage-mobile-money-payment) ``` use Uzhlaravel\Maishapay\Maishapay; use Uzhlaravel\Maishapay\Models\MaishapayTransaction; use Uzhlaravel\Maishapay\DataTransferObjects\MobileMoney; use Uzhlaravel\Maishapay\Exceptions\MaishapayException; // you can use it as a parameter to a controller method protected $maishapay; public function __construct(Maishapay $maishapay) { $this->maishapay = $maishapay; } // for MOBILEMONEY payment type // validating the request data $validatedData = $request->validate([ 'amount' => 'required|numeric', 'currency' => 'required|string', 'customerFullName' => 'required|string', 'customerEmailAddress' => 'required|email', 'provider' => 'required|string', 'walletID' => 'required', 'channel' => 'required|string', ]); //if you want to keep track of the transaction $transaction = MaishapayTransaction::create([ 'payment_type' => 'MOBILEMONEY', 'provider' => $validatedData['provider'], 'amount' => $validatedData['amount'], 'currency' => $validatedData['currency'], 'customer_full_name' => $validatedData['customerFullName'], 'customer_email' => $validatedData['customerEmailAddress'], 'wallet_id' => $validatedData['walletID'], 'channel' => $validatedData['channel'], 'transaction_reference'=> 'TXN_' . uniqid(), 'status' => 'PENDING' ]); //then do the transactin $mobileMoney = new MobileMoney( amount: $validatedData['amount'], currency: $validatedData['currency'], customerFullName: $validatedData['customerFullName'], customerEmailAddress: $validatedData['customerEmailAddress'], provider: $validatedData['provider'], walletId: $validatedData['walletID'], transactionReference: $transaction->transaction_reference, callbackUrl: route('pricing') ); // Process mobile money payment $response = $this->maishapay->processMobileMoneyPayment($mobileMoney); // Parse the response $responseData = $response->json(); // or you can use implemetation directly in your controller method $maishapay = new Uzhlaravel\Maishapay\Maishapay(); $response = $this->maishapay->processMobileMoneyPayment($mobileMoney); ...(other code) ``` ### Automate the database [](#automate-the-database) ``` use Uzhlaravel\Maishapay\EnhancedMaishapayService; use Uzhlaravel\Maishapay\Models\MaishapayTransaction; use Uzhlaravel\Maishapay\DataTransferObjects\MobileMoney; use Uzhlaravel\Maishapay\Exceptions\MaishapayException; // you can use it as a parameter to a controller method protected $maishapay; public function __construct( private EnhancedMaishapayService $enhancedMaishapayService, ) { } // validating the request data $validatedData = $request->validate([ 'amount' => 'required|numeric', 'currency' => 'required|string', 'customerFullName' => 'required|string', 'customerEmailAddress' => 'required|email', 'provider' => 'required|string', 'walletID' => 'required', 'channel' => 'required|string', ]); //then do the transactin $mobileMoney = new MobileMoney( amount: $validatedData['amount'], currency: $validatedData['currency'], customerFullName: $validatedData['customerFullName'], customerEmailAddress: $validatedData['customerEmailAddress'], provider: $validatedData['provider'], walletId: $validatedData['walletID'], transactionReference: $transaction->transaction_reference, callbackUrl: route('pricing') ); // Process mobile money payment $response = $this->enhancedMaishapayService->processMobileMoneyPaymentWithLogging($mobileMoney); // Parse the response $responseData = $response->json(); // or you can use implemetation directly in your controller method $maishapay = new Uzhlaravel\Maishapay\Maishapay(); $response = $this->maishapay->processMobileMoneyPayment($mobileMoney); ...(other code) ``` Usage Bank Payment ------------------ [](#usage-bank-payment) ``` //importing the class use Uzhlaravel\Maishapay\Maishapay; use Uzhlaravel\Maishapay\Models\MaishapayTransaction; use Uzhlaravel\Maishapay\DataTransferObjects\MobileMoney; use Uzhlaravel\Maishapay\Exceptions\MaishapayException; // you can use it as a parameter to a controller method // for BANK payment type V2 // validating the request data $validatedData = $request->validate([ 'amount' => 'required|numeric', 'currency' => 'required|string', 'customerFullName' => 'required|string', 'customerEmailAddress' => 'required|email', 'provider' => 'required|string', 'walletID' => 'required', 'channel' => 'required|string', ]); // if you want to keep track $transaction = MaishapayTransaction::query()->create([ 'payment_type' => 'CARD', 'provider' => $validatedData['provider'], //visa or mastercard 'amount' => $validatedData['amount'], 'currency' => $validatedData['currency'], 'customer_full_name' => $validatedData['customerFullName'], 'customer_phone' => $validatedData['customerPhoneNumber'], 'customer_email' => $validatedData['customerEmailAddress'], 'channel' => $validatedData['channel'], 'transaction_reference'=> 'TXN_' . uniqid(), 'status' => 'PENDING' ]); $cardPayment = new CardPayment( amount: $validatedData['amount'], currency: $validatedData['currency'], customerEmailAddress: $validatedData['customerEmailAddress'], customerPhoneNumber: $validatedData['customerPhoneNumber'], provider: $validatedData['provider'], customerFullName: $validatedData['customerFullName'], transactionReference: $transaction->transaction_reference, callbackUrl: route('your-callback-route') // if different from the one in your .env file ); $response = $this->maishapay->processCardPayment($cardPayment); $responseData = $response->json(); //make sure to redirect to the payment page : return redirect($responseData['paymentPage']); (other code) ``` Automate the database transactions : ------------------------------------ [](#automate-the-database-transactions-) ``` //importing the class use Uzhlaravel\Maishapay\Services\EnhancedMaishapayService ; use Uzhlaravel\Maishapay\DataTransferObjects\CardPayment; use Uzhlaravel\Maishapay\Exceptions\MaishapayException; private EnhancedMaishapayService $enhancedMaishapayService; $cardPayment = new CardPayment( amount: $validatedData['amount'], currency: $validatedData['currency'], customerEmailAddress: $validatedData['customerEmailAddress'], customerPhoneNumber: $validatedData['customerPhoneNumber'], provider: $validatedData['provider'], customerFullName: $validatedData['customerFullName'], transactionReference: $transaction->transaction_reference, callbackUrl: route('your-callback-route') // if different from the one in your .env file ); $response = $this->enhancedMaishapayService->processCardPaymentWithLogging($cardPayment,true); $responseData = $response->json(); //make sure to redirect to the payment page : ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [uzziahlukeka](https://github.com/uzhlaravel) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 42 — FairBetter than 90% of packages Maintenance88 Actively maintained with recent releases Popularity11 Limited adoption so far Community9 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.9% 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 ~161 days Total 2 Last Release 83d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/0c60a7476f54a95b4e406d4754f377ec19c39ee9c91a8e80c52d82ba57af3ab9?d=identicon)[uzziahlukeka](/maintainers/uzziahlukeka) --- Top Contributors [![Uzziahlukeka](https://avatars.githubusercontent.com/u/102746022?v=4)](https://github.com/Uzziahlukeka "Uzziahlukeka (26 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") --- Tags laravelmobilemoneypayment-gatewayrdclaravelpaymentgatewaypayment gatewayafricauzhlaravelmaishapaypayment gateway laravelDRCongo ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/uzhlaravel-maishapay/health.svg) ``` [![Health](https://phpackages.com/badges/uzhlaravel-maishapay/health.svg)](https://phpackages.com/packages/uzhlaravel-maishapay) ``` ### Alternatives [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)[creagia/laravel-redsys Laravel Redsys Payments Gateway 2013.6k](/packages/creagia-laravel-redsys)[parsisolution/gateway A Laravel package for connecting to all Iraninan payment gateways 231.7k](/packages/parsisolution-gateway) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)