Download the PHP package triverla/laravel-monnify without Composer
On this page you can find all versions of the php package triverla/laravel-monnify. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download triverla/laravel-monnify
More information about triverla/laravel-monnify
Files in triverla/laravel-monnify
Informations about the package laravel-monnify
laravel-monnify
Installation
PHP 7.4+ or HHVM 3.3+, and Composer are required.
To get the latest version of Laravel Monnify, simply require it
Or add the following line to the require block of your composer.json
file.
You'll then need to run composer install
or composer update
to download it and have the autoloader updated.
Once Laravel Monnify is installed, you need to register the service provider. Open up config/app.php
and add the following to the providers
key.
If you use Laravel >= 5.5 you can skip this step and go to
configuration
Triverla\LaravelMonnify\MonnifyServiceProvider::class
Also, register the Facade like so:
Configuration
You can publish the configuration file using this command:
A configuration file monnify.php
with some sensible defaults will be placed in your config
directory as displayed below:
General Payment Flow
Though there are multiple ways to pay an order, most payment gateways expect you to follow the following flow in your checkout process:
1. The customer is redirected to the payment provider
After the customer has gone through the checkout process and is ready to pay, the customer must be redirected to the site of the payment provider.
The redirection is accomplished by submitting a form with some hidden fields. The form must send a POST request to the site of the payment provider. The hidden fields minimally specify the amount that must be paid, customer's name, email and a reference.
The reference is used by the payment provider as payment reference and can be used to verify the transaction.
2. The customer pays on the site of the payment provider
The customer visits the payment provider's site and gets to choose a payment method as specified in the request. All steps necessary to pay the order are taken care of by the payment provider.
3. The customer gets redirected back to your site
After having paid the order the customer is redirected back. In the redirection request to the website some values are returned. The values are usually the paymentReference or a transactionReference.
The payment reference is gotten from the request sent and it is used to verify if the transaction is valid and comes from the payment provider. It is paramount that this reference is thoroughly checked.
Usage
Open your .env file and add the following keys. You can get them at (https://app.monnify.com/developer):
Set up routes and controller methods like so:
Note: Make sure you have /payment/callback
added as redirect_url
in your payment request
Example
Or
OR
OR
Alternatively,
Usage
- import the Monnify Facades with the import statement below;
- Also import the FailedRequestException that handles the exceptions thrown from failed requests. This exception returns the corresponding monnify error message and code Learn More
Other methods include
Testing
Todo
- Add more tests
Contributing
Please feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.
Bugs & Issues
If you notice any bug or issues with this package kindly create and issues here ISSUES
Security
If you discover any security related issues, please email [email protected].
How can I thank you?
Why not star the github repo and share the link for this repository on Twitter or other social platforms.
Don't forget to follow me on twitter!
Thanks! Benaiah Yusuf
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-monnify with dependencies
illuminate/support Version ~6|~7|~8|~9|^10.0
guzzlehttp/guzzle Version ~6|~7|~8|~9
ext-json Version *