پکیج PoolPort

PoolPort چیست؟

پکیج PoolPort یک پکیج Composer برای زبان PHP است و در تمام پروژه های PHP قابل استفاده است. این پکیج برای برقراری با درگاه های بانک های مختلف است. با استفاده از این پکیج میتوانید به تمام درگاه هایی که در این پکیج پشتیبانی میشوند با یک API یکسان دسترسی داشته باشید.

نسخه 3

این نسخه تغییرات زیادی نسبت به نسخه‌های پیشین داشته و استفاده از این نسخه بسیار راحت است.

هر خطایی که در پکیج مشاهده کردید لطفا در صفحه Issues ثبت کنید.

همچنین میتوانید در صفحه Gitter در مورد این پکیج صحبت کنید.

لیست درگاه‌ها

  • بانک ملت P_MELLAT
  • بانک ملی با عنوان سداد P_SADAD
  • بانک صادرات P_SADERAT
  • بانک پارسیان P_PARSIAN
  • بانک پاسارگاد - تست نشده P_PASARGAD
  • درگاه زرین پال P_ZARINPAL
  • درگاه جهان‌پی P_JAHANPAY
  • درگاه پی‌لاین P_PAYLINE
  • درگاه ایران کیش P_IRANKISH
  • درگاه شبیه سازی کننده P_SIMULATOR - شبیه ساز درگاه پرداخت
  • بانک سامان P_SAMAN
  • درگاه پی دات آی آر P_PAY
  • درگاه جیبیت P_JIBIT

راه اندازی سریع

در این بخش می‌توانید بسیار سریع پروژه خود را به درگاه متصل کنید.

نصب

دستور زیر را در ترمینال اجرا کنید تا PoolPort نسخه بتا نصب شود.

composer require poolport/poolport:~v3

تنظیمات پکیج

فایلی با نام poolport.php را در کنار پوشه vendor ایجاد کرده و درون آن کدهای موجود در این صفحه را قرار دهید.

تنظیمات واضح هستند. به هر درگاه‌یی که میخواهید متصل شوید، ابتدا تنظیمات آن را در این فایل پر کنید.

نکته: پس از اولین اجرای درست پکیج، حتما مقدار create در database را برابر false قرار دهید.

نوشتن کدها

خب کدهای زیر را در فایل منتقل کننده به درگاه قرار دهید.

<?php
use PoolPort\PoolPort;

$poolPort = new PoolPort(PoolPort::P_MELLAT);
try {
    $refId = $poolPort->set(1000)->ready()->refId();

    // Your code here

    $poolPort->redirect();
} catch (Exception $e) {
    echo $e->getMessage();
}

  • به جای P_MELLAT میتوانید درگاه‌های دیگر را بنویسید.

  • در متد set می‌توانید هزینه را به ریال وارد کنید.

کدهای زیر را نیز در فایل callback بنویسید.

<?php
use PoolPort\PoolPort;

try {
    $poolPort = new PoolPort;
    $trackingCode = $poolPort->verify()->trackingCode();
    $refId = $poolPort->refId();
    $cardNumber = $poolPort->cardNumber();

    // Your code here

} catch (Exception $e) {
    echo $e->getMessage();
}

تبریک میگم. اگر تنظیمات را به درستی وارد کرده باشید و درگاه شما نیز درست باشد، با موفقیت به درگاه متصل شدید.

اطلاعات بیشتر در مورد API را می‌توانید در اینجا مشاهده کنید.

توسعه دهندگان

PoolPort یک پکیج متن باز است و ما از همکاری شما در توسعه این پکیج به شدت استقبال میکنیم. شما می‌توانید از یکی از راه‌های زیر به توسعه بیشتر این پکیج کمک کنید:

  • نصب PoolPort و گزارش خطاها و پیشنهادات
  • بهبود مستندات پکیج
  • همکاری در نوشتن کدهای اصلی پکیج
  • پورت کردن PoolPort به سیستم‌های دیگر نظیر وردپرس

لیست توسعه دهندگان اصلی پکیج