=== درگاه پرداخت ایران‌درگاه برای ووکامرس ===
Contributors: irandargah
Tags: woocommerce, payment gateway, iran, irandargah, درگاه پرداخت, ایران درگاه
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Requires Plugins: woocommerce
WC requires at least: 7.1
WC tested up to: 10.8
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

اتصال فروشگاه ووکامرس به درگاه پرداخت اینترنتی ایران‌درگاه (IPG نسخهٔ ۲) با تأیید امن سمت سرور، استرداد وجه، بلوک‌های چک‌اوت و سازگاری با HPOS.

== Description ==

این افزونه فروشگاه ووکامرس شما را به درگاه پرداخت **ایران‌درگاه** متصل می‌کند و تمام امکانات مهم API نسخهٔ ۲ را پیاده‌سازی کرده است:

* **پرداخت امن با تأیید سمت سرور** — پس از بازگشت کاربر از درگاه، تراکنش با فراخوانی `/v2/verifications` و مقایسهٔ مبلغ به‌صورت قطعی تأیید می‌شود (بدون اتکا به پارامترهای بازگشتی).
* **هدایت مطمئن به درگاه** — هدایت از صفحه‌ای روی دامنهٔ فروشگاه انجام می‌شود تا هدر Referer به‌درستی برای درگاه ارسال شود.
* **استرداد وجه** — استرداد کامل یا جزئی مستقیماً از پنل مدیریت ووکامرس.
* **بلوک‌های چک‌اوت (WooCommerce Blocks)** — پشتیبانی کامل از صفحهٔ تسویه‌حساب بلوکی و نیز چک‌اوت کلاسیک (شورت‌کد).
* **سازگاری با HPOS** — انبارش سفارش‌های پرسرعت ووکامرس.
* **محیط آزمایشی (Sandbox)** — تست کامل با توکن و کارت‌های تستی.
* **امضای درخواست (HMAC)** — برای ترمینال‌هایی که `require_signature` دارند.
* **وب‌هوک** — لایهٔ اطمینان سرور-به-سرور برای نهایی‌سازی خودکار سفارش حتی در صورت عدم بازگشت کاربر.
* **تبدیل خودکار واحد پول** — پشتیبانی از ریال، تومان و کدهای رایج فروشگاه‌های ایرانی.
* **گزارش‌گیری (Log)** و پیام‌های خطای فارسی.

== Installation ==

1. پوشهٔ افزونه را در مسیر `wp-content/plugins/` کپی کنید (یا فایل ZIP را از مسیر «افزونه‌ها › افزودن» بارگذاری کنید).
2. افزونه را فعال کنید.
3. به مسیر **ووکامرس › تنظیمات › پرداخت‌ها › ایران‌درگاه** بروید.
4. درگاه را فعال کرده و **توکن API** خود را وارد کنید.
5. در پنل ایران‌درگاه، **دامنهٔ فروشگاه** خود را به‌عنوان دامنهٔ مجاز ترمینال ثبت کنید (الزامی).

== Frequently Asked Questions ==

= مبلغ به چه واحدی به درگاه ارسال می‌شود؟ =
API ایران‌درگاه مبلغ را به «ریال» می‌گیرد. افزونه واحد پول فروشگاه را به‌صورت خودکار تشخیص و تبدیل می‌کند. در صورت استفاده از واحد پول غیراستاندارد، گزینهٔ «واحد مبلغ ارسالی» را به‌صورت دستی تنظیم کنید.

= حداقل مبلغ پرداخت چقدر است؟ =
۱۰٬۰۰۰ تومان (۱۰۰٬۰۰۰ ریال).

= چرا هنگام هدایت به درگاه خطای دامنه می‌گیرم؟ =
دامنهٔ فروشگاه باید دقیقاً مطابق دامنهٔ ثبت‌شدهٔ ترمینال در پنل ایران‌درگاه باشد.

== Changelog ==

= 1.0.0 =
* انتشار اولیه: پرداخت، تأیید سمت سرور، استرداد، بلوک‌های چک‌اوت، HPOS، Sandbox، امضای درخواست و وب‌هوک.
