راهنمای پلاگین «هیکاشاپ» ایران درگاه

irandargah-hikashop.md

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

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

✨ امکانات

• پرداخت با تأیید قطعی سمت سرور (/v2/verifications) و مقایسهٔ مبلغ — بدون direct_verify.
• onAfterOrderConfirm (ایجاد تراکنش + صفحهٔ Referer-safe) → درگاه → onPaymentNotification (تأیید + modifyOrder).
• محیط Sandbox/Production، امضای HMAC، واحد پول خودکار، توکن ضدِ دستکاری (روی سفارش).

⚙️ نصب و راه‌اندازی

1. پوشهٔ plg_hikashoppayment_irandargah/ را ZIP کرده و از Extensions › Install نصب کنید.
2. از Extensions › Plugins، پلاگین plg_hikashoppayment_irandargah را فعال کنید.
3. در HikaShop › System › Payment methods، روش جدید irandargah بسازید و توکن API، محیط، واحد مبلغ و وضعیت‌های سفارش را تنظیم کنید.
4. در پنل ایران‌درگاه، دامنهٔ فروشگاه را به‌عنوان دامنهٔ مجاز ترمینال ثبت کنید. ⚠️ الزامی.

🧪 تست

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

مجوز

GPL-2.0-or-later