پرش به مطلب اصلی

پلاگین ووکامرس

افزونه‌ی «واریزاپ برای ووکامرس» روش پرداخت کارت‌به‌کارت (تأیید خودکار) را به صفحه‌ی تسویه اضافه می‌کند.

نصب

  1. فایل zip افزونه را از پنل واریزاپ یا سایت دانلود و در وردپرس نصب و فعال کنید. (PHP ۷.۴ به بالا، ووکامرس ۷ به بالا؛ با HPOS سازگار است.)
  2. ووکامرس → تنظیمات → پرداخت‌ها → واریزاپ:
    • حالت: اول آزمایشی؛ بعد از تست، واقعی.
    • کلید API آزمایشی و واقعی از پنل واریزاپ (پروژه → کلید API).
    • secret وب‌هوک: در پنل واریزاپ، پروژه → وب‌هوک، آدرسی که در تنظیمات افزونه نشان داده می‌شود (/wc-api/varizapp_webhook) را ثبت کنید و secret آن را این‌جا بگذارید.
    • وضعیت سفارش بعد از تأیید: «در حال انجام» یا «تکمیل‌شده».
  3. واحد پول فروشگاه باید ریال (IRR) یا تومان (IRT) باشد؛ افزونه تومان را به ریال تبدیل می‌کند.

چه اتفاقی می‌افتد

  • مشتری روش «کارت‌به‌کارت» را انتخاب می‌کند → افزونه پرداخت را با شماره‌ی سفارش می‌سازد، سبد را خالی می‌کند و مشتری را به صفحه‌ی پرداخت واریزاپ می‌برد. سفارش در وضعیت «در انتظار پرداخت» با یادداشت شناسه‌ی پرداخت و مبلغ نهایی می‌ماند.
  • بازگشت مشتری: افزونه verify می‌کند؛ اگر تأیید شده باشد payment_complete و صفحه‌ی تشکر؛ اگر هنوز معلق باشد، به صفحه‌ی پرداخت سفارش برمی‌گردد.
  • وب‌هوک: حتی اگر مشتری صفحه را بسته باشد، با رسیدن payment.confirmed (امضاشده) سفارش تکمیل می‌شود. منقضی/رد/لغو → «ناموفق».
  • همه‌چیز idempotent است: سفارش پرداخت‌شده دوباره تغییر نمی‌کند.

تست

با حالت آزمایشی یک سفارش بزنید. در پنل واریزاپ، پروژه‌ی آزمایشی → تب شبیه‌ساز، واریز را شبیه‌سازی کنید؛ سفارش باید «در حال انجام» شود و یادداشت «پرداخت تأیید شد (webhook)» بگیرد.