بدلیل عدم پشتیبانی تیم Larabook این پکیج بصورت شخصی توسعه میابد
پکیج اتصال به تمامی IPG ها و بانک های ایرانی.
این پکیج با ورژن های ( ۴ و ۵ و ۶ و۷ و ۸ و ۹) لاراول سازگار می باشد
پشتیبانی تنها از درگاهای زیر می باشد:
- MELLAT
- SADAD (MELLI)
- SAMAN Token Base (جدید)
- SAMAN
- PARSIAN
- PASARGAD(جدید)
- ZARINPAL
- ASAN PARDAKHT
- PAY.IR ( برای فراخوانی از 'payir' استفاده نمایید)
- Irankish (جدید - برای فراخوانی از 'irankish' استفاده نمایید)
- Nikan (PASARGAD) (جدید)
- PayPing (جدید)
- Vandar (جدید)
نصب:
دستورات زیر را جهت نصب دنبال کنید :
مرحله ۱)
composer require mozakar/gateway"require": {
...
"mozakar/gateway" : "dev-master"
},
"repositories": [
{
"type": "git",
"url": "https://github.com/mozakar/gateway.git"
}
],مرحله ۲)
تغییرات زیر را در فایل config/app.php اعمال نمایید:
توجه برای نسخه های لاراول ۶ به بعد این مرحله نیاز به انجام نمی باشد
'providers' => [
...
Mozakar\Gateway\GatewayServiceProvider::class, // <-- add this line at the end of provider array
],
'aliases' => [
...
'Gateway' => Mozakar\Gateway\Gateway::class, // <-- add this line at the end of aliases array
]مرحله ۳) - انتقال فایل های مورد نیاز
برای لاراول ۵ :
php artisan vendor:publish --provider=Mozakar\Gateway\GatewayServiceProviderLaravel5php artisan vendor:publish
// then choose : GatewayServiceProviderLaravel6
// then choose : GatewayServiceProviderLaravel7
// then choose : GatewayServiceProviderLaravel8
// then choose : GatewayServiceProviderLaravel9مرحله ۴) - ایجاد جداول
php artisan migrateمرحله ۵)
عملیات نصب پایان یافته است حال فایل gateway.php را در مسیر app/ باز نموده و تنظیمات مربوط به درگاه بانکی مورد نظر خود را در آن وارد نمایید .
حال میتوایند برای اتصال به api بانک از یکی از روش های زیر به انتخاب خودتان استفاده نمایید . (Facade , Service container):
- Gateway::make(new Mellat())
- Gateway::make('mellat')
- Gateway::mellat()
- app('gateway')->make(new Mellat());
- app('gateway')->mellat();
مثال :اتصال به بانک ملت (درخواست توکن و انتقال کاربر به درگاه بانک) توجه : مقدار متد price به ریال وارد شده است و معادل یکصد تومان می باشد
یک روت از نوع GET با آدرس /bank/request ایجاد نمایید و کد های زیر را در آن قرار دهید .
try {
$gateway = \Gateway::make('mellat');
$gateway->setCallback(url('/bank/response')); // You can also change the callback
$gateway->price(1000)
// setFactorNumber("13131313") // optional - just for vandar
->ready();
$refId = $gateway->refId(); // شماره ارجاع بانک
$transID = $gateway->transactionId(); // شماره تراکنش
// در اینجا
// شماره تراکنش بانک را با توجه به نوع ساختار دیتابیس تان
// در جداول مورد نیاز و بسته به نیاز سیستم تان
// ذخیره کنید .
return $gateway->redirect();
} catch (\Exception $e) {
echo $e->getMessage();
}و سپس روت با مسیر /bank/response و از نوع post ایجاد نمایید و کد های زیر را در آن قرار دهید :
try {
$gateway = \Gateway::verify();
$trackingCode = $gateway->trackingCode();
$refId = $gateway->refId();
$cardNumber = $gateway->cardNumber();
// تراکنش با موفقیت سمت بانک تایید گردید
// در این مرحله عملیات خرید کاربر را تکمیل میکنیم
} catch (\Mozakar\Gateway\Exceptions\RetryException $e) {
// تراکنش قبلا سمت بانک تاییده شده است و
// کاربر احتمالا صفحه را مجددا رفرش کرده است
// لذا تنها فاکتور خرید قبل را مجدد به کاربر نمایش میدهیم
echo $e->getMessage() . "<br>";
} catch (\Exception $e) {
// نمایش خطای بانک
echo $e->getMessage();
}درخواست تسویه حساب از وندار (Vandar)
try {
$track_id = Str::random(32);
$payment_number = rand(1000000000, 9999999999);
$gateway = \Gateway::vandar();
//ibanRequest($amount, $iban, $track_id, $payment_number, $is_instant = true)
$response = $gateway->ibanRequest($amount, $sheba_number, $track_id, $payment_number, true);
if($response){
$response = ['success' => true, 'tx' => $track_id, 'data' => $response];
return $response;
}
}catch (\Exception $e) {
// نمایش خطای بانک
echo $e->getMessage();
}نمایش موجودی و لیست تراکنش ها در وندار (Vandar)
try {
$gateway = \Gateway::vandar();
//نمایش موجودی
$balance = $gateway->balance();
//نمایش تراکنش ها
$transactions = $gateway->transactions();
}catch (\Exception $e) {
// نمایش خطای بانک
echo $e->getMessage();
}