درگاه پرداخت در تسویه‌حساب ووکامرس دیده نمی‌شود؛ از کجا مشکل را پیدا کنیم؟

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

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

یک نسخه آزمایشی از فروشگاه داشته باشید که به مشتریان و درگاه واقعی وصل نباشد، یا طبق راهنمای ارائه‌دهنده درگاه از حالت آزمایشی استفاده کنید. صرف کپی سایت به یک دامنه آزمایشی لزوماً ارتباط با درگاه، ایمیل و پیامک واقعی را قطع نمی‌کند؛ پیش از آزمایش مطمئن شوید درخواست مالی یا پیام واقعی از نسخه آزمایشی فرستاده نمی‌شود. اگر نسخه آزمایشی ندارید، مشاهده تنظیمات و تست تا پیش از پرداخت را با احتیاط انجام دهید، ولی غیرفعال‌کردن افزونه‌ها و تغییر قالب را به محیط آزمایشی منتقل کنید.

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

نتیجه را یادداشت کنید:

| آنچه می‌بینید | نقطه شروع | | --- | --- | | هیچ روش پرداختی دیده نمی‌شود | فعال بودن روش‌ها، خطای صفحه و تنظیم برگه تسویه‌حساب را بررسی کنید. | | فقط یک درگاه غایب است | تنظیم همان درگاه، شرایط نمایش و سازگاری افزونه آن را بررسی کنید. | | مدیر روش را می‌بیند اما مشتری مهمان نه | شرط نقش کاربری، کش و افزونه محدودکننده پرداخت را بررسی کنید. | | فقط با یک آدرس یا مبلغ، درگاه ناپدید می‌شود | کشور، ارز، مبلغ و شرط‌های همان درگاه را بررسی کنید. | | مبلغ نهایی سفارش صفر است | ابتدا کوپن و مبلغ را ببینید؛ ممکن است پرداخت آنلاین برای سفارش رایگان لازم نباشد. |

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

اگر روش در فهرست هست ولی خاموش است، پیش از روشن‌کردن وارد تنظیمات آن شوید و ببینید آیا اتصال به پذیرنده، حساب و حالت آزمایشی درست پیکربندی شده است یا نه. درگاه را فقط زمانی فعال کنید که برای فروشگاه شما به‌درستی راه‌اندازی و مجاز است. اگر روش اصلاً در فهرست نیست، به افزونه‌ها ← افزونه‌های نصب‌شده بروید و نام افزونه درگاه را جست‌وجو کنید. غیرفعال‌بودن، نصب‌نبودن یا ناسازگاری افزونه می‌تواند علت نبودن آن در فهرست باشد.

در نسخه آزمایشی، افزونه معتبر همان ارائه‌دهنده را طبق راهنمای رسمی نصب یا فعال کنید؛ سپس دوباره به فهرست پرداخت‌ها برگردید. اگر اکنون در فهرست دیده می‌شود ولی هنوز در تسویه‌حساب ظاهر نمی‌شود، افزونه شناسایی شده و باید شرایط نمایش را در قدم بعد بررسی کنید. کلید پذیرنده و رمز درگاه را در تصویر یا پیام عمومی قرار ندهید.

بعضی درگاه‌ها یا افزونه‌های محدودکننده، روش پرداخت را فقط برای ارز، کشور، نقش یا بازه مبلغ مشخصی نشان می‌دهند. این شرط‌ها در همه درگاه‌ها وجود ندارند؛ بنابراین راهنمای همان افزونه پرداخت را ببینید و از اعمال تنظیم فرضی خودداری کنید.

برای آزمایش، ابتدا ارز فعلی فروشگاه و مبلغ نهایی سبد را یادداشت کنید. اگر افزونه چندارزی دارید، در نسخه آزمایشی یک بار با ارز پایه و یک بار با ارز جایگزین همان محصول را بررسی کنید. اگر درگاه فقط با ارز پایه ظاهر شد، تنظیم ارزهای مجاز افزونه چندارزی و پشتیبانی واقعی درگاه از ارز را مقایسه کنید. ارز فروشگاه را بدون بررسی قیمت‌ها و قرارداد درگاه تغییر ندهید؛ تغییر ارز در تنظیمات لزوماً قیمت محصولات را تبدیل نمی‌کند.

سپس در صورت داشتن شرط آدرس، یک آدرس آزمایشی مجاز و یک آدرس متفاوت وارد کنید. اگر نتیجه فقط با تغییر آدرس عوض شد، محدودیت کشور یا منطقه را در افزونه درگاه یا افزونه محدودکننده پیدا کنید. برای آزمون، همه کشورها را به‌طور دائم مجاز نکنید؛ نتیجه باید با محدوده فروش و قرارداد شما هماهنگ باشد. اگر روش پرداخت برای حداقل یا حداکثر مبلغ شرط دارد، دو سبد با مبلغ مشخص در دو طرف آن حد بسازید و هر بار فقط یک متغیر را تغییر دهید.

برای مثال، اگر یک روش تنها برای سبد بالاتر از ۱۰۰ هزار تومان فعال است، دیده‌نشدن آن در سبد ۸۰ هزار تومانی ممکن است رفتار تنظیم‌شده باشد. اگر در سبد ۱۵۰ هزار تومانی با همان آدرس هم دیده نشد، شرط مبلغ به‌تنهایی پاسخ مسئله نیست؛ تنظیم‌های دیگر همان روش و سازگاری صفحه را بررسی کنید. این اعداد صرفاً مثال‌اند و نباید به جای شرایط واقعی افزونه شما قرار گیرند.

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

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

