mozakar/gateway

A Laravel package for connecting to all Iraninan payment gateways, base package mozakar/gateway

2.3.0 2025-10-11 14:51 UTC

Requires

• nesbot/carbon: *

MIT

• Farhad Sharifi

• payment
• pay
• gateway
• laravel
• Bank
• port
• Payline
• iran
• shaparak
• zarinpal
• saman
• pardakht
• dargah
• Meli
• mellat
• pasargad
• parsian
• sadad
• jahanpay
• iranian-banks
• persian-banks
• poolport
• ipay
• asan-pardakht
• pay-ir
• PayPing
• vandar
• zibal
• nikan
• digipay
• apsan
• sadadbnpl
• mili-gold

README

بدلیل عدم پشتیبانی تیم Larabook این پکیج بصورت شخصی توسعه میابد

پکیج اتصال به تمامی IPG ها و بانک های ایرانی.

این پکیج با ورژن های ( ۴ و ۵ و ۶ و۷ و ۸ و ۹ و ۱۰) لاراول سازگار می باشد

پشتیبانی تنها از درگاهای زیر می باشد:

1. MELLAT
2. SADAD (MELLI)
3. SAMAN Token Base (جدید)
4. SAMAN
5. PARSIAN
6. PASARGAD(جدید)
7. ZARINPAL (ورژن 4)
8. ASAN PARDAKHT
9. PAY.IR ( برای فراخوانی از 'payir' استفاده نمایید)
10. Irankish (جدید - برای فراخوانی از 'irankish' استفاده نمایید)
11. Nikan (PASARGAD) (جدید)
12. PayPing (جدید)
13. Vandar (جدید)
14. Apsan (جدید)
15. Digipay
16. SADAD BNPL (MELLI BNPL)
17. Zibal (جدید)
18. MiliGold

نصب:

دستورات زیر را جهت نصب دنبال کنید :

مرحله ۱)

نصب به وسیله "composer require"

composer require mozakar/gateway

یا

در فایل composer.json اضافه کنید

"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\GatewayServiceProviderLaravel5

برای لاراول ۶ به بعد :

php artisan vendor:publish 

// then choose : GatewayServiceProviderLaravel6
// then choose : GatewayServiceProviderLaravel7
// then choose : GatewayServiceProviderLaravel8
// then choose : GatewayServiceProviderLaravel9
// then choose : GatewayServiceProviderLaravel10

مرحله ۴) - ایجاد جداول

php artisan migrate

مرحله ۵)

عملیات نصب پایان یافته است حال فایل gateway.php را در مسیر app/ باز نموده و تنظیمات مربوط به درگاه بانکی مورد نظر خود را در آن وارد نمایید .

حال میتوایند برای اتصال به api بانک از یکی از روش های زیر به انتخاب خودتان استفاده نمایید . (Facade , Service container):

1. Gateway::make(new Mellat())
2. Gateway::make('mellat')
3. Gateway::mellat()
4. app('gateway')->make(new Mellat());
5. 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(); // شماره تراکنش

  
   // در اینجا
   //  شماره تراکنش  بانک را با توجه به نوع ساختار دیتابیس تان 
   //  در جداول مورد نیاز و بسته به نیاز سیستم تان
   // ذخیره کنید .

    // برای میلی گلذ (miligold)
    // $gateway->setCurrency("RIAL"); //RIAL, TOMAN, MILI
    // به صورت پیش فرض کارنسی ریال است
    // اگر کارنسی به تومان یا ریال باشد مقدار پرداخت به میلی تبدیل میشود

    //برای دیجی پی
    //نوع تیکت شماره همراه کاربر و شماره سفارش الزامی است.
    // $gateway->setTicketType(11);
    // $gateway->setMobile("09350000000");
    // $gateway->setOrderId(1);
   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();
}

در صورت تمایل جهت همکاری در توسعه :

1. توسعه مستندات پکیج.
2. گزارش باگ و خطا.
3. همکاری در نوشتن ماژول دیگر بانک ها برای این پکیج .

درصورت بروز هر گونه باگ یا خطا . ما را آگاه سازید .

این پکیج از پکیج دیگری بنام poolport مشتق شده است اما برخی از عملیات آن متناسب با فریموورک لارول تغییر کرده است