Laravel Payfort provides a simple and rich way to perform and handle operations for
Payfort (MEA based online payment gateway) check here to read more Payfort.
This package supports a set of Payfort operations as listed below, other operations are open for future work and
contribution.
- AUTHORIZATION/PURCHASE
- CAPTURE
- TOKENIZATION
- SDK_TOKEN
- CHECK_STATUS
- REFUND
You have to read the Payfort documentation very well before proceeding in using any package, the package author
will not write about Payfort operations, what and how to use.
You can install Laravel Payfort package to your laravel project via composer command:
$ composer require midoelhawy/laravel-payfort
After installing the Laravel Payfort library, register the LaravelPayfort\Providers\PayfortServiceProvider
in your config/app.php configuration file:
'providers' => [
// Other service providers...
LaravelPayfort\Providers\PayfortServiceProvider::class,
],Also, add the Payfort facade to the aliases array in your app configuration file:
'Payfort' => LaravelPayfort\Facades\Payfort::classAfter that, run the following command to publish the configurations file:
$ php artisan vendor:publish --provider "LaravelPayfort\Providers\PayfortServiceProvider"
This will create a new config file named payfort.php in config folder. Then you have to add the following
constants in the .env file, you can find most of these values in your Payfort account.
PAYFORT_USE_SANDBOX=true #Defines wether to activate the payfort sandbox env or not.
PAYFORT_USE_TEST_ENV=true #Define Test env mode for development
PAYFORT_MERCHANT_IDENTIFIER=51e316554 # The payfort merchant account identifier
PAYFORT_ACCESS_CODE=XwMv28sHSAkSaB71uGON # The payfort account access code
PAYFORT_SHA_TYPE=sha256 # The payfort account sha type. sha256/sha512
PAYFORT_SHA_REQUEST_PHRASE=58obfoddsfg.. # The payfort account sha request phrase
PAYFORT_SHA_RESPONSE_PHRASE=86md5f56s.. # The payfort account sha response phrase
PAYFORT_CURRENCY=SAR # The default currency for you app. Currency ISO code 3.
PAYFORT_LANGUAGE=EN # The system default langauge for response messages
PAYFORT_RETURN_URL=/payfort/response # The url to return after submitting payfort forms.
Once all configuration steps are done, you are ready to use payfort operations in your app. Here is some examples on how to use this package:
To display payfort authorization or purchase page, in your controller's method add the following code snippet:
return Payfort::redirection()->displayRedirectionPage([
'command' => 'AUTHORIZATION', # AUTHORIZATION/PURCHASE according to your operation.
'merchant_reference' => 'ORDR.'.rand(10000,100000),
'amount' => 3501.35,
'currency' => 'SAR',
'customer_email' => '[email protected]',
'payment_option' => 'VISA', //Mada and others types
"language"=>'ar',
'return_url'=>"https://expm.com/response"
]);⚠ Note
Mada payment method works only as PURCHASE (not as AUTHORIZATION).
Other optional parameters that can be passed to displayRedirectionPage method as follows:
- token_name
- sadad_olp
- eci
- order_description
- customer_ip
- customer_name
- merchant_extra
- merchant_extra1
- merchant_extra2
- merchant_extra3
Payfort page will be displayed and once user submits the payment form, the return url defined in the environment
configurations will be called.
See Payfort documentation for more info.
To display payfort tokenization page, in your controller's method add the following code snippet:
return Payfort::redirection()->displayTokenizationPage([
'merchant_reference' => 'ORDR.34562134', # You reference id for this operation (Order id for example).
]); Payfort page will be displayed and once user submits the payment form, the return url defined in the config file
will be called.
To Capture after callback AUTHORIZATION, in your controller's method add the following code snippet:
$checkpayfort->captureOperationByFortId(
[
"fort_id"=>$payfort_return["fort_id"],
"merchant_reference"=>$payfort_return["merchant_reference"],
"amount"=>3501.35,//your amount to capture (max : the authraized amount)
"currency"=>"SAR",
]
);See Payfort documentation for more info.
In your handling controller that handle the return url, you can simply use the PayfortResponse trait as follows:
use LaravelPayfort\Traits\PayfortResponse as PayfortResponse;
class PayfortOrdersController extends Controller{
use PayfortResponse;
public function processReturn(Request $request){
$payfort_return = $this->handlePayfortCallback($request);
$checkpayfort =new PayfortAPI(config('payfort'));
$checkStatus = $checkpayfort->checkOrderStatusByFortId($payfort_return["fort_id"]);
if($checkStatus->isSuccess()){
return $checkStatus->getResponse();//return payfort json array
}
if($payfort_return["command"] == "AUTHORIZATION"){
$captureAuthorizaPymnt = $checkpayfort->captureOperationByFortId(
[
"fort_id"=>$payfort_return["fort_id"],
"merchant_reference"=>$payfort_return["merchant_reference"],
"amount"=>3501.35,//your amount to capture (max : the authraized amount)
"currency"=>"SAR",
]
);
if($captureAuthorizaPymnt->isSuccess()){
//success payment
}
//....
}
}
}
See Payfort documentation for more info.
Same as handling payfort response except that you have to call handlePayfortFeedback instead of handlePayfortCallback
Want to improve this package or found a bug ?. Open an issue or do this contribution by yourself and get this honor.
Simply, fork => do you work => make pull request.
Write clear comments and description ;-).
Laravel Payfort is open-sourced software licensed under the MIT license
This Library implemented on :