mortezapiri/gateway

Laravel包,用于连接所有伊朗支付网关

3.5.2 2021-12-13 09:18 UTC

README

包参考网站: larabook.ir

连接所有伊朗IPG和银行的包。

此包与Laravel的4、5和6版本兼容。

仅支持以下网关

  1. MELLAT
  2. SADAD (MELLI)
  3. SAMAN
  4. PARSIAN
  5. PASARGAD
  6. ZARINPAL
  7. PAYPAL
  8. ASAN PARDAKHT
  9. PAY.IR (使用 'payir' 进行调用)
  10. Irankish ( - 使用 'irankish' 进行调用)

安装:

按照以下步骤进行安装

步骤 1)

composer require larabook/gateway

步骤 2)

تغییرات زیر را در فایل  config/app.php اعمال نمایید:

注意:对于Laravel 6及以后的版本,此步骤不需要执行

'providers' => [
  ...
  Larabookir\Gateway\GatewayServiceProvider::class, // <-- add this line at the end of provider array
],


'aliases' => [
  ...
  'Gateway' => Larabookir\Gateway\Gateway::class, // <-- add this line at the end of aliases array
]

步骤 3) - 转移所需文件

对于Laravel 5

php artisan vendor:publish --provider=Larabookir\Gateway\GatewayServiceProviderLaravel5
对于Laravel 6以后的版本
php artisan vendor:publish 
然后选择此选项:"Larabookir\Gateway\GatewayServiceProviderLaravel6"

步骤 4) - 创建表格

php artisan migrate

步骤 5)

安装完成。现在打开app/目录下的gateway.php文件,并输入您所需银行网关的相关设置。

现在可以使用以下任一方法连接到银行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();

示例:连接到银行MELLAT(请求令牌并将用户转到银行网关)。注意:price方法以里亚尔为单位输入,相当于一百泰铢。

创建一个GET类型的路由,地址为/bank/request,并在其中放置以下代码。

try {

   $gateway = \Gateway::make('mellat');

   $gateway->setCallback(url('/bank/response')); // You can also change the callback
   $gateway->price(1000)
           // setShipmentPrice(10) // optional - just for paypal
           // setProductName("My Product") // optional - just for paypal
           ->ready();

   $refId =  $gateway->refId(); // شماره ارجاع بانک
   $transID = $gateway->transactionId(); // شماره تراکنش

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

   return $gateway->redirect();

} catch (\Exception $e) {

   echo $e->getMessage();
}

然后创建一个POST类型的路由,地址为/bank/response,并在其中放置以下代码。

try { 

   $gateway = \Gateway::verify();
   $trackingCode = $gateway->trackingCode();
   $refId = $gateway->refId();
   $cardNumber = $gateway->cardNumber();

   // تراکنش با موفقیت سمت بانک تایید گردید
   // در این مرحله عملیات خرید کاربر را تکمیل میکنیم

} catch (\Larabookir\Gateway\Exceptions\RetryException $e) {

    // تراکنش قبلا سمت بانک تاییده شده است و
    // کاربر احتمالا صفحه را مجددا رفرش کرده است
    // لذا تنها فاکتور خرید قبل را مجدد به کاربر نمایش میدهیم

    echo $e->getMessage() . "<br>";

} catch (\Exception $e) {

    // نمایش خطای بانک
    echo $e->getMessage();
}

如果您愿意合作开发

  1. 开发包的文档。
  2. 报告错误和问题。
  3. 为该包编写其他银行模块。

如果有任何错误问题,请通知我们。

此包从名为poolport的其他包派生而来,但其中一些操作已根据Laravel框架进行了修改。