PardakhtPHP۱.۰ · بتا

درگاه‌های مختلف،
یک مسیر پرداخت.

درگاه‌های پرداخت ایران را با یک رابط یکپارچه در PHP به برنامه خود وصل کنید. مبلغ را با واحد مشخص بسازید، کاربر را به درگاه بفرستید و نتیجه پرداخت را تایید کنید.

برنامه شما
Pardakhtpurchase → verify
زرین‌پالملت۱۲ درگاه دیگر
composer require eram/pardakht:^1.0@beta

همراه یک پرداخت

یک سفارش، دو مسیر.

نمونه‌های اجراشده با PHP
سفارش نمونه #1042
درخواست پرداخت#1042
۵۰٬۰۰۰تومان
درگاهزرین‌پال
مبلغ ارسالی به درگاه۵۰۰٬۰۰۰ ریال
شناسه مرجع دریافت شدDEMO-AUTHORITY
purchase()سفارش و پاسخ درگاه، هر دو نمونه‌اند
زرین‌پال / درخواست

یک درخواست پرداخت ساخته می‌شود.

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

PHPبخشی از مسیر پرداخت
use Eram\Abzar\Money\Amount;
use Eram\Pardakht\Http\PurchaseRequest;

$response = $gateway->purchase(new PurchaseRequest(
    amount: Amount::fromToman(50_000),
    callbackUrl: 'https://example.com/payment/callback',
    orderId: '1042',
    description: 'Demo order',
));

// Save the reference with your payment attempt.
$response->getReferenceId();
تنظیمات درگاه‌ها چه تفاوتی دارند؟

متدها مشترک‌اند، اما اطلاعات اتصال و فیلدهای callback برای هر درگاه متفاوت است. ابتدا درگاه را تنظیم کنید و بعد مراحل بالا را دنبال کنید. اطلاعات اتصال را در سرور نگه دارید.

use Eram\Pardakht\Pardakht;
use Eram\Pardakht\Gateway\Zarinpal\ZarinpalConfig;
use Eram\Pardakht\Gateway\Mellat\MellatConfig;

$pardakht = new Pardakht();

// Choose a gateway with your own credentials.
$gateway = $pardakht->create('zarinpal',
    new ZarinpalConfig(merchantId: $merchantId)
);

// Or use your Mellat terminal.
$gateway = $pardakht->create('mellat',
    new MellatConfig(
        terminalId: $terminalId,
        username: $username,
        password: $password,
    )
);

این نمونه‌ها با Pardakht 1.0.0-beta.4 و پاسخ شبیه‌سازی‌شده درگاه اجرا شده‌اند. دکمه‌ها خروجی ذخیره‌شده را نشان می‌دهند؛ PHP اجرا نمی‌شود، ارتباطی با بانک برقرار نمی‌شود و پرداختی انجام نمی‌گیرد.

واحد، بخشی از مبلغ است

تومان در برنامه شما،
ریال برای درگاهی که ریال می‌خواهد.

Amount را با واحدی که منظورتان است بسازید. مبلغ به‌صورت عدد صحیح ریال نگه داشته می‌شود و هر رابط، واحد مورد نیاز درگاه را می‌خواند. محاسبات هم مبلغ تازه‌ای برمی‌گردانند.

کار با مبلغ و واحد پول
مبلغ شما۵۰٬۰۰۰ تومانAmount::fromToman(50_000)
همان مبلغ به ریال۵۰۰٬۰۰۰ ریال$amount->inRials()

درگاه‌های پشتیبانی‌شده

درگاه خودتان را انتخاب کنید.

۱۴ رابط در این نسخه

این فهرست، رابط‌های موجود در همین نسخه کتابخانه است. دریافت درگاه، اطلاعات اتصال و الزامات هر سرویس همچنان لازم است. برای جیبیت و پی‌استار، چون راهنمای جداگانه‌ای در این نسخه وجود ندارد، لینک کد منبع را گذاشته‌ایم.

در کنار منطق برنامه شما

ارتباط با درگاه، یکپارچه.
منطق سفارش، در اختیار شما.

از PHP ساده یا فریم‌ورک خودتان استفاده کنید. پرداخت، ارتباط با درگاه را مدیریت می‌کند؛ سفارش و چرخه آن در اختیار برنامه شماست.

با یک درگاه شروع کنید.

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

محیط اجرا
PHP 8.1+
افزونه‌های PHP
curl · json · openssl · soap
وابستگی Composer
eram/abzar
مجوز
MIT