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

irandargah-gravityforms.md

ایران‌درگاه برای گرویتی فرم

افزودن درگاه پرداخت ایران‌درگاه (IPG v2) به گرویتی فرم از طریق Payment Add-On Framework.

✨ امکانات

• پرداخت با تأیید قطعی سمت سرور (/v2/verifications) و مقایسهٔ مبلغ — بدون direct_verify.
• مدیریت بازگشت با callback() و هدایت با post_callback()؛ نشانه‌گذاری ورودی (Entry) به‌عنوان Paid.
• محیط Sandbox/Production، امضای HMAC، تبدیل خودکار واحد پول، توکن ضدِ دستکاری (entry meta).

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

1. پوشهٔ gravityforms-irandargah/ را در wp-content/plugins/ کپی و افزونه را فعال کنید (نیازمند Gravity Forms).
2. Forms › Settings › IranDargah: توکن API، محیط و واحد مبلغ را تنظیم کنید.
3. برای هر فرم، یک Feed از نوع IranDargah بسازید (Forms › [فرم] › Settings › IranDargah).
4. در پنل ایران‌درگاه، دامنهٔ سایت را به‌عنوان دامنهٔ مجاز ترمینال ثبت کنید. ⚠️ الزامی.

آدرس بازگشت: https://YOUR_SITE/?callback=irandargah (خودکار).

🧪 تست

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

مجوز

GPL-2.0-or-later