ماژول رسمی درگاه پرداخت WHMCS برای ایراندرگاه (IPG v2).
- پرداخت فاکتور با تأیید قطعی سمت سرور (
/v2/verifications) و مقایسهٔ مبلغ — بدونdirect_verify. - هدایت Referer-safe: صفحهٔ واسطِ standalone روی دامنهٔ فروشگاه با
Referrer-Policy: origin. - استرداد وجه از پنل مدیریت WHMCS (
irandargah_refund→/v2/refunds+/process). - محیط Sandbox/Production، امضای درخواست (HMAC)، تبدیل خودکار واحد پول.
- جدول اختصاصی
mod_irandargah_transactions(نگاشت فاکتور ↔ authority ↔ مبلغ) با توکن ضدِ دستکاری. - جلوگیری از ثبت دوبارهٔ پرداخت (
checkCbTransID) و اعتبارسنجی فاکتور (checkCbInvoiceID).
modules/gateways/
├── irandargah.php ماژول اصلی (MetaData/config/link/refund)
├── irandargah/
│ ├── api.php کلاینت API نسخهٔ ۲ (cURL، امضا، idempotency)
│ ├── helper.php توابع Capsule (جدول، تبدیل ارز، موبایل)
│ └── redirect.php ایجاد تراکنش + صفحهٔ هدایت Referer-safe
└── callback/
└── irandargah.php بازگشت، تأیید سمت سرور، addInvoicePayment
- محتوای پوشهٔ (modules/) را در ریشهٔ نصب WHMCS کپی کنید (با
modules/موجود ادغام میشود). - از مسیر Configuration › System Settings › Payment Gateways (یا در نسخههای قدیمی Setup › Payments › Payment Gateways)، تب All Payment Gateways، گزینهٔ ایراندرگاه (IranDargah) را فعال کنید.
- توکن API، محیط و واحد مبلغ را تنظیم و ذخیره کنید (جدول تراکنشها بهصورت خودکار ساخته میشود).
- در پنل ایراندرگاه، دامنهٔ WHMCS را بهعنوان دامنهٔ مجاز ترمینال ثبت کنید.
⚠️ الزامی.
محیط را «آزمایشی» بگذارید و با کارت تستی 6037997123456789 (CVV2 123، انقضا 05/12) پرداخت کنید.
- گزارشها: Configuration › System Logs › Gateway Log (نام ماژول
irandargah). - خطای دامنه هنگام هدایت → دامنهٔ ثبتشدهٔ ترمینال را بررسی کنید.
- مبلغ ۱۰ برابر/یکدهم → «واحد مبلغ ارسالی» را دستی روی ریال/تومان تنظیم کنید.
- استرداد ۴۰۳ → قابلیت استرداد روی ترمینال فعال نیست؛ با پشتیبانی ایراندرگاه تماس بگیرید.
GPL-2.0-or-later