فهرست مستندات پروژه

شروع سریع

Pardakhtv1.0.0-beta.4مشاهده منبعفارسی / انگلیسی

پیش‌نیازها

  • 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خیر

قدم‌های بعدی

جستجو در مستندات

در همه پروژه‌ها جستجو کنید. با بستن این پنجره به راهنما برمی‌گردید.

Tab برای جابه‌جایی · Enter برای باز کردنEsc برای بستن