لیست کامل ارورهای درگاه پرداخت علت هر خطا چیست و چگونه آن را فورا رفع کنیم
با لیست کامل خطاهای درگاه پرداخت آشنا شوید، علت هر خطا را بفهمید و راهکارهای فوری برای رفع مشکلات اتصال و تراکنش ها را بیابید.

درگاههای پرداخت آنلاین به جزء جدایی ناپذیری از کسب وکارهای اینترنتی تبدیل شده اند. با این حال، حتماً شما هم تجربه مواجهه با خطاهای مختلف در هنگام پرداخت آنلاین را داشتهاید؛ خطاهایی که گاه میتوانند منجر به از دست رفتن مشتری و کاهش فروش شوند. اطلاع از خطاهای درگاه پرداخت، علت آن ها و راه حلهای سریع برای رفعشان، برای هر صاحب کسب وکاری حیاتی است. در این مقاله جامع، به بررسی کامل رایجترین خطاهای درگاه پرداخت می پردازیم، علل اصلی هر خطا را توضیح میدهیم و راه حلهای عملی برای رفع فوری آنها ارائه میکنیم. هدف ما این است که با ارائه اطلاعات دقیق و کاربردی، به شما کمک کنیم تا تجربه پرداخت روان تری را برای مشتریان خود فراهم کنید و در نهایت، به افزایش رضایت مشتری و رشد کسب و کارتان کمک کنید.
پیغامهای رایج در خطاهای درگاه پرداخت
در فرآیند پرداخت آنلاین، ممکن است با انواع مختلفی از پیامهای خطا مواجه شوید. این پیغامها معمولاً کدهای خاصی دارند که هر کدام نشان دهنده مشکل خاصی هستند. درک این کدها و پیامها، اولین قدم برای تشخیص و رفع مشکل است. در ادامه به بررسی مهمترین و رایجترین خطاهای درگاه پرداخت میپردازیم:
خطاهای مربوط به اطلاعات کارت بانکی
- خطای «اطلاعات کارت نامعتبر است» یا «Invalid Card Information»:
- علت: معمولاً به دلیل اشتباه در وارد کردن شماره کارت، تاریخ انقضا، CVV2 یا رمز دوم رخ می دهد. ممکن است کارت منقضی شده باشد یا اطلاعات به درستی خوانده نشوند.
- راه حل: از مشتری بخواهید اطلاعات کارت را با دقت مجدد بررسی کند. اطمینان حاصل کند که تاریخ انقضا صحیح است و CVV2 را به درستی وارد کرده است. همچنین، بررسی کند که آیا رمز دوم پویا (یکبار مصرف) را به درستی وارد کرده است یا خیر.
- خطای «کارت پیدا نشد» یا «Card Not Found»:
- علت: این خطا کمتر رایج است و معمولاً به مشکلات فنی موقتی در سیستم بانکی یا درگاه پرداخت اشاره دارد.
- راه حل: از مشتری بخواهید چند دقیقه صبر کند و مجدداً تلاش کند. در صورت تکرار، ممکن است لازم باشد با پشتیبانی درگاه پرداخت یا بانک صادرکننده کارت تماس بگیرد.
خطاهای مربوط به موجودی حساب یا محدودیت های بانکی
- خطای «موجودی کافی نیست» یا «Insufficient Funds»:
- علت: حساب بانکی مشتری برای انجام تراکنش، موجودی کافی ندارد.
- راه حل: مشتری باید از کافی بودن موجودی حساب خود اطمینان حاصل کند یا از کارت بانکی دیگری استفاده کند.
- خطای «سقف مجاز تراکنش تجاوز شده است» یا «Transaction Limit Exceeded»:
- علت: مشتری سقف برداشت یا خرید روزانه/هفتگی/ماهانه تعیین شده توسط بانک خود را پر کرده است.
- راه حل: مشتری باید تا روز بعد صبر کند یا سقف تراکنش خود را از طریق بانک (اینترنت بانک، موبایل بانک یا مراجعه حضوری) افزایش دهد. همچنین میتواند از کارت بانکی دیگری استفاده کند.
- خطای «کارت مسدود است» یا «Card Blocked»
- علت: کارت بانکی مشتری به دلایل مختلفی مانند وارد کردن اشتباه رمز عبور چندین بار، گزارش سرقت یا مفقودی، یا تشخیص فعالیت مشکوک توسط بانک، مسدود شده است.
- راه حل: مشتری باید برای رفع انسداد کارت خود با بانک صادرکننده تماس بگیرد یا به شعبه مراجعه کند.
خطاهای مربوط به ارتباط و زیرساخت
- خطای «خطای سیستمی» یا «System Error»
- علت: این یک خطای عمومی است و می تواند دلایل متعددی داشته باشد، از جمله مشکلات موقتی در سرور درگاه پرداخت، شاپرک، یا سیستم بانکی.
- راه حل: ابتدا چند دقیقه صبر کرده و دوباره تلاش کنید. اگر مشکل ادامه داشت، ممکن است نیاز به پیگیری از سمت پشتیبانی درگاه پرداخت باشد. معمولاً این خطاها موقتی هستند.
- خطای «زمان اعتبار تراکنش به پایان رسید» یا «Transaction Timeout»
- علت: کاربر در زمان مقرر شده برای تکمیل فرآیند پرداخت (معمولاً چند دقیقه) تراکنش را نهایی نکرده است.
- راه حل: از مشتری بخواهید مجدداً اقدام به پرداخت کند و این بار در زمان کوتاه تری اطلاعات را وارد و تراکنش را تکمیل کند.
- خطای «ارتباط با درگاه پرداخت قطع شد» یا «Connection Interrupted»:
- علت: این خطا معمولاً به دلیل مشکلات اینترنتی کاربر، مشکلات در سرور درگاه پرداخت، یا ترافیک بالا در شبکه رخ می دهد.
- راه حل: از مشتری بخواهید اتصال اینترنت خود را بررسی کند. خودتان نیز می توانید وضعیت سرور درگاه پرداخت را از طریق پنل کاربری یا کانال های ارتباطی آن ها پیگیری کنید.
خطاهای امنیتی و تشخیص تقلب
درگاه های پرداخت سیستمهای امنیتی پیچیده ای برای جلوگیری از کلاهبرداری دارند و در صورت تشخیص فعالیت مشکوک، تراکنش را رد میکنند.
- خطای «تراکنش مشکوک» یا «Suspected Transaction»:
- علت: سیستم امنیتی درگاه پرداخت یا بانک، تراکنش را مشکوک تشخیص داده است. این میتواند به دلیل تلاش های مکرر با اطلاعات اشتباه، استفاده از VPN، یا الگوی خرید غیرعادی باشد.
- راه حل: مشتری باید با بانک خود تماس بگیرد تا دلیل مسدود شدن تراکنش را جویا شود. گاهی اوقات صرفاً یک تماس تلفنی برای تایید هویت کافی است.
- خطای IP» نامعتبر» یا «Invalid IP»:
- علت: این خطا کمتر مربوط به کاربر است و بیشتر به پیکربندی وب سایت شما یا درگاه پرداخت مربوط می شود. اگر آی پی سرور شما در لیست مجاز درگاه پرداخت نباشد، این خطا رخ میدهد.
- راه حل: با پشتیبانی درگاه پرداخت خود تماس بگیرید و از آن ها بخواهید آی پی سرور شما را در لیست سفید (Whitelist) قرار دهند.
رفع مشکل اتصال به درگاه پرداخت
گاهی اوقات، مشکل فراتر از خطاهای تراکنشی است و به عدم اتصال صحیح وبسایت شما به درگاه پرداخت مربوط میشود. این موضوع میتواند ناشی از پیکربندی نادرست یا مشکلات فنی باشد.
بررسی وضعیت نماد اعتماد الکترونیکی (اینماد)
• اهمیت: اینماد برای تمام وب سایتهای فروشگاهی در ایران اجباری است و درگاه های پرداخت بدون وجود این نماد، خدمات ارائه نمیدهند.
• بررسی: مطمئن شوید که نماد اعتماد الکترونیکی وب سایت شما معتبر و فعال است و در صفحات وب سایت شما نمایش داده میشود. عدم وجود یا غیرفعال بودن اینماد، مانع از دریافت درگاه پرداخت میشود.
پیکربندی افزونه یا ماژول درگاه پرداخت
• اهمیت: اگر از سیستم های مدیریت محتوا (CMS) مانند وردپرس، جوملا یا پرستاشاپ استفاده میکنید، برای اتصال به درگاه پرداخت نیاز به نصب افزونه یا ماژول مربوطه دارید. پیکربندی نادرست این افزونه ها یکی از دلایل اصلی مشکلات اتصال است.
• بررسی و رفع:
◦ نصب صحیح
◦ کلیدهای API و Merchant ID
◦ بررسی مستندات
◦ بروزرسانی
مشکلات فایروال و امنیت سرور
• اهمیت: گاهی اوقات تنظیمات فایروال سرور شما یا محدودیتهای امنیتی می توانند مانع از ارتباط صحیح با سرورهای درگاه پرداخت شوند.
• بررسی و رفع:
◦ اگر سرور اختصاصی یا VPS دارید، تنظیمات فایروال را بررسی کنید و مطمئن شوید که پورتهای مورد نیاز برای برقراری ارتباط با درگاه پرداخت باز هستند.
◦ اگر از هاست اشتراکی استفاده میکنید، با پشتیبانی هاستینگ خود تماس بگیرید و مشکل را مطرح کنید. آن ها می توانند بررسی کنند که آیا سرور شما محدودیتی برای اتصال به درگاه پرداخت دارد یا خیر.
کش (Cache) و مسائل مربوط به مرورگر
• اهمیت: گاهی اوقات اطلاعات کش شده در مرورگر یا در وب سایت شما می تواند باعث مشکلات موقتی در بارگذاری صحیح درگاه پرداخت شود.
• بررسی و رفع:
◦ پاک کردن کش مرورگر
◦ پاک کردن کش وب سایت
ارورهای پیشرفته درگاه پرداخت و راه حلها
علاوه بر خطاهای رایج، برخی ارورها پیچیده تر هستند و نیاز به بررسی دقیقتری دارند.
خطاهای مربوط به callback URL (آدرس بازگشت)
• علت: پس از اتمام فرآیند پرداخت در صفحه درگاه، کاربر به یک آدرس مشخص (callback URL) در وب سایت شما برمیگردد. اگر این آدرس به درستی پیکربندی نشده باشد یا در وب سایت شما وجود نداشته باشد، با خطا مواجه میشوید.
• راه حل:
◦ صحت آدرس
◦ کدنویسی
◦ خطای 404 یا 500 در callback
خطاهای تایید نشدن پرداخت (Verification Failure)
• علت: پس از پرداخت موفق در درگاه، برای اطمینان از صحت تراکنش و جلوگیری از تقلب، لازم است که وضعیت پرداخت را از طریق API درگاه پرداخت (عملیات وریفای – Verify) استعلام کنید. اگر این مرحله به درستی انجام نشود یا پاسخ مناسبی دریافت نشود، تراکنش ناتمام می ماند.
• راه حل:
◦ بررسی لاگها: لاگهای مربوط به ارتباط با درگاه پرداخت در وبسایت خود را بررسی کنید. آیا درخواست Verify به درستی ارسال میشود؟ آیا پاسخی دریافت میکنید؟
◦ کدنویسی تابع Verify: مطمئن شوید که تابع Verify در کدنویسی شما به درستی پیاده سازی شده است و تمام پارامترهای لازم را به درگاه پرداخت ارسال میکند.
◦ مشکل در ارتباط سرور به سرور: این مرحله یک ارتباط سرور به سرور است. مطمئن شوید که سرور شما می تواند به سرورهای درگاه پرداخت درخواست ارسال کند و پاسخ دریافت کند (گاهی فایروال یا محدودیت های شبکه مانع این ارتباط می شوند).
مشکلات مربوط به گیت وی (Gateway) و شاپرک
• اهمیت: تمامی تراکنشهای بانکی در ایران از طریق سامانه شاپرک انجام می شوند. گاهی مشکلات از سمت شاپرک یا سوئیچینگ بین درگاه پرداخت و شاپرک است.
• تشخیص و راه حل:
◦ معمولاً این خطاها عمومی هستند و با پیام «خطای سیستمی» یا کد خطای عمومی نمایش داده می شوند.
◦ در این موارد، معمولاً کاری از دست شما برنمی آید و باید منتظر بمانید تا مشکل از سمت درگاه پرداخت یا شاپرک حل شود.
◦ با این حال، میتوانید از طریق پشتیبانی درگاه پرداخت خود پیگیری کنید و وضعیت را جویا شوید. آنها میتوانند اطلاعات دقیقتری در مورد علت خطا ارائه دهند.
خطاهای مربوط به تغییر در API درگاه پرداخت
• علت: شرکت های ارائه دهنده درگاه پرداخت ممکن است APIهای خود را بروزرسانی کنند. اگر افزونه یا کدنویسی شما با نسخه جدید API سازگار نباشد، خطاهای مختلفی رخ میدهد.
• راه حل:
◦ بروزرسانی مداوم
◦ بررسی مستندات
خیر، این خطا میتواند به دلیل مشکلات فنی در درگاه پرداخت، شاپرک یا حتی تنظیمات نادرست وب سایت شما نیز رخ دهد. این مشکل معمولاً به دلیل عدم انجام صحیح مرحله وریفای (تایید تراکنش) پس از بازگشت از درگاه پرداخت است که باعث میشود سیستم فروشگاهی شما از موفقیت تراکنش مطلع نشود. بله، استفاده از VPN میتواند منجر به تشخیص تراکنش به عنوان مشکوک یا ایجاد مشکل در ارتباط با سرورهای درگاه پرداخت و بانک شود. برخی درگاههای پرداخت کانالهای تلگرام یا صفحات وضعیت (Status Page) برای اطلاع رسانی در مورد قطعیها و مشکلات دارند. همچنین میتوانید با پشتیبانی آنها تماس بگیرید. در برخی موارد بله، قطع شدن اتصال اینترنت مشتری در حین فرآیند پرداخت میتواند منجر به خطای «زمان اعتبار تراکنش به پایان رسید» یا «ارتباط قطع شد» شود.سوالات متداول
آیا خطای «تراکنش ناموفق» همیشه به معنی مشکل در حساب مشتری است؟
چرا گاهی پرداخت موفق می شود اما محصول برای مشتری ارسال نمیشود؟
آیا استفاده از فیلترشکن (VPN) باعث خطای درگاه پرداخت میشود؟
چگونه میتوانم وضعیت درگاه پرداخت را لحظه ای بررسی کنم؟
آیا خطاهای درگاه پرداخت به دلیل ضعف اینترنت مشتری است؟