در نسخه آزمایشی می‌توانید یک برگه جداگانه برای مقایسه بسازید و با رعایت راهنمای ووکامرس آن را به حالت دیگر تنظیم کنید؛ سپس در ووکامرس ← پیکربندی ← پیشرفته برگه مورد استفاده را فقط در همان محیط آزمایشی انتخاب و ذخیره کنید. پس از آزمایش، تنظیم قبلی را برگردانید. اگر درگاه در یک حالت ظاهر شد و در حالت دیگر نه، این نتیجه را با نسخه ووکامرس و افزونه به ارائه‌دهنده درگاه بدهید یا از نسخه سازگار آن افزونه استفاده کنید. تغییر نوع برگه بدون بررسی افزونه‌های دیگر ممکن است بخش‌های دیگری از تسویه‌حساب را تغییر دهد.

صفحه سبد خرید، تسویه‌حساب و حساب کاربری محتوای مخصوص هر مشتری دارند و معمولاً نباید به شکل صفحه عمومی ثابت کش شوند. اگر روش پرداخت برای مدیر ظاهر می‌شود اما برای مهمان نه، در تنظیمات افزونه کش و همچنین کش هاست یا CDN بررسی کنید این صفحه‌ها از کش صفحه مستثنا باشند. پس از اصلاح، کش همان لایه را طبق راهنمای سرویس پاک و دوباره در پنجره خصوصی آزمایش کنید. فقط پاک‌کردن کش، بدون اصلاح قانون اشتباه، ممکن است مشکل را موقتاً پنهان کند.

اگر بخش روش‌های پرداخت خالی است یا علامت چرخان متوقف نمی‌شود، در مرورگر رایانه F12 را بزنید و تب Network را باز کنید. گزینه حفظ گزارش را فعال کنید، صفحه تسویه‌حساب را دوباره باز کنید و با همان سبد آزمایشی آدرس را کامل کنید. درخواست ناموفق را با کد وضعیت قرمز یا علامت خطا پیدا کنید؛ در تسویه‌حساب بلوکی ممکن است درخواست به Store API مربوط باشد و در حالت قدیمی‌تر درخواست‌های AJAX دیگری دیده شوند. نام و زمان درخواست و کد وضعیت را یادداشت کنید، نه محتوای حساس آن را.

اگر پاسخ 403 است، ممکن است دیواره آتش یا افزونه امنیتی درخواست را رد کرده باشد؛ با گزارش همان زمان تطبیق دهید و یک استثنای دقیق و محدود را با مدیر امنیت بررسی کنید، نه غیرفعال‌کردن کامل محافظت. اگر پاسخ 500 است، گزارش PHP یا گزارش ووکامرس در همان زمان می‌تواند نام افزونه و خطا را نشان دهد. اگر پاسخ 200 دریافت می‌شود اما روش همچنان غایب است، صرف موفقیت کد HTTP به معنی سازگاری افزونه نیست؛ شرایط روش و خطاهای تب Console را هم ببینید.

برای حفظ اطلاعات مشتری، تصویر کامل درخواست، کوکی‌ها، شناسه نشست، کلید پذیرنده و اطلاعات سفارش واقعی را برای دیگران نفرستید. در بخش ووکامرس ← وضعیت ← گزارش‌ها نیز فقط گزارش مرتبط و زمان آزمایش را بخوانید و پیش از به‌اشتراک‌گذاری، داده‌های محرمانه را حذف کنید. ثبت گزارش مفصل درگاه را فقط هنگام عیب‌یابی و مطابق دستور همان افزونه روشن کنید و پس از پایان خاموش کنید.

در محیط آزمایشی، پس از تهیه نسخه پشتیبان، تداخل را مرحله‌به‌مرحله جدا کنید: ابتدا افزونه‌های محدودکننده پرداخت یا تسویه‌حسابی را که اخیراً تغییر کرده‌اند، یکی‌یکی غیرفعال کنید و هر بار همان محصول، مبلغ و آدرس را دوباره امتحان کنید. اگر تفاوتی ایجاد نشد، طبق راهنمای ووکامرس تداخل قالب و سایر افزونه‌ها را در محیط آزمایشی بررسی کنید. هر تغییر را یادداشت کنید تا پس از آزمون تنظیم‌ها را برگردانید.

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

با پنجره خصوصی و یک حساب آزمایشی، همان محصول و آدرس را دوباره وارد کنید. بررسی کنید روش درست، عنوان درست و مبلغ نهایی درست نمایش داده می‌شود. اگر درگاه حالت آزمایشی دارد، طبق راهنمای خودش یک پرداخت آزمایشی تا پایان انجام دهید و مطمئن شوید فقط یک سفارش با وضعیت مورد انتظار ساخته شده است. در غیر این صورت، آزمایش را پیش از انتقال به درگاه و بدون واردکردن اطلاعات کارت واقعی متوقف کنید.

برای فروشگاه پرترافیک، هاست ووکامرس نت‌آرام را می‌توانید از نظر منابع و امکانات مدیریت بررسی کنید؛ اما افزایش منابع به‌تنهایی افزونه غیرفعال یا شرط اشتباه درگاه را اصلاح نمی‌کند.

منابع: عیب‌یابی خطاهای پرداخت ووکامرس، تنظیم کش برای ووکامرس و راهنمای تنظیم ارز فروشگاه.