پلاگین ووکامرس
افزونهی «واریزیار برای ووکامرس» روش پرداخت کارتبهکارت (تأیید خودکار) را به صفحهی تسویه اضافه میکند.
نصب
- فایل zip افزونه را از پنل واریزیار یا سایت دانلود و در وردپرس نصب و فعال کنید. (PHP ۷.۴ به بالا، ووکامرس ۷ به بالا؛ با HPOS سازگار است.)
- ووکامرس → تنظیمات → پرداختها → واریزیار:
- حالت: اول آزمایشی؛ بعد از تست، واقعی.
- کلید API آزمایشی و واقعی از پنل واریزیار (پروژه → کلید API).
- secret وبهوک: در پنل واریزیار، پروژه → وبهوک، آدرسی که در تنظیمات افزونه نشان داده میشود (
/wc-api/varizyar_webhook) را ثبت کنید و secret آن را اینجا بگذارید. - وضعیت سفارش بعد از تأیید: «در حال انجام» یا «تکمیلشده».
- واحد پول فروشگاه باید ریال (IRR) یا تومان (IRT) باشد؛ افزونه تومان را به ریال تبدیل میکند.
چه اتفاقی میافتد
- مشتری روش «کارتبهکارت» را انتخاب میکند → افزونه پرداخت را با شمارهی سفارش میسازد، سبد را خالی میکند و مشتری را به صفحهی پرداخت واریزیار میبرد. سفارش در وضعیت «در انتظار پرداخت» با یادداشت شناسهی پرداخت و مبلغ نهایی میماند.
- بازگشت مشتری: افزونه verify میکند؛ اگر تأیید شده باشد
payment_completeو صفحهی تشکر؛ اگر هنوز معلق باشد، به صفحهی پرداخت سفارش برمیگردد. - وبهوک: حتی اگر مشتری صفحه را بسته باشد، با رسیدن
payment.confirmed(امضاشده) سفارش تکمیل میشود. منقضی/رد/لغو → «ناموفق». - همهچیز idempotent است: سفارش پرداختشده دوباره تغییر نمیکند.
تست
با حالت آزمایشی یک سفارش بزنید. در پنل واریزیار، پروژهی آزمایشی → تب شبیهساز، واریز را شبیهسازی کنید؛ سفارش باید «در حال انجام» شود و یادداشت «پرداخت تأیید شد (webhook)» بگیرد.