rahmatwaisi / pol-gateway
PoL is a laravel package to easily use polcard.ir payment services in your applications
Requires
- php: ^7.2.5|^8.0
- guzzlehttp/guzzle: ^7
This package is auto-updated.
Last update: 2024-09-15 16:41:41 UTC
README
پکیج اتصال به درگاه پرداخت پل کارت 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);
در صورت تمایل جهت همکاری در توسعه شامل:
- توسعه مستندات پکیج.
- گزارش باگ و خطا.
- افزودن سرویس های دیگر
- ارتقاء کدها
- نوشتن تست
درصورت بروز هر گونه باگ ما را آگاه سازید .
ارتباط با ما
لایسنس
پکیج اتصال به درگاه پل کارت بصورت متن باز و تحت لایسنس MIT license قرار دارد.