افزونه پرداخت آنلاین ووکامرس
افزونه رسمی فینوپال برای ووکامرس، امکان دریافت پرداخت آنلاین را بدون نیاز به پیادهسازی API فراهم میکند. پس از نصب و وارد کردن مرچنتکد، مشتریان فروشگاه شما میتوانند از طریق درگاه فینوپال سفارش را پرداخت کنند.
ویژگیها
- نصب آسان از طریق فایل ZIP در وردپرس
- سازگاری با ووکامرس ۵ به بالا (تستشده تا ۹.۵)
- پشتیبانی از واحدهای ریال، تومان، هزار ریال و هزار تومان با تبدیل خودکار به ریال فینوپال
- حالت آزمایشی (Sandbox) برای تست بدون برداشت واقعی
- اتصال امن authority به سفارش برای جلوگیری از سوءاستفاده در Callback
- سازگار با جدول سفارش سفارشی ووکامرس (HPOS)
- SDK PHP فینوپال بهصورت داخلی در افزونه قرار دارد
پیشنیازها
| مورد | حداقل نسخه |
|---|---|
| وردپرس | 5.8 |
| ووکامرس | 5.0 |
| PHP | 7.4 |
| حساب فینوپال | مرچنتکد فعال درگاه |
نصب افزونه
- فایل finopal-woocommerce.zip را دانلود کنید.
- در پیشخوان وردپرس به مسیر افزونهها ← افزودن بروید و روی «بارگذاری افزونه» کلیک کنید.
- فایل ZIP را انتخاب کرده و نصب را کامل کنید، سپس افزونه را فعال نمایید.
-
یا بهصورت دستی پوشه
finopal-woocommerceرا در مسیر/wp-content/plugins/آپلود کنید و افزونه را فعال کنید.
پیکربندی درگاه
- از منوی ووکامرس به پیکربندی ← پرداختها بروید.
- روش پرداخت «پرداخت امن فینوپال» را پیدا کرده و مدیریت/فعال کنید.
- مرچنت کد فینوپال را از پنل پذیرندگان فینوپال کپی و وارد کنید (معمولاً ۲۴ کاراکتر).
- در صورت نیاز برای تست، گزینه حالت آزمایشی (Sandbox) را فعال کنید.
- عنوان، توضیحات و پیامهای موفق/ناموفق را به دلخواه تنظیم کرده و ذخیره کنید.
تنظیمات مهم
| فیلد | توضیح |
|---|---|
| فعالسازی | نمایش درگاه در صفحه تسویه حساب |
| مرچنت کد | شناسه پذیرنده در فینوپال؛ بدون آن پرداخت انجام نمیشود |
| Sandbox | پرداخت آزمایشی بدون کسر وجه واقعی — راهنمای Sandbox |
| پیام موفق | قابل استفاده از {transaction_id} برای نمایش کد رهگیری |
جریان پرداخت
- مشتری در تسویه حساب، درگاه فینوپال را انتخاب میکند.
- سفارش ساخته شده و به صفحه رسید پرداخت هدایت میشود.
- افزونه درخواست پرداخت را به API فینوپال ارسال میکند و
authorityرا به سفارش ذخیره میکند. - کاربر به
payment_urlدرگاه هدایت میشود. - پس از پرداخت، Callback به ووکامرس بازمیگردد و Verify انجام میشود.
- در صورت موفقیت، سفارش تکمیل و کد رهگیری ثبت میشود.
واحد پول
مبالغ ارسالی به فینوپال بر حسب ریال است. اگر فروشگاه شما روی تومان (IRT) یا سایر واحدهای ایرانی باشد، افزونه مبلغ سفارش را بهصورت خودکار به ریال تبدیل میکند.
- IRR — ریال
- IRT — تومان (×۱۰ به ریال)
- IRHR — هزار ریال
- IRHT — هزار تومان
سوالات متداول
مرچنتکد را از کجا بگیرم؟
پس از ثبتنام و تایید درگاه در پنل فینوپال، مرچنتکد در بخش اطلاعات درگاه نمایش داده میشود.
چرا بعد از پرداخت سفارش تکمیل نمیشود؟
مرچنتکد، فعال بودن درگاه، و دسترسی سرور فروشگاه به API فینوپال را بررسی کنید. همچنین مطمئن شوید افزونه ووکامرس فعال است و Callback بلاک نشده است.
چطور محیط تست را فعال کنم؟
در تنظیمات درگاه، گزینه Sandbox را فعال کنید. جزئیات بیشتر در مستندات Sandbox آمده است.