=== TabaPay Gateway ===
Contributors: TabaPay
Tags: woocommerce, payment gateway, tabapay, shaparak, تاباپی, درگاه پرداخت, درگاه, شاپرک, payment
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.4.0
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==
این افزونه به شما امکان می‌دهد درگاه پرداخت **تاباپی** را به‌سادگی به فروشگاه ووکامرس خود متصل کنید و تجربه پرداختی سریع، امن و پایدار برای مشتریان خود فراهم نمایید.

== Features ==
– پشتیبانی کامل از ووکامرس و یکپارچگی کامل با سیستم پرداخت WooCommerce.
– تراکنش‌های امن از طریق درگاه رسمی تاباپی (پرداخت‌یار شاپرک).
– امکان تنظیم عنوان و توضیحات درگاه در صفحه تسویه‌حساب.
– پشتیبانی از چند واحد پولی: ریال (IRR)، تومان (IRT) و حالت‌های متداول دیگر (IRHT, IRHR) با تبدیل خودکار مبلغ.
– ثبت جزئیات تراکنش شامل کد پیگیری، شماره کارت، IP و تاریخ تراکنش.
– حالت سندباکس برای تست پرداخت‌ها بدون انجام تراکنش واقعی (قابل فعال‌سازی از تنظیمات درگاه).
– صدور و ارسال خودکار داده‌های فاکتور مالیاتی (از جمله `invoiceProductId`، کد/شناسه ملی، شماره اقتصادی، نوع خریدار و آدرس) به API تاباپی.
- ارسال پیامک تأیید تراکنش به مشتری (در صورت فعال‌سازی، هزینهٔ پیامک از حساب دیجیتال خدمات پذیرنده در تاباپی کسر شده و در صورت نبود موجودی یا خالی بودن شماره موبایل مشتری، پیامک ارسال نخواهد شد).

== Installation ==
1. پوشه افزونه را در مسیر `/wp-content/plugins/` آپلود کنید.
2. افزونه را از منوی «افزونه‌ها» در پیشخوان وردپرس فعال کنید.
3. به مسیر WooCommerce > Settings > Payments رفته، درگاه «Tabapay» را فعال کرده و مرچنت‌کد (Merchant Key) خود را تنظیم کنید.

== Frequently Asked Questions ==
= مرچنت‌کد (Merchant Key) را از کجا بگیرم؟ =
برای دریافت مرچنت‌کد (Merchant Key) باید در وب‌سایت [Tabapay](https://tabapay.ir) ثبت‌نام کرده و طبق راهنما، درگاه خود را فعال کنید.

= آیا افزونه حالت تست (Sandbox) دارد؟ =
بله، در تنظیمات درگاه تاباپی در ووکامرس می‌توانید حالت سندباکس را فعال کنید تا تمامی تراکنش‌ها در محیط آزمایشی انجام شود و هیچ پرداخت واقعی صورت نگیرد.

= آیا این افزونه از چند واحد پولی پشتیبانی می‌کند؟ =
بله، این افزونه از واحدهای پولی IRR، IRT، IRHT و IRHR پشتیبانی می‌کند و تبدیل مبلغ به‌صورت خودکار انجام می‌شود.

== Changelog ==
= 1.4.0 =
* افزودن حالت سندباکس با انتخاب داینامیک آدرس پایه API.
* اضافه شدن قابلیت ارسال پیامک تراکنش موفق به خریدار
* افزودن پشتیبانی از فاکتور مالیاتی خودکار شامل:
  * صفحه مدیریت برای نگاشت محصولات ووکامرس به `invoiceProductId`.
  * نگاشت داینامیک فیلدهای به فیلدهای مالیاتی (nationalCode, mobile, name, address, economicCode, buyerType).
  * ارسال `invoiceProductId` به‌صورت آبجکت JSON هنگام وجود چند شناسه کالا/خدمت مختلف در سبد خرید.
* بهبود ساختار کد و مستندسازی.

= 1.3.2 =
* انتشار اولیه افزونه با پشتیبانی از ایجاد و تأیید تراکنش.

== Upgrade Notice ==
= 1.4.0 =
در این نسخه حالت سندباکس و فاکتور مالیاتی خودکار اضافه شده است. لطفاً پس از بروزرسانی، تنظیمات جدید را در مسیر WooCommerce → Settings → Payments → Tabapay بررسی و پیکربندی کنید.

== Screenshots ==
1. صفحه تنظیمات مدیریتی درگاه تاباپی در پنل ووکامرس.
2. صفحه نگاشت محصولات با شناسه کالا ویا خدمات

== License ==
این افزونه تحت مجوز GNU General Public License نسخه ۲ یا بالاتر منتشر شده است. برای جزئیات بیشتر، به آدرس License URI مراجعه کنید.

== External services ==
این افزونه برای پردازش تراکنش‌ها از طریق شاپرک به API تاباپی متصل می‌شود.

هنگامی که مشتری در صفحه تسویه‌حساب پرداخت را آغاز می‌کند، داده‌های زیر به API تاباپی ارسال می‌شود:
– مبلغ سفارش
– شناسه سفارش (Order ID)
– آدرس بازگشت (Callback URL)

این درخواست‌ها برای ایجاد و تأیید امن تراکنش‌ها در سرورهای تاباپی انجام می‌شود.

تمام ارتباطات با API تاباپی از طریق HTTPS و مطابق با پروتکل‌های امنیتی انجام می‌گیرد.

Service Provider: [Tabapay.ir](https://tabapay.ir)  
- [Terms and Conditions](https://tabapay.ir/terms-and-conditions)  
- [Privacy Policy](https://tabapay.ir/privacy-policy)
