README

连接到 Pol 卡支付网关的包 polcard.ir

要连接到 Pol 卡在线支付网关并使用其 API，您可以使用此包。

注意： 此包适用于 Laravel 6 及以上版本。

安装

使用 composer 安装此包，请按照以下步骤操作

第一步

composer require rahmatwaisi/pol-gateway

第二步 - 转移所需文件

php artisan vendor:publish
# now choose: PoLServiceProvider

第三步

在此步骤中，您需要完成与网关相关的设置以及添加接受密钥，这需要编辑 config/pol.php 文件。

    
    /**
     * کلید پذیرندگی
     * Acceptance Key
     */

    'key' => 'INSERT_YOUR_KEY_HERE', 

第四步

您需要根据需要修改 app\Http\Controllers\PaymentCallbackController::class 控制器中的 callback 方法。一些解决方案以 TODO 的形式提供。

最终步骤 - 添加接收支付信息的路由

应注意，此路由不应包含任何中间件。

默认情况下，payments/callback/ 路由已作为 callback_route 添加到 Pol 卡配置文件 config/pol.php 中，您可以根据需要更改它。

\Illuminate\Support\Facades\Route::any(
    // TODO change this path if you want
    //   so if you changed this path, open config/pol.php and edit  callback_route key.
    '/payments/callback'
    , [
        Http\Controllers\PaymentCallbackController::class
        , 'callback'
    ]
);

使用方法

// ابتدا فاساد پکیج را ایمپورت کنید
use RahmatWaisi\PoL\Facade\PoL;


/*
 | در کنترلر یا متد مورد نظر کدهای زیر را استفاده کنید
 */
 
$price = 6480000; // 648 هزار تومان
$paymentId = 'asdf1234'; // تا حداکثر 30 کاراکتر

// درخواست توکن پرداخت
$token  = PoL::getToken($price, $paymentId);

// برای هدایت به صفحه پرداخت
PoL::pay( $token,  $paymentId);

// برای بررسی صحت تراکنش
PoL::verifyPayment( $token,  $price);

// برای تائید پرداخت موفق و دریافت شماره مرجع و شماره پیگیری
PoL::confirmPayment( $token, $price);

// برای اصلاحیه پرداخت ناموفق و درخواست لغو تراکنش و برگشت مبلغ به حساب دارنده کارت
PoL::reversePayment( $token);

如果您愿意参与开发，包括

1. 编写包文档。
2. 报告错误和问题。
3. 添加其他服务。
4. 升级代码。
5. 编写测试。

如果有任何 错误，请通知我们。

联系我们

• Telegram
• 电子邮件

许可证

此 Pol 卡网关连接包以开源形式发布，并受 MIT 许可证 的约束。