PHPackages henryejemuta/laravel-monnify - 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. henryejemuta/laravel-monnify ActiveLibrary[Payment Processing](/categories/payments) henryejemuta/laravel-monnify ============================ A laravel package to seamlessly integrate monnify api within your laravel application v1.3.1(6d ago)132.1k22MITPHPPHP ^8.0CI passing Since Jul 15Pushed 6d ago2 watchersCompare [ Source](https://github.com/henryejemuta/laravel-monnify)[ Packagist](https://packagist.org/packages/henryejemuta/laravel-monnify)[ RSS](/packages/henryejemuta-laravel-monnify/feed)WikiDiscussions main Synced 2d ago READMEChangelog (10)Dependencies (10)Versions (15)Used By (0) Laravel Monnify =============== [](#laravel-monnify) [![Build Status](https://camo.githubusercontent.com/7c6915c5444ea7426a987fab1086ab14c7bd81d3456b9672641c4638a1afa8a4/68747470733a2f2f7472617669732d63692e6f72672f68656e7279656a656d7574612f6c61726176656c2d6d6f6e6e6966792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/henryejemuta/laravel-monnify)[![Latest Version on Packagist](https://camo.githubusercontent.com/55c83c6b7beb9679e9c9ea0840585cab2702c13a8b426787f75c0ed38f7f9746/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68656e7279656a656d7574612f6c61726176656c2d6d6f6e6e6966792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/henryejemuta/laravel-monnify)[![Latest Stable Version](https://camo.githubusercontent.com/b8dfd7c57f9ac9f0a9fd15002630660928485305b8ccb268d8bbab411c75d2d4/68747470733a2f2f706f7365722e707567782e6f72672f68656e7279656a656d7574612f6c61726176656c2d6d6f6e6e6966792f762f737461626c65)](https://packagist.org/packages/henryejemuta/laravel-monnify)[![Total Downloads](https://camo.githubusercontent.com/72cc51bf9dded777a2102a8d7fad991913b20beb5a10109d325fe04ffef72e9c/68747470733a2f2f706f7365722e707567782e6f72672f68656e7279656a656d7574612f6c61726176656c2d6d6f6e6e6966792f646f776e6c6f616473)](https://packagist.org/packages/henryejemuta/laravel-monnify)[![License](https://camo.githubusercontent.com/1c5923c0643ecc949f4f243b9fd04486c5911440c7643347158ab679eabd992f/68747470733a2f2f706f7365722e707567782e6f72672f68656e7279656a656d7574612f6c61726176656c2d6d6f6e6e6966792f6c6963656e7365)](https://packagist.org/packages/henryejemuta/laravel-monnify)[![Quality Score](https://camo.githubusercontent.com/246b21001277883538560346c40a82a1ede1e77efb23eda9a68838eaf1b9d1f5/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f68656e7279656a656d7574612f6c61726176656c2d6d6f6e6e6966792e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/henryejemuta/laravel-monnify) A laravel package to seamlessly integrate monnify api within your laravel application What is Monnify --------------- [](#what-is-monnify) Monnify is a leading payment technology that powers seamless transactions for businesses through omnichannel platforms Create a Monnify Account [Sign Up](https://app.monnify.com/create-account). Look up Monnify API Documentation [API Documentation](https://teamapt.atlassian.net/wiki/spaces/MON/overview). Installation ------------ [](#installation) You can install the package via composer: ``` composer require henryejemuta/laravel-monnify ``` Publish Monnify configuration file, migrations as well as set default details in .env file: ``` php artisan monnify:init ``` Laravel Monnify Webhook Event (RESERVED ACCOUNT SHOULD USE THIS) ---------------------------------------------------------------- [](#laravel-monnify-webhook-event-reserved-account-should-use-this) To handle Monnify Webhook event-based notifications, the Laravel Monnify already include all required webhook endpoints Log on to your [Monnify Dashboard Setting](https://app.monnify.com/settings), under Developer menu, select **Webhook URLs** and set the respective webhook URL as follows: - Transaction completion `https://your_domain/laravel-monnify/webhook/transaction-completion` - Refund completion `https://your_domain/laravel-monnify/webhook/refund-completion` - Disbursement `https://your_domain/laravel-monnify/webhook/disbursement` - Settlement `https://your_domain/laravel-monnify/webhook/settlement` NOTE: Make sure you replace `your_domain` with your server url e.g. example.com ##### LEGACY Webhook [](#legacy-webhook) To handle Monnify LEGACY Webhook notification the Laravel Monnify already include the webhook endpoint `https://your_domain/laravel-monnify/webhook`, replace `your_domain` with your server url e.g. example.com - Log on to your [Monnify Dashboard Setting](https://app.monnify.com/settings), select **API Keys & Webhooks** and set your webhook to `https://your_domain/laravel-monnify/webhook` ##### Setup Listener [](#setup-listener) Next, create an Event Listener by running the command below within your project directory; ``` php artisan make:listener MonnifyNotificationListener -e NewWebHookCallReceived ``` The `NewWebHookCallReceived` has two properties: - `WebHookCall webHookCall` => This is an unguarded Model with property dump from the webhook call `$event->webHookCall->transactionReference` gives you the transactionReference from the webhook call, learn more about Transaction Completion Webhook properties on Monnify API Docs [Here](https://teamapt.atlassian.net/wiki/spaces/MON/pages/213909300/Transaction+Completion+Webhook) - `bool isValidTransactionHash` => This does the transaction hash calculation for you ahead of time, if you prefer doing it yourself; `Monnify::Transactions()->calculateHash($event->webHookCall->paymentReference, $event->webHookCall->amountPaid, $event->webHookCall->paidOn, $event->webHookCall->transactionReference);`Laravel Monnify Webhook Event Please see [MonnifyLegacyNotificationListener.example.txt](MonnifyLegacyNotificationListener.example.txt) for LEGACY sample implementation of the MonnifyNotificationListener. Please see [MonnifyNotificationListener.example.txt](MonnifyNotificationListener.example.txt) for LEGACY sample implementation of the MonnifyNotificationListener. ### Note [](#note) To ensure your listener works correctly, you have to register the event within in your `App\Providers\EventServiceProvider` manually if auto discovery isn't turned on ##### Manually Registering Events [](#manually-registering-events) Typically, events should be registered via the `EventServiceProvider` `$listen` array; however, you may also register class or closure based event listeners manually in the `boot` method of your `EventServiceProvider`: [Learn More](https://laravel.com/docs/events#manually-registering-events) about manually registering events ``` use HenryEjemuta\LaravelMonnify\Events\NewWebHookCallReceived; use App\Listeners\MonnifyNotificationListener; /** * The event listener mappings for the application. * * @var array */ protected $listen = [ // ... Other Event Registeration NewWebHookCallReceived::class => [ MonnifyNotificationListener::class, // ... Other Listener you wish to also receive the WebHook call event ], ]; ``` or ##### Turn On Event Discovery [](#turn-on-event-discovery) Event discovery is disabled by default, but you can enable it by overriding the `shouldDiscoverEvents` method of your application's `EventServiceProvider`: [Learn More](https://laravel.com/docs/events#event-discovery) about Event Discovery ``` /** * Determine if events and listeners should be automatically discovered. * * @return bool */ public function shouldDiscoverEvents() { return true; } ``` Usage ----- [](#usage) > To use the monnify package you must import the Monnify Facades with the import statement below; Other Classes import is based on your specific usage and would be highlighted in their corresponding sections. You'll also need to import the MonnifyFailedRequestException and handle the exception as all failed request will throw this exception the with the corresponding monnify message and code [Learn More](https://docs.teamapt.com/display/MON/Transaction+Responses) ``` //... use HenryEjemuta\LaravelMonnify\Facades\Monnify; use HenryEjemuta\LaravelMonnify\Exceptions\MonnifyFailedRequestException; //... ``` Important Notice!!! =================== [](#important-notice) ### Migrating from Previous Version of Laravel Monnify [](#migrating-from-previous-version-of-laravel-monnify) This new changes reflect my concern for modular code base, I'm certain you should not have any issues migrating and refactoring your codebase, but if you do, kindly contact me or use the issues tab, and I will make sure your concerns are all attended to. The Monnify class has been broken down grouping all actions into five(5) classes, Banks, CustomerReservedAccounts, Disbursements, SubAccounts, and Transactions see example usage below: ``` //... use HenryEjemuta\LaravelMonnify\Facades\Monnify; //... $responseBody = Monnify::Transactions()->initializeTransaction(float $amount, string $customerName, string $customerEmail, string $paymentReference, string $paymentDescription, string $redirectUrl, MonnifyPaymentMethods $monnifyPaymentMethods, MonnifyIncomeSplitConfig $incomeSplitConfig = null, string $currencyCode = null); $responseBody = Monnify::Transactions()->getAllTransactions(array $queryParams); $responseBody = Monnify::Transactions()->calculateHash(string $paymentReference, $amountPaid, string $paidOn, string $transactionReference); $responseBody = Monnify::Transactions()->getTransactionStatus(string $transactions); $responseBody = Monnify::Transactions()->payWithBankTransfer(string $transactionReference, string $bankCode); ``` Before ------ [](#before) ``` //... use HenryEjemuta\LaravelMonnify\Facades\Monnify; use HenryEjemuta\LaravelMonnify\Classes\MonnifyPaymentMethod; use HenryEjemuta\LaravelMonnify\Classes\MonnifyPaymentMethods; //... Monnify::initializeTransaction( 15000, "Customer Name", "customer@example.com", "transaction_ref", "Transaction Description", "https://youdomain.com/afterpaymentendpoint", new MonnifyPaymentMethods(MonnifyPaymentMethod::CARD(), MonnifyPaymentMethod::ACCOUNT_TRANSFER())); ``` Now --- [](#now) ``` //... use HenryEjemuta\LaravelMonnify\Facades\Monnify; use HenryEjemuta\LaravelMonnify\Classes\MonnifyPaymentMethod; use HenryEjemuta\LaravelMonnify\Classes\MonnifyPaymentMethods; //... Monnify::Transactions()->initializeTransaction( 15000, "Customer Name", "customer@example.com", "transaction_ref", "Transaction Description", "https://youdomain.com/afterpaymentendpoint", new MonnifyPaymentMethods(MonnifyPaymentMethod::CARD(), MonnifyPaymentMethod::ACCOUNT_TRANSFER())); ``` Similar implementation applies to other sections (i.e. Banks, CustomerReservedAccounts, Disbursements, and SubAccounts) ``` //... use HenryEjemuta\LaravelMonnify\Facades\Monnify; //... $responseBody = Monnify::Banks()->getBanks(); $responseBody = Monnify::Banks()->getBanksWithUSSDShortCode(); $responseBody = Monnify::Banks()->validateBankAccount(MonnifyBankAccount $bankAccount); $responseBody = Monnify::Disbursements()->initiateTransferSingle(float $amount, string $reference, string $narration, MonnifyBankAccount $bankAccount, string $currencyCode = null); $responseBody = Monnify::Disbursements()->initiateTransferSingleWithMonnifyTransaction(MonnifyTransaction $monnifyTransaction); $responseBody = Monnify::Disbursements()->initiateTransferBulk(string $title, string $batchReference, string $narration, MonnifyOnFailureValidate $onFailureValidate, int $notificationInterval, MonnifyTransactionList $transactionList); $responseBody = Monnify::Disbursements()->authorizeTransfer2FA(string $authorizationCode, string $reference, string $path); $responseBody = Monnify::SubAccounts()->createSubAccount(string $bankCode, string $accountNumber, string $email, string $currencyCode = null, string $splitPercentage = null); $responseBody = Monnify::SubAccounts()->createSubAccounts(array $accounts); $responseBody = Monnify::SubAccounts()->getSubAccounts(); $responseBody = Monnify::SubAccounts()->deleteSubAccount(string $subAccountCode); $responseBody = Monnify::ReservedAccounts()->getAllTransactions(array $queryParams); $responseBody = Monnify::ReservedAccounts()->reserveAccount(string $accountReference, string $accountName, string $customerEmail, string $customerName = null, string $customerBvn = null, string $currencyCode = null, bool $restrictPaymentSource = false, MonnifyAllowedPaymentSources $allowedPaymentSources = null, MonnifyIncomeSplitConfig $incomeSplitConfig = null); $responseBody = Monnify::ReservedAccounts()->getAccountDetails(string $accountReference); $responseBody = Monnify::ReservedAccounts()->getAccountDetails(string $accountReference); $responseBody = Monnify::ReservedAccounts()->updateSplitConfig(string $accountReference, MonnifyIncomeSplitConfig $incomeSplitConfig); $responseBody = Monnify::Verification()->validateBVN(string $bvn, string $name, string $dob, string $mobileNo); $responseBody = Monnify::Verification()->validateBVNAccountInvalidation(string $bvn, string $accountNumber, string $bankCode); $responseBody = Monnify::Verification()->validateNIN(string $nin); ``` ### Testing [](#testing) ``` composer test ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Bugs & Issues ----------------- [](#bugs--issues) If you notice any bug or issues with this package kindly create and issues here [ISSUES](https://github.com/henryejemuta/laravel-monnify/issues) ### Security [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Henry Ejemuta](https://github.com/henryejemuta) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 56 — FairBetter than 98% of packages Maintenance98 Actively maintained with recent releases Popularity30 Limited adoption so far Community16 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 95.7% 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 ~212 days Recently: every ~396 days Total 11 Last Release 6d ago PHP version history (5 changes)v1.0.0-alphaPHP >=7.1 v1.0PHP ^7.2 v1.1.0PHP ^7.2|^8.0 v1.2.2PHP ^7.4|^8.0 v1.3.0PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/54673a3d375309540e1831b2827b8bf499d048dfe3cdb56193cf575c4105d85f?d=identicon)[henryejemuta](/maintainers/henryejemuta) --- Top Contributors [![henryejemuta](https://avatars.githubusercontent.com/u/13375596?v=4)](https://github.com/henryejemuta "henryejemuta (45 commits)")[![Kessir](https://avatars.githubusercontent.com/u/2332730?v=4)](https://github.com/Kessir "Kessir (1 commits)")[![OGKingD](https://avatars.githubusercontent.com/u/44497964?v=4)](https://github.com/OGKingD "OGKingD (1 commits)") --- Tags laravelpaymentcard-paymentbank transfermonnify ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/henryejemuta-laravel-monnify/health.svg) ``` [![Health](https://phpackages.com/badges/henryejemuta-laravel-monnify/health.svg)](https://phpackages.com/packages/henryejemuta-laravel-monnify) ``` ### Alternatives [sebdesign/laravel-viva-payments A Laravel package for integrating the Viva Payments gateway 4845.9k](/packages/sebdesign-laravel-viva-payments) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)