راهنمای پلاگین «ویرچومارت» ایران درگاه

irandargah-joomla-virtuemart.md

افزونهٔ ایران‌درگاه برای ویرچومارت (جوملا)

افزونهٔ رسمی پرداخت ویرچومارت (روی جوملا) برای ایران‌درگاه (IPG v2).

این افزونه برای فروشگاه‌ساز ویرچومارت است (پرکاربردترین فروشگاه‌ساز جوملا). برای هیکاشاپ/J2Store جداگانه ارائه خواهد شد.

✨ امکانات

• پرداخت با تأیید قطعی سمت سرور (/v2/verifications) و مقایسهٔ مبلغ — بدون direct_verify.
• هدایت Referer-safe: صفحهٔ standalone با Referrer-Policy: origin هنگام تأیید سفارش.
• محیط Sandbox/Production، امضای درخواست (HMAC)، تبدیل خودکار واحد پول.
• جدول داخلی افزونه برای پیگیری تراکنش + توکن ضدِ دستکاری.
• مدیریت کد -21 (تأییدشده) و خطای شبکه (وضعیت «در انتظار بررسی»).

🧱 ساختار

plg_vmpayment_irandargah/
├── irandargah.php        کلاس plgVmPaymentIrandargah (vmPSPlugin)
├── irandargah.xml        مانیفست افزونهٔ Joomla (group=vmpayment)
├── lib/irandargah_api.php کلاینت API نسخهٔ ۲
└── language/             fa-IR + en-GB (ini + sys.ini)

⚙️ نصب

1. پوشهٔ plg_vmpayment_irandargah/ را به‌صورت ZIP درآورید و از Extensions › Install بارگذاری کنید (یا محتوای آن را در plugins/vmpayment/irandargah/ کپی کنید).
2. از Extensions › Plugins، پلاگین VM Payment - IranDargah را فعال کنید.
3. در VirtueMart › Payment Methods، یک روش جدید با افزونهٔ IranDargah بسازید و توکن API، محیط و واحد مبلغ را تنظیم کنید.
4. در پنل ایران‌درگاه، دامنهٔ فروشگاه را به‌عنوان دامنهٔ مجاز ترمینال ثبت کنید. ⚠️ الزامی.

🧪 تست (Sandbox)

محیط را «آزمایشی» بگذارید و با کارت تستی 6037997123456789 (CVV2 123، انقضا 05/12) پرداخت کنید.

مجوز

GPL-2.0-or-later