پکیج اتصال به درگاه پرداخت پل کارت polcard.ir
برای اتصال به درگاه پرداخت اینترنتی پل کارت و استفاده از api های آن می توانید از این پکیج استفاده کنید.
توجه: این پکیج برای لاراول 6 به بعد قابل استفاده است.
نصب
برای نصب پکیج توسط composer
مراحل زیر را به دقت دنبال کنید:
مرحله اول
composer require rahmatwaisi/pol-gateway
مرحله دوم - انتقال فایل های مورد نیاز
php artisan vendor:publish
# now choose: PoLServiceProvider
مرحله سوم
در این مرحله باید تنظیمات مربوط به درگاه و درج کلید پذیرندگی را انجام دهید که برای اینکار باید فایل
config/pol.php
را ویرایش کنید.
/**
* کلید پذیرندگی
* Acceptance Key
*/
'key' => 'INSERT_YOUR_KEY_HERE',
مرحله چهارم
باید متد callback
را در کنترلر app\Http\Controllers\PaymentCallbackController::class
طبق نیاز خود ویرایش کنید.
چند راهکار به صورت TODO
پیشنهاد شده است.
مرحله پایانی - اضافه کردن یک مسیر برای دریافت اطلاعات پرداخت از درگاه
باید توجه داشت که این route نباید دارای هیچ middleware ی باشد.
مسیر payments/callback/
به عنوان callback_route
به صورت پیشفرض در فایل کانفیگ پل کارت config/pol.php
درج شده است
که می توانید آن را تغییر داده و مسیر جدید را به عنوان callback_route
انتخاب کنید.
\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);
در صورت تمایل جهت همکاری در توسعه شامل:
- توسعه مستندات پکیج.
- گزارش باگ و خطا.
- افزودن سرویس های دیگر
- ارتقاء کدها
- نوشتن تست
درصورت بروز هر گونه باگ ما را آگاه سازید .