=== NexPal Payment Gateway for WooCommerce ===
Contributors: nexpal
Tags: nexpal, woocommerce, payment gateway, درگاه پرداخت, نکس پال
Requires at least: 6.2
Requires PHP: 7.4
Stable tag: 1.0.8
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

درگاه پرداخت اختصاصی نکس پال برای WooCommerce.

== Description ==
نکس پال — نسل جدید زیرساخت پرداخت.

نکس پال، پرداخت آنلاین و زیرساخت مالی را برای فروشگاه‌ها، پلتفرم‌ها و تیم‌های محصول یکپارچه می‌کند.

امکانات نسخه 1.0.6:
* اتصال مستقیم به API v1 نکس پال
* Create / Callback / Transaction / Verify
* بازیابی امن وضعیت پس از Verify تکراری یا Callback مجدد
* Sandbox رسمی نکس پال
* Reverse کامل تراکنش از مسیر Refund ووکامرس، مطابق محدودیت سرویس نکس پال
* پشتیبانی از Checkout کلاسیک و Checkout Blocks
* سازگاری با HPOS
* پشتیبانی از ریال، تومان، هزار ریال و هزار تومان با تبدیل مبلغ API به ریال
* ذخیره شماره مرجع، کارت ماسک‌شده و اطلاعات تراکنش روی سفارش
* idempotency مستقل برای هر تلاش پرداخت
* قفل اتمیک دیتابیسی سطح سفارش با جدول اختصاصی برای جلوگیری از Race Condition در Create، Callback/Verify، Finalization و Reverse
* جلوگیری از downgrade شدن وضعیت موفق توسط پاسخ دیررس درخواست همزمان
* محافظت از Reverse در برابر اجرای همزمان و retry مبهم پس از قطع ارتباط
* Callback state امضاشده، snapshot محیط و payload، و جلوگیری از Retry ناامن Sandbox
* Finalization fence برای جلوگیری از اجرای دوباره payment_complete پس از Crash
* جلوگیری از استفاده یک Reference Number برای چند سفارش
* مبلغ پرداخت فقط از total خود سفارش WooCommerce محاسبه می‌شود و قابل override شدن با filter نیست
* API Key ذخیره‌شده در HTML تنظیمات نمایش داده نمی‌شود
* لاگ اختیاری با حذف API Key، token و شناسه‌های مالی

== Installation ==
1. فایل ZIP افزونه را از بخش Plugins > Add New > Upload Plugin نصب کنید.
2. WooCommerce > Settings > Payments > NexPal را باز کنید.
3. API Key را وارد کنید و در صورت نیاز Terminal Number را تنظیم کنید.
4. برای تست، Sandbox را فعال کنید.

== Notes ==
* مبلغ API نکس پال همیشه به ریال ارسال می‌شود.
* Callback به‌تنهایی مبنای موفقیت سفارش نیست و افزونه نتیجه را سمت سرور Verify/Transaction می‌کند.
* Reverse نکس پال فقط برگشت کامل تراکنش است و ممکن است با توجه به وضعیت و زمان تراکنش توسط API رد شود.

== Changelog ==
= 1.0.6 =
* انتقال mutex سفارش از wp_options به جدول قفل اختصاصی با acquire/takeover/release اتمیک.
* اضافه شدن HMAC state به Callbackهای جدید و حفظ سازگاری با پرداخت‌های در حال انجام نسخه 1.0.5.
* snapshot محیط Sandbox/Live، Terminal و fingerprint کلید API برای هر attempt.
* hash ثابت payload برای Retry و مسدود کردن Retry در صورت تغییر داده‌های attempt.
* جلوگیری از Create موازی و Retry مبهم در Sandbox با create_inflight/create_unknown.
* اضافه شدن Finalization fence و وضعیت unknown برای Crash بین Verify و payment_complete.
* جلوگیری از ثبت Reference Number تکراری روی سفارش دیگر.
* عدم اعتماد و ذخیره referenceNumber مرورگر قبل از Verify سمت سرور.
* سخت‌گیری بیشتر Reverse در خطاهای مبهم 5xx/429/code 33 و تطبیق invoice/amount.
* مخفی کردن API Key ذخیره‌شده از HTML تنظیمات و حفظ کلید قبلی هنگام ذخیره فیلد خالی.

= 1.0.5 =
* اضافه شدن atomic order lock برای Create، Callback/Verify، payment_complete و Reverse.
* جلوگیری از overwrite/downgrade وضعیت جدید توسط پاسخ دیررس درخواست همزمان.
* سخت‌گیری بیشتر روی اعتبارسنجی Callback و جلوگیری از Reverse تکراری در وضعیت مبهم.
* عدم ثبت raw body پاسخ نامعتبر در لاگ و حذف ذخیره hashed card به صورت پیش‌فرض.

= 1.0.4 =
* استفاده واقعی از favicon نکس پال به عنوان آیکون Gateway در صفحه مدیریت ارائه‌دهندگان پرداخت ووکامرس.
* حفظ لوگوی کامل نکس پال در Checkout فروشگاه.

= 1.0.3 =
* استفاده از favicon اختصاصی نکس پال در لیست ارائه‌دهندگان پرداخت ووکامرس.
* لوگوی کامل در صفحه تنظیمات و Checkout بدون تغییر باقی می‌ماند.

= 1.0.2 =
* بزرگ‌تر شدن لوگوی نکس پال در لیست ارائه‌دهندگان پرداخت ووکامرس (بخش مدیریت).

= 1.0.1 =
* بزرگ‌تر شدن لوگو در صفحه تنظیمات ووکامرس و نمایش در لیست درگاه‌ها.

= 1.0.0 =
* Initial NexPal WooCommerce payment gateway release.
