# افزونه درگاه سایاپی برای ووکامرس

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

## نصب

1. بستهٔ کامل `sayapay-woocommerce-0.3.0.zip` را از صفحهٔ توسعه‌دهندگان بگیرید.
2. در «افزونه‌ها ← افزودن» وردپرس ZIP را بارگذاری کنید؛ پوشهٔ lib هم لازم است.
3. در «ووکامرس ← پیکربندی ← پرداخت‌ها»، سایاپی را باز کنید.
4. نشانی API را `https://saya-pay.com` و کلید `sp_test_...` ساخته‌شده در پنل را وارد کنید.
5. واحد فروشگاه باید IRR یا IRT باشد؛ مبلغ تومان به‌صورت امن در ۱۰ ضرب می‌شود.

## مرز نسخه فعلی

- این نسخه به API **سندباکس** فعلی وصل می‌شود و هیچ پول واقعی جابه‌جا نمی‌کند.
- افزونه هنگام بازگشت، شناسه پرداخت، سفارش، ارز و مبلغ را با سفارش ووکامرس تطبیق
  می‌دهد. وضعیت `pending` یا نتیجه نامعلوم را شکست قطعی نمی‌داند و سفارش را
  برای بررسی در وضعیت انتظار نگه می‌دارد. از نسخهٔ ۰.۲.۰، Action Scheduler ووکامرس
  تا ۱۲ بار با فاصلهٔ پنج دقیقه وضعیت سفارش معلق را از API سایاپی استعلام می‌کند.
  اگر پاسخ همچنان نامشخص باشد، سفارش پرداخت‌شده علامت نمی‌خورد و بررسی دستی لازم است.
  برای اجرای به‌موقع صف، WP-Cron فروشگاه باید فعال باشد یا cron واقعی سرور آن را اجرا کند.
- برای تولید، علاوه بر قرارداد و کلید PSP، وب‌هوک خروجی واقعی و تأیید امضاشده
  باید فعال شود تا سفارش بدون وابستگی به بازگشت مرورگر نیز قطعی شود.
- تا قبل از اعلام رسمی حالت تولید سایاپی، افزونه را فقط روی فروشگاه آزمایشی فعال کنید.
- پس از غیرفعال‌کردن افزونه، کارهای زمان‌بندی‌شدهٔ مخصوص سایاپی حذف می‌شوند.
- نسخهٔ ۰.۳.۰ مسیر بازگشت و پیگیری را با قفل مشترک سفارش سری می‌کند. قفلِ باقی‌مانده
  پس از قطع پردازش باید با بررسی مدیر رفع شود؛ خودکار دزدیده نمی‌شود.
- Checkout Blocks، تمدید خودکار و استرداد بومی ووکامرس پشتیبانی نمی‌شوند.
- آزمون نصب و گردش‌کار کامل روی یک WordPress/WooCommerce واقعی هنوز انجام نشده است؛
  تأیید نحوی یا تست API سایاپی جای آن را نمی‌گیرد.

## الزامات

- WordPress 6.5 یا جدیدتر
- WooCommerce 8.5 یا جدیدتر
- PHP 8.1 یا جدیدتر با HTTPS معتبر