فهرست مستندات پروژه
شروع سریع
پیشنیازها
- PHP نسخه ۸.۱ یا بالاتر
- اکستنشنها:
ext-curl،ext-json،ext-openssl،ext-soap
نصب
composer require eram/pardakht
پرداخت هیچ وابستگی Composer ندارد. فقط به اکستنشنهای PHP نیاز دارد که در اکثر نصبهای PHP موجود هستند.
مثال سریع
یک جریان پرداخت کامل با زرینپال:
۱. ساخت درگاه
use Eram\Pardakht\Pardakht;
use Eram\Pardakht\Gateway\Zarinpal\ZarinpalConfig;
$pardakht = new Pardakht();
$gateway = $pardakht->create('zarinpal', new ZarinpalConfig(
merchantId: 'کد-مرچنت-شما',
));
۲. شروع پرداخت
use Eram\Pardakht\Money\Amount;
use Eram\Pardakht\Http\PurchaseRequest;
$request = new PurchaseRequest(
amount: Amount::fromToman(50_000), // ۵۰٬۰۰۰ تومان
callbackUrl: 'https://example.com/callback',
orderId: 'ORDER-123',
description: 'اشتراک ویژه',
);
$response = $gateway->purchase($request);
۳. انتقال کاربر به درگاه
// برای درگاههای REST (زرینپال، آیدیپی و ...) — ریدایرکت ساده
header('Location: ' . $response->getUrl());
exit;
// برای درگاههای SOAP (ملت، سامان، پارسیان) — فرم خودکار
echo $response->renderAutoSubmitForm();
۴. مدیریت کالبک
// در هندلر URL بازگشت:
$transaction = $gateway->verify();
echo $transaction->getReferenceId(); // شناسه مرجع درگاه
echo $transaction->getTrackingCode(); // کد رهگیری برای کاربر
echo $transaction->getCardNumber(); // شماره کارت پرداختکننده
echo $transaction->getAmount()->inToman(); // 50000
۵. تسویه (در صورت نیاز)
برخی درگاههای بانکی (ملت، پارسیان) نیاز به مرحله تسویه جداگانه بعد از تایید دارند. اگر این مرحله انجام نشود، پرداخت بعد از ۱۵ تا ۳۰ دقیقه به صورت خودکار برگشت میخورد.
use Eram\Pardakht\Contracts\SupportsSettlement;
if ($gateway instanceof SupportsSettlement) {
$transaction = $gateway->settle($transaction);
}
درگاههای پشتیبانی شده
| Alias | درگاه | پروتکل | نیاز به تسویه |
|---|---|---|---|
mellat | ملت (بهپرداخت) | SOAP | بله |
saman | سامان (سپ) | SOAP | خیر |
parsian | پارسیان (پک) | SOAP | بله |
sadad | سداد (بانک ملی) | REST | خیر |
pasargad | پاسارگاد | REST | خیر |
zarinpal | زرینپال | REST | خیر |
idpay | آیدیپی | REST | خیر |
zibal | زیبال | REST | خیر |
payir | پیآیآر | REST | خیر |
nextpay | نکستپی | REST | خیر |
vandar | وندار | REST | خیر |
sizpay | سیزپی | REST | خیر |
قدمهای بعدی
- مفاهیم اصلی — درک طراحی کتابخانه
- کتاب آشپزی — دستورالعملهای عملی
- راهنمای درگاهها — مستندات هر درگاه
⁅php نسخه 8 1 یا بالا اکستنشن ext curl ext json ext openssl ext soap composer require eram pardakht پرداخت هیچ وابستگی composer نداشت فقط به اکستنشن php نیاز داشت که در اکثر نصب php موجود هستند یک جریان پرداخت کامل با زرینپال زرین پال use eram pardakht pardakht use eram pardakht gateway zarinpal zarinpalconfig pardakht new pardakht gateway pardakht create zarinpal new zarinpalconfig merchantid کد مرچنت شما use eram pardakht money amount use eram pardakht http purchaserequest request new purchaserequest amount amount fromtoman 50 000 50 000 توم callbackurl https example com callback orderid order 123 description اشتراک ویژه response gateway purchase request برای درگاه rest زرینپال زرین پال آیدیپی ایدیپی آی دی پی و ریدایرکت ساد header location response geturl exit برای درگاه soap ملت سام پارس فرم خودکار echo response renderautosubmitform در هندلر url بازگشت transaction gateway verify echo transaction getreferenceid شناسه مرجع درگاه echo transaction gettrackingcode کد رهگیری برای کاربر echo transaction getcardnumber شماره کارت پرداختکن پرداخت کننده echo transaction getamount intoman 50000 رخید درگاه بانکی ملت پارس نیاز به مرحله تسویه جداگانه بعد از تای داشت اگر این مرحله انجا نشد پرداخت بعد از 15 تا 30 دقیقه به صورت خودکار برگشت خورد use eram pardakht contracts supportssettlement if gateway instanceof supportssettlement transaction gateway settle transaction alias درگاه پروتکل نیاز به تسویه mellat ملت بهپرداخت به پرداخت soap بله saman سام سپ soap خیر parsian پارس پک soap بله sadad سداد بانک ملی rest خیر pasargad پاسارگاد rest خیر zarinpal زرینپال زرین پال rest خیر idpay آیدیپی ایدیپی آی دی پی rest خیر zibal زیبال rest خیر payir پیآیآر پیایار پی آی آر rest خیر nextpay نکستپی نکست پی rest خیر vandar وندار rest خیر sizpay سیزپی rest خیر مفاهی اصلی درک طراحی کتابخانه کتاب آشپزی اشپزی دستورالعمل عملی راهنمای درگاه مستند هر درگاه⁆
⁅شروع سریع⁆
⁅پیشنیازهانصبمثال پیش نیازهانصبمثال سریعدرگاه پشتیبانی شدهقد شدهقدم بعدی⁆
⁅1 ساخت درگاه2 شروع پرداخت3 انتقال کاربر به درگاه4 مدیریت کالبک5 تسویه در صورت نیاز⁆