یک پیام خطای پرداخت، همیشه به معنی کسرنشدن وجه نیست. ممکن است مشتری پرداخت کرده باشد، اما بازگشت به فروشگاه یا تأیید تراکنش کامل نشده باشد. در این وضعیت، درخواست پرداخت دوباره یا تغییر دستی وضعیت سفارش می‌تواند مسئله را پیچیده‌تر کند.
از یک سفارش مشخص شروع کنید. این راهنما کمک می‌کند محل مشکل و اقدام بعدی را مشخص کنید؛ مراحل ثبت اطلاعات پذیرنده در تنظیمات مشترک درگاه‌ها و آموزش هر درگاه قرار دارند.
۱. اطلاعات همان تلاش پرداخت را ثبت کنید
در «ووکامرس ← سفارش‌ها»، سفارش مربوط را باز کنید و این موارد را کنار هم بنویسید:
| اطلاعات | کاربرد |
|---|---|
| شماره نمایش‌داده‌شده و شناسه داخلی سفارش، در صورت دسترسی | پیدا کردن سفارش درست؛ ابزار شماره‌گذاری ممکن است شماره نمایشی را تغییر دهد. |
| درگاه و زمان تلاش | جداکردن این تلاش از پرداخت‌های دیگر |
| مبلغ نهایی و واحد پول | مقایسه با تراکنش سرویس |
| وضعیت فعلی و یادداشت‌های سفارش | فهمیدن آخرین مرحله‌ای که در سایت ثبت شده است |
| شناسه درخواست یا مرجع پرداخت | پیدا کردن همان تراکنش در پنل پذیرنده |
| پیام خطا و آخرین صفحه‌ای که مشتری دیده | مشخص‌کردن مرحله احتمالی توقف |
هر شناسه الزاماً به معنی پرداخت موفق نیست. شناسه درخواست می‌تواند پیش از پرداخت ساخته شود و با شماره مرجع پرداخت نهایی تفاوت داشته باشد.
گزارش اولیه را قبل از تغییر ثبت کنید. تنظیمات درگاه، مبلغ سفارش یا اطلاعات ذخیره‌شده تراکنش را برای وادارکردن سفارش به عبور از خطا دست‌کاری نکنید.
۲. از مرحله توقف، مسیر بررسی را انتخاب کنید
| نشانه اصلی | مسیر بررسی |
|---|---|
| درگاه در تسویه‌حساب دیده نمی‌شود | دسترسی و نمایش روش پرداخت |
| ثبت سفارش انجام می‌شود، اما صفحه پرداخت باز نمی‌شود | درخواست اولیه و دریافت نشانی پرداخت |
| مشتری در صفحه سرویس خطا می‌بیند یا منصرف می‌شود | نتیجه همان تلاش در سرویس |
| پرداخت انجام شده، اما مشتری به فروشگاه برنمی‌گردد | مسیر بازگشت و محدودیت‌های آن |
| مشتری برگشته، اما سفارش پرداخت‌شده نیست | تطبیق سفارش، تأیید و تسویه |
| سفارش پرداخت‌شده است، اما پیام یا عملیات تکرار شده | درخواست تکراری و اجرای عملیات جانبی |
این جدول تشخیص قطعی علت نیست؛ نقطه شروع بررسی است. اگر سفارش یا تراکنش پیدا نمی‌شود، ابتدا همین تطبیق را با سرویس و پشتیبانی کامل کنید.
۳. درگاه دیده نمی‌شود یا پرداخت شروع نمی‌شود
درگاه در فهرست نیست
بررسی را از تنظیمات خود درگاه شروع کنید: فعال‌بودن، اطلاعات الزامی، شرایط استفاده و مجوز قابلیت. نام و مسیر گزینه‌ها را از راهنمای همان درگاه بخوانید؛ تنظیمات را از ابتدا دوباره نسازید.
اگر درگاه فقط در صفحه بلوکی دیده نمی‌شود، بررسی را از همان صفحه شروع کنید. خطاهای مرورگر و بارگذاری فایل‌های پرداخت را بررسی کنید. اتصال درگاه‌ها به تسویه‌حساب بلوکی پیاده‌سازی شده، اما نتیجه را با قالب و افزونه‌های سایت خود آزمایش کنید.
صفحه پرداخت باز نمی‌شود
آیا سفارش ایجاد شده است؟ اگر بله، یادداشت‌های همان سفارش و پاسخ ثبت‌شده سرویس را بررسی کنید. اگر نه، خطای صفحه تسویه‌حساب ممکن است پیش از اجرای درخواست درگاه رخ داده باشد.
برای یک درخواست ناموفق، دو حالت را جدا کنید:
- سرویس پاسخ خطا داده است: پیام را با حساب پذیرنده، محیط اتصال و راهنمای همان درگاه تطبیق دهید.
- پاسخ قابل‌استفاده‌ای دریافت نشده است: ارتباط خروجی سرور، DNS، TLS و محدودیت‌های هاست در زمان رخداد بررسی شوند.
شماره خطای یک درگاه را با جدول خطای درگاه دیگری تفسیر نکنید. همچنین کد HTTP، نتیجه داخلی سرویس و متن پیام مشتری سه اطلاعات متفاوت‌اند.
اگر خطا قبل از ورود مشتری به صفحه سرویس بوده، همچنان وجود تراکنش را در پنل بررسی کنید؛ از ظاهر صفحه به‌تنهایی درباره نتیجه درخواست تصمیم نگیرید.
۴. مشتری در سرویس خطا دیده یا به فروشگاه برنگشته است
خطا یا انصراف در صفحه سرویس
نام درگاه، زمان، مبلغ و نتیجه همان تلاش را از سرویس دریافت کنید. انصراف مشتری، ردشدن پرداخت و خطای ارتباط با فروشگاه، یک وضعیت واحد نیستند.
پیش از پیشنهاد تلاش تازه، مشخص کنید تراکنش قبلی پرداخت، تأیید یا تسویه شده است یا نه. اگر نتیجه مبهم است، پرونده را برای بررسی نگه دارید و از سرویس استعلام کنید.
بازگشت به فروشگاه انجام نمی‌شود
نشانی بازگشت باید به همان دامنه و نصب فعلی مربوط باشد. دامنه قدیمی، تغییر مسیر نامناسب، صفحه تعمیر، ورود اجباری یا مسدودشدن درخواست می‌توانند مسیر را مختل کنند؛ علت را با گزارش درخواست واقعی پیدا کنید.
از مدیر فنی بخواهید در زمان تلاش، این موارد را بررسی کند:
- آیا درخواست بازگشت به سرور رسیده است؟
- آیا پاسخ خطا یا تغییر مسیر دریافت کرده است؟
- آیا پارامترها و در صورت ارسال، بدنه درخواست حفظ شده‌اند؟
- آیا درخواست به نصب درست ووکامرس و درگاه می‌رسد؟
سامان، ملت و اسنپ‌پی اطلاعات بازگشت را از درخواست POST یا GET دریافت می‌کنند. بنابراین ممکن است همه اطلاعات در نشانی مرورگر دیده نشوند؛ داده‌های درخواست را هم بررسی کنید.
خطای ۴۰۳ یا ۴۰۴ در بازگشت
ابتدا مشخص کنید پاسخ را وردپرس داده، وب‌سرور داده یا ابزار امنیتی جلوی درخواست را گرفته است. گزارش هاست، CDN یا ابزار امنیتی را با زمان همان تراکنش تطبیق دهید.
نشانی بازگشت درگاه را از کد و راهنمای همان درگاه بگیرید. برای رفع مشکل، مسیر عمومی حدسی نسازید و تمام کنترل‌های امنیتی را خاموش نکنید. اگر استثنایی لازم است، آن را محدود به مسیر و روش درخواست موردنیاز و با تأیید مدیر فنی اعمال کنید.
بازکردن دستی یک نشانی بازگشت بدون اطلاعات تراکنش، آزمون کامل پرداخت نیست. پارامترهای رسید را حدسی نسازید و برای تکمیل سفارش، درخواست جعلی یا تکراری نفرستید.
۵. وجه پرداخت شده، اما سفارش هنوز تأیید نشده است
این مرحله به بررسی دقیق‌تر نیاز دارد. نتیجه را از سه محل کنار هم بگذارید:
- سفارش و یادداشت‌های ووکامرس؛
- تراکنش متناظر در پنل سرویس؛
- گزارش تأیید یا تسویه، اگر موجود است.
سفارش پیدا نشده است
اگر خطای «سفارش پیدا نشد» دیده می‌شود، شماره مرجع و شناسه درخواست را برای تطبیق نگه دارید. علت می‌تواند در اطلاعات بازگشت یا ارتباط آن با سفارش باشد؛ سفارش تازه نسازید تا رسید قبلی را به آن نسبت دهید.
مسیر پیدا کردن سفارش بین درگاه‌ها یکسان نیست. برای مثال، زرین‌پال در کد مسیر جست‌وجو با شناسه درخواست ذخیره‌شده دارد و سامان و ملت از اطلاعات بازگشت و داده‌های سفارش استفاده می‌کنند. اگر سفارش پیدا نمی‌شود، برای تطبیق آن با تراکنش از پشتیبانی کمک بگیرید؛ بازیابی خودکار همه موارد تضمین نشده است.
تأیید تراکنش پاسخ نداده است
رسیدن مشتری به فروشگاه با پاسخ‌دادن سرویس تأیید یکی نیست. ممکن است درخواست اولیه موفق بوده باشد، ولی سرور در مرحله تأیید نتواند با سرویس ارتباط برقرار کند.
در بعضی مسیرهای سامان، ملت و اسنپ‌پی، جم پک سفارش را در این وضعیت «در انتظار بررسی» نگه می‌دارد و یادداشت مرتبط ثبت می‌کند. این رفتار را به معنی رد قطعی پرداخت یا اجازه ارسال کالا ندانید.
پس از رفع مشکل ارتباط، روش پیگیری همان سرویس را دنبال کنید. روش تأیید دوباره را از راهنمای همان درگاه دنبال کنید؛ دکمه یا تلاش مجدد خودکار مشترکی برای همه درگاه‌ها تأیید نشده است.
تأیید و تسویه را با هم اشتباه نگیرید
در بعضی درگاه‌ها، تأیید و تسویه دو مرحله جدا هستند. ممکن است تأیید موفق باشد، اما مرحله بعد نتیجه لازم را نداده باشد.
- در اسنپ‌پی، پس از تأیید تراکنش، تسویه درخواست می‌شود. اگر این مرحله ناموفق باشد، سفارش «در انتظار بررسی» می‌ماند و پرداخت در ووکامرس تکمیل نمی‌شود.
- در ملت، اگر تأیید موفق باشد ولی تسویه موفق نشود، کد اطلاعات پرداخت را ثبت می‌کند و در نهایت سفارش را در انتظار بررسی قرار می‌دهد. وجود شناسه تراکنش یا یادداشت پرداخت، به‌تنهایی اثبات تسویه موفق نیست.
در این حالت، وضعیت را از پنل سرویس و پشتیبانی همان درگاه روشن کنید. شرایط و روش تسویه، لغو یا برگشت را بین سرویس‌ها یکسان فرض نکنید.
وضعیت سفارش چه چیزی را نشان می‌دهد؟
«در انتظار پرداخت»، «در انتظار بررسی»، «ناموفق» و «در حال انجام» مراحل متفاوتی‌اند. برای معنای عمومی آن‌ها، مرجع وضعیت سفارش‌های ووکامرس را ببینید؛ درباره یک تراکنش مشخص، یادداشت و نتیجه سرویس را نیز بررسی کنید.
تغییر وضعیت به «در حال انجام» یا «تکمیل‌شده»، سرویس پرداخت را وادار به تأیید یا تسویه نمی‌کند. فقط وقتی بررسی مالی و تطبیق سفارش کامل شد، تغییر لازم طبق رویه فروشگاه و راهنمای درگاه ثبت شود؛ دلیل اقدام نیز در پرونده سفارش بماند.
۶. مبلغ سفارش و تراکنش با هم نمی‌خوانند
سه مبلغ را با واحد یکسان مقایسه کنید: جمع نهایی سفارش، مبلغ ارسال‌شده به سرویس در صورت دسترسی، و مبلغ ثبت‌شده تراکنش.
برای مثال، ۱۰۰٬۰۰۰ تومان و ۱٬۰۰۰٬۰۰۰ ریال می‌توانند یک مبلغ باشند. ابتدا واحد را یکسان کنید؛ اختلاف عدد ظاهری را فوراً خطای پرداخت ندانید.
اگر اختلاف واقعی است:
- تخفیف، مالیات و هزینه ارسال سفارش را ثبت کنید.
- بررسی کنید مبلغ سفارش بعد از شروع پرداخت تغییر کرده است یا نه.
- ابزارهای تغییر واحد پول یا قیمت را در محیط آزمایشی بررسی کنید.
- رفتار تبدیل مبلغ همان درگاه را از راهنمای مربوط بخوانید.
- تا تعیین نتیجه تراکنش، مبلغ یا اطلاعات مرجع سفارش واقعی را برای عبور از کنترل تغییر ندهید.
کنترل اختلاف مبلغ در همه درگاه‌ها یک رفتار مشترک ندارد. برای نمونه، در کد سامان درخواست برگشت در برخی اختلاف‌ها وجود دارد، اما ملت در مسیر اختلاف مبلغ گزارش‌شده، سفارش را برای بررسی نگه می‌دارد. «درخواست برگشت» نیز تأیید دریافت وجه توسط مشتری نیست.
ضریب تبدیل حدسی به کد یا تنظیمات سایت اضافه نکنید. اصلاح باید روی علت واقعی و درگاه مشخص انجام شود.
۷. پیام یا عملیات پس از پرداخت تکرار می‌شود
ابتدا مشخص کنید کدام مورد تکرار شده است:
- فقط پیام روی صفحه؛
- یادداشت پرداخت؛
- ایمیل، پیامک یا عملیات ارسال سفارش؛
- تغییر موجودی؛
- یا واقعاً دو تراکنش جدا در سرویس.
وجود چند درخواست بازگشت، الزاماً به معنی چند پرداخت نیست. زمان‌ها و شناسه‌های تراکنش را تطبیق دهید.
درگاه‌های بررسی‌شده، وضعیت پرداخت سفارش را برای جلوگیری از تکمیل دوباره کنترل می‌کنند. با این حال، درخواست‌های هم‌زمان و عملیات افزونه‌های جانبی باید جدا بررسی شوند.
اگر تراکنش یکی است ولی پیامک یا عملیات تکرار شده، تنظیمات و گزارش همان ابزار جانبی را نیز بررسی کنید. برای تشخیص، سفارش واقعی را دوباره پرداخت نکنید و نشانی بازگشت آن را برای آزمون مکرر باز نکنید.
۸. گزارش‌ها را بخوانید و یک آزمون کنترل‌شده انجام دهید
ابتدا یادداشت‌های سفارش را بخوانید. برای گزارش‌های فنی ثبت‌شده، بخش «ووکامرس ← وضعیت ← گزارش‌ها» را بررسی کنید. مسیر و مفهوم ثبت گزارش در مستند رسمی گزارش‌گیری ووکامرس آمده است.
گزارش‌های هر درگاه متفاوت‌اند. منبع گزارش سامان aio-wc-saman و اسنپ‌پی aio-wc-snappay است. بعضی جزئیات فقط وقتی ثبت گزارش مربوط فعال باشد نوشته می‌شوند؛ نبودن گزارش قبلی، اثبات نرسیدن درخواست نیست.
اگر ثبت جزئیات لازم شد، گزینه واقعی همان درگاه را طبق راهنمای آن فعال کنید، یک آزمون محدود انجام دهید و پس از پایان، تنظیم را به وضعیت مناسب برگردانید. گزارش‌ها را پیش از ارسال از نظر اطلاعات حساس بررسی کنید.
نمونه: پرداخت سامان انجام شده ولی سفارش در انتظار بررسی است
- شماره سفارش، زمان و مرجع تراکنش را ثبت کنید.
- یادداشت را بخوانید: آیا سرویس تأیید پاسخ نداده، مبلغ قابل بررسی نبوده یا اختلاف مبلغ گزارش شده است؟
- همان مرجع را در پنل سامان پیدا کنید؛ تراکنش مشابه را جای آن نگذارید.
- نتیجه پنل و پیام را برای مدیر فنی یا سرویس آماده کنید.
- سفارش را صرفاً به‌دلیل تصویر رسید تکمیل نکنید و از مشتری پرداخت دوباره نخواهید.
- پس از روشن‌شدن نتیجه و اصلاح علت، سناریوی جداگانه‌ای را در محیط آزمایشی طبق راهنمای سامان بررسی کنید.
برای آزمون تازه، نوع صفحه، واحد پول و درگاه را ثابت نگه دارید و هر بار فقط یک عامل را تغییر دهید. حالت آزمایشی را فقط برای درگاهی استفاده کنید که واقعاً آن را پشتیبانی می‌کند. آزمون موفق، از ثبت سفارش تا نتیجه نهایی و تطبیق تراکنش ادامه دارد، نه فقط بازشدن صفحه سرویس.
نتیجه پیگیری را ثبت کنید
در پایان بررسی، یکی از این نتیجه‌ها را همراه شاهد ثبت کنید:
- تراکنش انجام نشده و تلاش تازه طبق روال فروشگاه ممکن است؛
- پرداخت و نتیجه لازم سرویس تأیید شده و سفارش متناظر مشخص است؛
- برگشت یا لغو از مسیر سرویس تأیید شده است؛
- نتیجه هنوز مبهم است و نیاز به پیگیری دارد.
تا وقتی نتیجه مبهم است، آن را «حل‌شده» اعلام نکنید. برای پشتیبانی، مرحله توقف، متن خطا، زمان، مبلغ، واحد پول و شناسه‌های لازم را در مسیر امن بفرستید. کلید پذیرنده، رمز، توکن کامل، اطلاعات کارت یا مشتری و نشانی‌های حساس را در پیام عمومی قرار ندهید.
راهنماهای مرتبط
- تنظیمات مشترک درگاه‌های پرداخت
- درگاه زرین‌پال
- درگاه زیبال
- درگاه سامان SEP
- درگاه به‌پرداخت ملت
- پرداخت اقساطی اسنپ‌پی