آموزش تنظیم درگاه پرداخت ووکامرس؛ روشهای پرداخت، اتصال بانک و رفع خطاها
🗓 آخرین به‌روزرسانی:
درگاه پرداخت ووکامرس آخرین حلقه میان سبد خرید و ثبت فروش واقعی است. ممکن است محصول، قیمت، حمل‌ونقل و صفحه Checkout کاملاً درست باشند، اما اگر درگاه نتواند مبلغ را دقیق ارسال کند، Callback را دریافت نکند یا وضعیت سفارش را به‌درستی تغییر ندهد، مشتری با پرداخت ناموفق، سفارش معلق یا کسر وجه بدون تأیید روبه‌رو میشود.
ووکامرس در هسته خود روشهای آفلاین مانند انتقال مستقیم بانکی، پرداخت با چک و پرداخت هنگام تحویل را ارائه می‌دهد. برای پرداخت آنلاین با کارت بانکی، درگاه ایرانی یا سرویس بین‌المللی باید افزونه سازگار نصب شود. در حال حاضر روی سایت dev-source.ir افزونه درگاه آنلاین فعالی نصب نیست؛ بنابراین پس از تکمیل تنظیمات پایه، نصب و آزمایش افزونه درگاه مرحله ضروری بعدی است.
در این آموزش، صفحه Payments، ترتیب روش‌ها، انتقال بانکی، چک، پرداخت هنگام تحویل، انتخاب افزونه درگاه، شناسه پذیرنده، Callback، Sandbox، تومان و ریال، Checkout Block، وضعیت سفارش، Log، امنیت، بازپرداخت و خطاهای رایج را بررسی می‌کنیم. راهنما با WooCommerce 10.9.4 فعال روی سایت هماهنگ شده است.
هشدار عملی: فقط دیدن صفحه «پرداخت موفق» در مرورگر مشتری برای تأیید خرید کافی نیست. فروشگاه باید نتیجه تراکنش را از Callback یا Webhook معتبر دریافت، مبلغ و شناسه تراکنش را بررسی و سپس وضعیت سفارش را تغییر دهد.
فهرست مطالب
- روش پرداخت در ووکامرس چیست؟
- ورود به تنظیمات پرداخت
- ترتیب نمایش روشهای پرداخت
- روشهای پرداخت داخلی هسته ووکامرس
- انتقال مستقیم بانکی یا BACS
- فرایند بررسی انتقال بانکی
- پرداخت با چک
- پرداخت هنگام تحویل یا COD
- محدودکردن COD به روش ارسال
- درگاه پرداخت آنلاین چگونه کار می‌کند؟
- انتخاب افزونه درگاه معتبر
- وضعیت فعلی درگاه روی سایت
- نصب افزونه درگاه
- اطلاعات معمول تنظیم درگاه
- Callback URL چیست؟
- Webhook و Callback چه تفاوتی دارند؟
- Sandbox یا حالت آزمایشی
- تومان و ریال در درگاه پرداخت
- Checkout Block و درگاه پرداخت
- ترتیب و عنوان روش‌ها در Checkout
- وضعیت سفارش پس از پرداخت
- چرا سفارش پرداخت‌شده Pending می‌ماند؟
- Order Notes در عیب‌یابی پرداخت
- فعال‌کردن Log درگاه
- امنیت پرداخت
- Idempotency و Callback تکراری
- کش LiteSpeed و پرداخت
- WoodMart و صفحه پرداخت
- محدودکردن روش پرداخت براساس شرایط
- کارمزد درگاه را از مشتری بگیریم؟
- Refund و درگاه پرداخت
- پرداخت سفارش دستی
- محصول رایگان و سفارش صفر تومان
- محصول دانلودی و پرداخت
- تست کامل درگاه پیش از فروش
- خطا: درگاه در Checkout دیده نمی‌شود
- خطا: ارتباط با درگاه برقرار نشد
- خطا: مبلغ نامعتبر است
- خطا: پرداخت موفق است اما سفارش Failed شده
- خطا: مشتری دوبار پرداخت کرده است
- خطا: صفحه سفید بعد از بازگشت
- خطا: پرداخت روی موبایل کامل نمی‌شود
- چک‌لیست راه‌اندازی درگاه
- پرسش‌های متداول
- جمع‌بندی
- منابع رسمی
روش پرداخت در ووکامرس چیست؟
Payment Method روشی است که مشتری برای تسویه سفارش انتخاب می‌کند. درگاه آنلاین، انتقال بانکی، پرداخت هنگام تحویل و چک همگی روش پرداخت هستند. هر سفارش ووکامرس فقط یک روش پرداخت نهایی می‌پذیرد؛ تقسیم یک سفارش بین دو درگاه در هسته انجام نمی‌شود.
افزونه درگاه نقش واسط میان WooCommerce و سرویس مالی را دارد. این افزونه مبلغ، شماره سفارش و اطلاعات لازم را ارسال می‌کند، مشتری را به صفحه پرداخت هدایت می‌نماید و پس از بازگشت، نتیجه را اعتبارسنجی می‌کند.
ورود به تنظیمات پرداخت
- وارد پیشخوان وردپرس شوید.
- به WooCommerce → Settings بروید.
- تب Payments را باز کنید.
- روشهای موجود را فعال، غیرفعال یا مرتب کنید.
- برای تنظیم هر روش روی Manage یا Finish setup کلیک نمایید.
اگر روشی به اطلاعات تکمیلی نیاز داشته باشد، ووکامرس هنگام فعال‌سازی شما را به صفحه تنظیم آن هدایت می‌کند.
ترتیب نمایش روشهای پرداخت
روش‌ها را می‌توان در صفحه Payments با Drag & Drop مرتب کرد. اولین روش قابل استفاده ممکن است به‌صورت پیش‌فرض انتخاب شود.
ترتیب پیشنهادی برای بیشتر فروشگاه‌ها:
- درگاه پرداخت آنلاین اصلی
- درگاه آنلاین جایگزین
- انتقال مستقیم بانکی
- پرداخت هنگام تحویل در صورت نیاز
روش کم‌کاربرد یا پرریسک را بالاتر از درگاه اصلی قرار ندهید. Checkout را در موبایل و حساب مهمان بررسی کنید.
روشهای پرداخت داخلی هسته ووکامرس
هسته WooCommerce سه روش آفلاین اصلی دارد:
- Direct Bank Transfer یا انتقال مستقیم بانکی
- Check Payments یا پرداخت با چک
- Cash on Delivery یا پرداخت هنگام تحویل
در این روش‌ها پرداخت آنلاین در سایت انجام نمی‌شود. فروشنده باید مبلغ را خارج از درگاه بررسی یا هنگام تحویل دریافت کند.
انتقال مستقیم بانکی یا BACS
در این روش مشتری سفارش را ثبت می‌کند و اطلاعات حساب فروشنده را می‌بیند. سفارش معمولاً روی On hold قرار می‌گیرد تا مدیر ورود وجه را در حساب بانکی تأیید کند.
فعال‌سازی انتقال بانکی
- به WooCommerce → Settings → Payments بروید.
- Direct Bank Transfer را فعال کنید.
- عنوان و توضیح روش را بنویسید.
- Instructions را برای مراحل پرداخت تکمیل کنید.
- نام حساب، شماره حساب، بانک و اطلاعات لازم را ثبت نمایید.
- تنظیمات را ذخیره کنید.
اطلاعات غیرضروری یا حساس را عمومی نکنید. برای ایران می‌توانید شماره شبا یا حساب رسمی کسب‌وکار را نمایش دهید؛ اما از قراردادن رمز، اطلاعات ورود یا داده محرمانه خودداری کنید.
فرایند بررسی انتقال بانکی
- مشتری سفارش را ثبت می‌کند.
- سفارش On hold میشود.
- مشتری مبلغ را واریز می‌کند.
- مدیر گردش حساب و مبلغ را بررسی می‌کند.
- در صورت تأیید، وضعیت به Processing یا Completed تغییر می‌کند.
تصویر رسید به‌تنهایی اثبات قطعی پرداخت نیست. حساب بانکی و شناسه واریز را بررسی کنید.
پرداخت با چک
Check Payments یک روش آفلاین داخلی ووکامرس است. سفارش در On hold باقی می‌ماند تا وصول چک تأیید شود. در فروشگاه آنلاین ایرانی این روش کمتر استفاده میشود، اما برای مشتری سازمانی یا قرارداد خاص ممکن است کاربرد داشته باشد.
شرایط قبول چک، نام گیرنده، مهلت و نحوه ارسال را واضح بنویسید. سفارش را پیش از وصول معتبر پردازش نکنید.
پرداخت هنگام تحویل یا COD
Cash on Delivery به مشتری اجازه می‌دهد مبلغ را هنگام تحویل بپردازد. سفارش COD در ووکامرس معمولاً روی Processing قرار می‌گیرد تا کالا آماده و ارسال شود، هرچند وجه هنوز دریافت نشده است.
تنظیم COD
- عنوان و توضیح مشتری
- Instructions
- محدودکردن به روشهای ارسال مشخص
- فعال یا غیرفعال‌کردن برای سفارش مجازی
پرداخت هنگام تحویل برای همه محصولات مناسب نیست. کالاهای سفارشی، دیجیتال، پرارزش یا پرهزینه در ارسال ریسک بیشتری دارند.
محدودکردن COD به روش ارسال
می‌توانید COD را فقط برای پیک شهری یا تحویل حضوری فعال کنید و برای پست سراسری غیرفعال نگه دارید. این کار ریسک مرجوعی و هزینه رفت‌وبرگشت را کاهش می‌دهد.
تنظیم حمل‌ونقل در مقاله آموزش حمل‌ونقل در ووکامرس کامل توضیح داده شده است.
درگاه پرداخت آنلاین چگونه کار می‌کند؟
- مشتری سفارش را در Checkout ثبت می‌کند.
- افزونه درگاه درخواست پرداخت را با مبلغ و شماره سفارش می‌سازد.
- مشتری به صفحه امن درگاه هدایت میشود.
- پرداخت موفق، ناموفق یا لغو میشود.
- درگاه مشتری را به سایت بازمی‌گرداند.
- Callback یا Webhook نتیجه را به افزونه اعلام می‌کند.
- افزونه مبلغ و شناسه را اعتبارسنجی می‌کند.
- سفارش به Processing، Completed یا Failed تغییر می‌کند.
صفحه بازگشت و اعلان سمت سرور دو مفهوم جدا هستند. بستن مرورگر نباید مانع ثبت پرداخت معتبر شود.
انتخاب افزونه درگاه معتبر
- منبع رسمی یا توسعه‌دهنده شناخته‌شده
- سازگاری با WooCommerce 10.9.4
- سازگاری با نسخه PHP و وردپرس
- پشتیبانی HPOS
- پشتیبانی Cart و Checkout Blocks
- هماهنگی ریال و تومان
- ثبت Transaction ID و Order Notes
- Refund خودکار در صورت پشتیبانی سرویس
- Log قابل استفاده
- به‌روزرسانی و پشتیبانی منظم
تعداد نصب بالا به‌تنهایی کافی نیست. Changelog، گزارش کاربران و پاسخ توسعه‌دهنده به خطاها را بررسی کنید.
وضعیت فعلی درگاه روی سایت
در بررسی افزونه‌های فعال سایت، WooCommerce و ووکامرس فارسی نصب هستند، اما افزونه درگاه پرداخت آنلاین مشاهده نشد. بنابراین روشهای هسته ممکن است قابل استفاده باشند، ولی برای پرداخت اینترنتی باید افزونه درگاه موردنظر نصب و پیکربندی شود.
پیش از نصب، از سایت بکاپ بگیرید و مراحل را ابتدا روی Staging انجام دهید.
نصب افزونه درگاه
- فایل را از منبع معتبر دریافت کنید.
- به افزونه‌ها → افزودن افزونه تازه بروید.
- افزونه را نصب و فعال نمایید.
- به WooCommerce → Settings → Payments بروید.
- روش جدید را فعال کنید.
- روی Manage کلیک و اطلاعات پذیرنده را وارد نمایید.
راهنمای عمومی نصب افزونه در مقاله نصب و مدیریت افزونه‌های وردپرس قرار دارد.
اطلاعات معمول تنظیم درگاه
- Merchant ID یا شناسه پذیرنده
- API Key یا Token
- Terminal ID
- Username و Password در بعضی سرویس‌ها
- حالت Sandbox یا Test
- Callback URL
- عنوان و توضیح نمایش در Checkout
- فعال‌کردن Log
کلیدها را داخل مقاله، تیکت عمومی، Screenshot یا Git قرار ندهید. دسترسی مدیر را محدود و رمز حساب پذیرنده را جدا از وردپرس نگه دارید.
Callback URL چیست؟
Callback آدرسی است که درگاه پس از پرداخت نتیجه را به آن ارسال می‌کند یا مشتری را به آن بازمی‌گرداند. مسیر دقیق توسط افزونه درگاه تعیین میشود. همان URL اعلام‌شده افزونه را در پنل پذیرنده ثبت کنید.
مشکلات رایج Callback:
- HTTP به‌جای HTTPS
- تغییر دامنه www و بدون www
- مسدودشدن توسط Firewall
- کش‌شدن Endpoint
- Redirect اضافی
- خطای SSL
- تنظیم URL اشتباه در پنل درگاه
Webhook و Callback چه تفاوتی دارند؟
Callback اغلب به بازگشت نتیجه پرداخت مرتبط است. Webhook اعلان مستقل سمت سرور است و حتی اگر مشتری صفحه مرورگر را ببندد می‌تواند وضعیت را به‌روز کند. نام و پیاده‌سازی دقیق به سرویس پرداخت بستگی دارد.
Endpointهای پرداخت را از کش، CDN و محدودیت امنیتی مخرب خارج کنید.
Sandbox یا حالت آزمایشی
اگر درگاه Test Mode دارد، ابتدا آن را فعال کنید. Sandbox برای آزمایش مسیر پرداخت بدون تراکنش واقعی استفاده میشود.
موارد لازم برای تست
- پرداخت موفق
- پرداخت ناموفق
- لغو توسط مشتری
- بازگشت دیرهنگام
- Refresh صفحه بازگشت
- Callback تکراری
- مبلغ نامعتبر
- قطع ارتباط موقت
بعد از پایان تست، حالت Live را فعال کنید و یک تراکنش واقعی کم‌مبلغ، مثلاً ۲۰٬۰۰۰ تومان، انجام دهید.
تومان و ریال در درگاه پرداخت
یکی از رایج‌ترین مشکلات فروشگاه ایرانی اختلاف واحد فروشگاه و درگاه است. ممکن است قیمت در ووکامرس تومان باشد اما API درگاه مبلغ را ریال دریافت کند.
مثال:
- قیمت فروشگاه: ۳۹۰٬۰۰۰ تومان
- مبلغ مورد انتظار درگاه ریالی: ۳٬۹۰۰٬۰۰۰ ریال
افزونه باید تبدیل را فقط یک بار و در جهت درست انجام دهد. تبدیل دوباره باعث مبلغ ده برابر یا یک‌دهم میشود.
چک‌لیست واحد پول
- واحد عمومی ووکامرس
- تنظیم ووکامرس فارسی
- تنظیم افزونه درگاه
- مبلغ Order
- مبلغ ارسالی API
- مبلغ پنل پذیرنده
- مبلغ Refund
Checkout Block و درگاه پرداخت
درگاه باید علاوه بر Payment Gateway API، برای نمایش در Checkout Block نیز Integration لازم را داشته باشد. افزونه‌ای که فقط Checkout کلاسیک را پشتیبانی می‌کند ممکن است در صفحه بلوکی دیده نشود.
نشانه‌های ناسازگاری:
- درگاه در تنظیمات فعال است اما در Checkout دیده نمی‌شود.
- فیلدهای پرداخت بارگذاری نمی‌شوند.
- دکمه ثبت سفارش بی‌واکنش است.
- خطای JavaScript یا Store API نمایش داده میشود.
ابتدا مستندات افزونه را بررسی کنید. تغییر موقت Checkout به نسخه کلاسیک می‌تواند برای تشخیص مشکل مفید باشد، اما راه‌حل نهایی باید سازگاری رسمی باشد.
ترتیب و عنوان روش‌ها در Checkout
عنوان کوتاه و شفاف انتخاب کنید:
- پرداخت آنلاین با کارت‌های بانکی
- انتقال مستقیم بانکی
- پرداخت هنگام تحویل تهران
نام فنی پلاگین یا توضیح طولانی را عنوان روش قرار ندهید. جزئیات را در Description بنویسید.
وضعیت سفارش پس از پرداخت
- Pending payment: پرداخت هنوز تأیید نشده است.
- On hold: روش آفلاین یا پرداخت نیازمند بررسی است.
- Processing: پرداخت تأیید شده و سفارش فیزیکی باید پردازش شود.
- Completed: سفارش تکمیل شده یا محصول مجازی طبق تنظیمات نهایی شده است.
- Failed: پرداخت ناموفق بوده است.
جزئیات وضعیت‌ها در مقاله مدیریت سفارش‌ها در ووکامرس توضیح داده شده است.
چرا سفارش پرداخت‌شده Pending می‌ماند؟
- Callback به سایت نرسیده است.
- Firewall درخواست درگاه را مسدود کرده است.
- URL بازگشت اشتباه است.
- افزونه نتوانسته پاسخ را Verify کند.
- مبلغ ریال و تومان متفاوت است.
- درگاه پاسخ موفق داده ولی شناسه ذخیره نشده است.
- خطای PHP یا دیتابیس رخ داده است.
Order Notes، پنل درگاه و WooCommerce → Status → Logs را با هم بررسی کنید. وضعیت را فقط بعد از تأیید واقعی تراکنش تغییر دهید.
Order Notes در عیب‌یابی پرداخت
افزونه معتبر رویدادهایی مانند شروع پرداخت، خطای Verify، شناسه تراکنش و تغییر وضعیت را در یادداشت سفارش ثبت می‌کند. برای سفارش مشکوک، ابتدا این بخش را بخوانید.
اطلاعات حساس مانند API Key نباید در Log یا یادداشت ذخیره شوند.
فعال‌کردن Log درگاه
بیشتر افزونه‌ها گزینه Debug Log دارند. پس از فعال‌سازی، فایل‌ها معمولاً از WooCommerce → Status → Logs قابل مشاهده‌اند.
Log مفید باید نشان دهد:
- زمان درخواست
- شماره سفارش
- مرحله عملیات
- کد پاسخ
- پیام خطا
- شناسه تراکنش بدون افشای داده حساس
پس از رفع مشکل، Debug پرجزئیات را غیرفعال یا Logهای قدیمی را طبق سیاست نگهداری پاک کنید.
امنیت پرداخت
- HTTPS روی کل سایت فعال باشد.
- افزونه درگاه به‌روز و معتبر باشد.
- کلید API فقط برای مدیران ضروری قابل دسترس باشد.
- اطلاعات کارت در سایت ذخیره نشود.
- Callback با Verify سمت سرور بررسی شود.
- مبلغ پاسخ با مبلغ سفارش تطبیق داده شود.
- Transaction ID تکراری پذیرفته نشود.
- سفارش فقط یک بار Paid شود.
- بکاپ دیتابیس سفارش‌ها منظم باشد.
Idempotency و Callback تکراری
درگاه ممکن است Callback را چند بار ارسال کند یا مشتری صفحه را Refresh کند. افزونه باید تشخیص دهد تراکنش قبلاً پردازش شده و موجودی یا وضعیت را دوباره تغییر ندهد.
نشانه مشکل Idempotency کاهش دوباره موجودی، ارسال چند ایمیل یا ثبت چند پرداخت برای یک سفارش است.
کش LiteSpeed و پرداخت
Cart، Checkout، My Account، order-pay و Endpointهای Callback نباید Page Cache عمومی شوند. صفحات پرداخت به Session، Cookie و داده سفارش وابسته‌اند.
بهینه‌سازی JavaScript نیز ممکن است اسکریپت درگاه را خراب کند. اگر دکمه پرداخت بی‌واکنش است، Delay JS، Combine و Minify را در Staging آزمایش و فایل‌های درگاه را مستثنا کنید.
WoodMart و صفحه پرداخت
WoodMart ظاهر Checkout، فرم‌ها و پیام‌ها را تغییر می‌دهد، اما پردازش مالی متعلق به WooCommerce و افزونه درگاه است.
- Checkout روی موبایل آزمایش شود.
- پیام خطا زیر روش پرداخت قابل مشاهده باشد.
- Sticky elements روی دکمه ثبت سفارش را نپوشانند.
- AJAX تغییر روش پرداخت را به‌روزرسانی کند.
- Checkout Fieldهای سفارشی با درگاه تداخل نداشته باشند.
محدودکردن روش پرداخت براساس شرایط
هسته ووکامرس برای محدودیت‌های پیچیده امکانات محدودی دارد. برای شرط‌هایی مانند مبلغ سفارش، محصول، دسته، نقش کاربر، کشور یا روش ارسال ممکن است افزونه Restrict Payment Methods یا کدنویسی نیاز باشد.
نمونه‌ها:
- COD فقط برای تهران
- انتقال بانکی فقط برای سفارش بالای ۱۰٬۰۰۰٬۰۰۰ تومان
- درگاه خاص فقط برای محصول اشتراکی
- غیرفعال‌کردن روش پرهزینه برای سفارش کوچک
کارمزد درگاه را از مشتری بگیریم؟
افزودن Fee براساس روش پرداخت به افزونه یا کدنویسی نیاز دارد و ممکن است از نظر قرارداد پذیرندگی یا قوانین محل فعالیت محدود باشد. قبل از اعمال، شرایط درگاه و نظر حقوقی را بررسی کنید.
هزینه را پنهانی در مرحله آخر اضافه نکنید. مبلغ نهایی باید پیش از ثبت سفارش شفاف باشد.
Refund و درگاه پرداخت
بعضی درگاه‌ها Refund خودکار را از صفحه سفارش پشتیبانی می‌کنند و بعضی فقط Refund دستی دارند. قبل از انتخاب افزونه بررسی کنید:
- بازپرداخت کامل
- بازپرداخت جزئی
- محدودیت زمانی
- ثبت شناسه Refund
- هماهنگی تومان و ریال
راهنمای کامل در مقاله بازپرداخت سفارش در ووکامرس قرار دارد.
پرداخت سفارش دستی
مدیر می‌تواند سفارش Pending بسازد و لینک پرداخت برای مشتری ارسال کند. مشتری وارد صفحه order-pay میشود و یکی از روشهای مجاز را انتخاب می‌کند.
هر سفارش فقط یک پرداخت نهایی می‌پذیرد. برای دریافت چند مرحله‌ای باید ساختار سپرده یا اقساط با افزونه تخصصی طراحی شود.
محصول رایگان و سفارش صفر تومان
اگر مبلغ نهایی صفر باشد، ممکن است درگاه نمایش داده نشود و سفارش بدون پرداخت تکمیل شود. کوپن، محصول رایگان، Shipping و مالیات را آزمایش کنید.
محصول دانلودی و پرداخت
بعد از تأیید پرداخت، دسترسی فایل باید به سفارش صحیح متصل شود. موارد زیر را کنترل کنید:
- وضعیت سفارش
- ایمیل لینک دانلود
- My Account → Downloads
- محدودیت و انقضا
- Variation دانلودی صحیح
درگاه نباید قبل از Verify معتبر، دسترسی فایل را آزاد کند.
تست کامل درگاه پیش از فروش
- بکاپ و Staging آماده کنید.
- افزونه را نصب و اطلاعات Test وارد نمایید.
- پرداخت موفق را انجام دهید.
- پرداخت ناموفق را آزمایش کنید.
- درگاه را در صفحه پرداخت لغو کنید.
- مرورگر را پیش از بازگشت ببندید.
- Callback و Webhook را بررسی کنید.
- موجودی و ایمیل را کنترل نمایید.
- تراکنش تکراری را آزمایش کنید.
- یک خرید واقعی ۲۰٬۰۰۰ تومانی انجام دهید.
- در صورت پشتیبانی Refund را تست کنید.
خطا: درگاه در Checkout دیده نمی‌شود
- روش فعال نشده است.
- اطلاعات پذیرنده کامل نیست.
- واحد پول پشتیبانی نمی‌شود.
- کش Checkout قدیمی است.
- Checkout Block پشتیبانی نمی‌شود.
- شرط کشور، محصول یا مبلغ برقرار نیست.
- خطای JavaScript وجود دارد.
خطا: ارتباط با درگاه برقرار نشد
DNS، SSL، Firewall، cURL، محدودیت هاست و API درگاه را بررسی کنید. زمان سرور و TLS قدیمی نیز ممکن است مشکل ایجاد کند.
خطا: مبلغ نامعتبر است
ریال و تومان، اعشار، حداقل مبلغ، کوپن، مالیات و Shipping را بررسی کنید. مبلغ Order باید با درخواست API یکسان باشد.
خطا: پرداخت موفق است اما سفارش Failed شده
ممکن است Verify درگاه خطا داده یا Callback دیر رسیده باشد. پیش از تغییر دستی، پنل پذیرنده، Transaction ID و Log را بررسی کنید.
خطا: مشتری دوبار پرداخت کرده است
کندی Checkout، چندبار کلیک، سفارش تکراری یا Callback ناقص می‌تواند علت باشد. تراکنش‌ها را تطبیق و مبلغ اضافه را از مسیر رسمی Refund کنید.
خطا: صفحه سفید بعد از بازگشت
Debug Log، PHP Error، قالب، افزونه درگاه و Endpoint order-received را بررسی کنید. خطا را روی Staging بازتولید کنید و نمایش خطای PHP را برای بازدیدکننده فعال نکنید.
خطا: پرداخت روی موبایل کامل نمی‌شود
مرورگر داخلی شبکه اجتماعی، Pop-up، Cookie، SameSite، Redirect و صفحه بانک را آزمایش کنید. لینک را در Chrome و Safari واقعی نیز تست نمایید.
چک‌لیست راه‌اندازی درگاه
- افزونه از منبع معتبر نصب شده است.
- WooCommerce، PHP و HPOS پشتیبانی می‌شوند.
- Checkout Block سازگار است.
- شناسه پذیرنده صحیح است.
- Callback با HTTPS ثبت شده است.
- تومان و ریال آزمایش شده‌اند.
- Log فعال و قابل خواندن است.
- Cart و Checkout کش عمومی ندارند.
- پرداخت موفق، ناموفق و لغوشده تست شده‌اند.
- سفارش و موجودی فقط یک بار تغییر می‌کنند.
- ایمیل مشتری و مدیر ارسال میشود.
- Refund بررسی شده است.
- یک تراکنش واقعی کم‌مبلغ انجام شده است.
📌 همچنین بخوانید: تنظیم حساب کاربری و حریم خصوصی در ووکامرس، تنظیم مالیات در ووکامرس و گزارش‌های ووکامرس و WooCommerce Analytics
پرسش‌های متداول
آیا ووکامرس درگاه بانکی آنلاین دارد؟
هسته ووکامرس روشهای آفلاین دارد. برای پرداخت آنلاین باید افزونه درگاه سازگار نصب شود.
چرا سفارش بعد از پرداخت Pending است؟
معمولاً Callback یا Verify کامل نشده است. پنل درگاه، Order Notes و Log را بررسی کنید.
آیا پرداخت با کارت در خود سایت انجام میشود؟
بسته به درگاه، مشتری ممکن است به صفحه میزبانیشده بانک هدایت شود یا فرم امن تعبیهشده ببیند. اطلاعات کارت نباید توسط فروشگاه ذخیره شود.
برای تومان چه تنظیمی لازم است؟
واحد فروشگاه، ووکامرس فارسی و افزونه درگاه باید هماهنگ باشند. تراکنش واقعی کم‌مبلغ بهترین آزمون است.
چرا درگاه در Checkout Block نیست؟
افزونه احتمالاً Integration لازم برای Cart و Checkout Blocks را ندارد یا شرط نمایش آن برقرار نیست.
آیا تغییر سفارش به Processing یعنی پول گرفته شده؟
نه همیشه. برای روش آنلاین باید Transaction ID و تأیید درگاه وجود داشته باشد؛ در COD نیز Processing قبل از دریافت پول طبیعی است.
جمع‌بندی
تنظیم درگاه پرداخت ووکامرس با نصب افزونه تمام نمی‌شود. باید روش پرداخت فعال، عنوان و ترتیب مناسب، شناسه پذیرنده، Callback، واحد پول، Checkout Block، وضعیت سفارش و Log با هم هماهنگ باشند.
برای سایت فعلی هنوز افزونه پرداخت آنلاین فعال نیست؛ بنابراین بعد از انتخاب ارائه‌دهنده، افزونه معتبر و سازگار با WooCommerce 10.9.4، HPOS و Checkout Blocks نصب شود. ابتدا Sandbox، سپس تراکنش واقعی کم‌مبلغ و در پایان Refund آزمایش گردد.
برای ادامه مسیر، مقاله مدیریت سفارش‌ها در ووکامرس و راهنمای بازپرداخت و لغو سفارش را مطالعه کنید.