رفع خطای درگاه پرداخت؛ دلایل، کدهای خطا و راهکارها
ایران پی مکس
درگاه‌های پرداخت اینترنتی ستون فقرات هر کسب‌وکار آنلاین موفقی هستند. اما گاهی اوقات، اتصال به این درگاه‌ها با چالش‌هایی روبرو میشود که میتواند منجر به از دست دادن فروش و نارضایتی مشتریان گردد. در این مقاله جامع، ما به بررسی دقیق دلایل رایج عدم اتصال به درگاه بانکی و ارائه راهکارهای عملی و گام به گام برای رفع مشکل اتصال به درگاه پرداخت خواهیم پرداخت. همچنین، به ویژگی‌های فنی درگاه ایران پی مکس اشاره می‌کنیم که به کاهش این مشکلات کمک میکند.
جدول کامل مشکل درگاه پرداخت
در ادامه لیستی از متداول‌ترین کدهای خطا در درگاه‌های پرداخت و راهکارهای پیشنهادی برای هر یک ارائه شده است.
| دسته خطا | کد خطا | شرح خطا | علت احتمالی | راهکار پیشنهادی |
|---|---|---|---|---|
| تنظیمات پذیرنده | -9 | خطای اعتبارسنجی اطلاعات | مرچنت‌کد، مبلغ، توضیحات یا callback نادرست | بررسی و اصلاح تنظیمات درگاه |
| تنظیمات پذیرنده | -10 | ترمینال یا IP نامعتبر | merchant_id یا IP اشتباه | اصلاح IP و مرچنت‌کد |
| تنظیمات پذیرنده | -11 | ترمینال غیرفعال است | فعال‌سازی انجام نشده | تماس با پشتیبانی |
| تنظیمات پذیرنده | -12 | تعداد درخواست بیش از حد مجاز | ارسال درخواست‌های پشت‌سرهم | صبر و ارسال مجدد |
| تنظیمات پذیرنده | -13 | محدودیت ترمینال | مدارک ناقص | تکمیل احراز هویت |
| تنظیمات پذیرنده | -14 | آدرس بازگشت نامعتبر | callback با دامنه ناهماهنگ | اصلاح callback URL |
| تنظیمات پذیرنده | -15 | درگاه تعلیق شده | بررسی امنیتی یا تخلف | پیگیری از پشتیبانی |
| تنظیمات پذیرنده | -16 | سطح کاربری نامعتبر | سطح کاربری پایین | ارتقای حساب |
| تنظیمات پذیرنده | -18 | referrer نامعتبر | استفاده در دامنه دیگر | اصلاح دامنه |
| درخواست پرداخت | -30 | عدم دسترسی به تسهیم | سرویس تسهیم فعال نیست | فعال‌سازی از پنل |
| درخواست پرداخت | -31 | حساب تسویه ثبت نشده | شبا ثبت نشده | افزودن شبا |
| درخواست پرداخت | -32 | مبلغ تسهیم بیش از کل | خطای محاسبه | اصلاح مبلغ |
| درخواست پرداخت | -36 | مبلغ کمتر از حد مجاز | کمتر از حداقل مجاز | افزایش مبلغ |
| درخواست پرداخت | -40 | پارامتر اضافی نامعتبر | expire_in اشتباه | اصلاح پارامتر |
| درخواست پرداخت | -41 | مبلغ بیش از سقف مجاز | بیشتر از حد مجاز | کاهش مبلغ |
| وریفای پرداخت | -50 | عدم تطابق مبلغ | مبلغ Verify اشتباه | بررسی مبلغ |
| وریفای پرداخت | -51 | پرداخت ناتمام | کاربر پرداخت را کامل نکرده | پرداخت مجدد |
| وریفای پرداخت | -54 | authority نامعتبر | درخواست اشتباه یا جعلی | ارسال authority صحیح |
| وریفای پرداخت | -55 | تراکنش یافت نشد | Verify اشتباه | بررسی لاگ |
| وریفای پرداخت | 101 | تراکنش موفق | عملیات با موفقیت انجام شده | — |
| ریورس پرداخت | -60 | عدم امکان ریورس | محدودیت بانکی | تماس با بانک |
| ریورس پرداخت | -61 | قبلاً ریورس شده | درخواست تکراری | بررسی وضعیت |
| ریورس پرداخت | -63 | زمان ریورس گذشته | بیش از بازه مجاز | غیرقابل انجام |
| کارت بانکی | — | اطلاعات کارت اشتباه | CVV2، رمز یا تاریخ نادرست | بررسی اطلاعات |
| کارت بانکی | — | موجودی کافی نیست | کمبود موجودی | افزایش موجودی |
| کارت بانکی | — | کارت مسدود شده | خطای امنیتی | تماس با بانک |
| سیستمی | — | خطای سیستمی | اختلال PSP یا شاپرک | تلاش مجدد |
| سیستمی | — | پایان زمان پرداخت | قطع ارتباط | پرداخت مجدد |
| امنیتی | — | تراکنش مشکوک | تشخیص شاپرک | تماس با بانک |
| عمومی | 101 | تراکنش ناموفق | خطا در انجام تراکنش | بررسی اطلاعات |
| عمومی | 102 | خطای سیستم | مشکل فنی عمومی | تلاش مجدد |
| عمومی | 105 | موجودی کافی نیست | کمبود موجودی | افزایش موجودی |
| عمومی | 107 | رمز اشتباه بیش از حد | مسدودی کارت | تماس با بانک |
| عمومی | 110 | تراکنش تکراری | قبلاً انجام شده | بررسی سفارش |
| عمومی | 112 | خطای ارتباط با PSP | مشکل ارتباطی | تماس با پشتیبانی |
علت مشکل درگاه پرداخت در هنگام اتصال چیست؟
درک ریشه‌ی مشکل، اولین قدم برای حل آن است. مشکلات اتصال به درگاه پرداخت میتواند از سه منبع اصلی نشأت بگیرد: سمت وبسایت (پذیرنده)، سمت درگاه پرداخت یا بانک، و سمت کاربر.
۱. مشکلات سمت وبسایت و سرور (پذیرنده)
این بخش بیشتر مرتبط با توسعه‌دهندگان وب و مدیران فروشگاه‌های اینترنتی است.
- پیکربندی نادرست درگاه پرداخت: اشتباه در وارد کردن API Key یا Secret Key در پنل وبسایت یا درگاه، یا عدم تطابق CallBack URL تعریف شده در پنل درگاه با آدرس واقعی وبسایت.
- مشکلات SSL و گواهینامه‌های امنیتی: منقضی شدن گواهینامه SSL وبسایت یا پیکربندی نادرست آن. عدم وجود گواهینامه SSL معتبر (وبسایت با HTTP به جای HTTPS) میتواند تراکنش را متوقف کند.
- خطاهای کدنویسی وبسایت: ایرادات در کدهای فراخوانی درگاه پرداخت (API Integration) یا استفاده از نسخه‌های قدیمی و ناسازگار API یا SDK درگاه پرداخت که منجر به مشکلات API درگاه پرداخت میشود.
برای اتصال صحیح درگاه پرداخت سایت خود میتوانید مقاله اتصال درگاه پرداخت به وردپرس (در تب جدید) را مطالعه نمایید.
۲. مشکلات سمت درگاه پرداخت و بانک
این مشکلات معمولاً از کنترل پذیرنده خارج است. با این حال، استفاده از راهکار هوشمند میتواند تأثیر قطعی موقت درگاه‌ها را کاهش دهد:
- اختلالات سیستمی درگاه پرداخت: قطعی موقت یا بروزرسانی‌های سیستمی در خود درگاه پرداخت.
- مزیت ایران پی مکس (تراکنش هوشمند): ایران پی مکس به عنوان یک راهکار هوشمند، با بررسی دقیق عملکرد و پایداری زیرساخت ۴ درگاه پرداخت، تراکنشها را به‌طور هوشمندانه به بهترین درگاه پرداخت اینترنتی (در تب جدید) هدایت میکند. این ویژگی میتواند بسیاری از مشکلات فنی موقتی ناشی از قطعی یک درگاه خاص را به‌طور خودکار رفع کند و نرخ تراکنشهای موفق را بالا ببرد.
- خطای شاپرک: مشکلات فنی در ارتباط بین درگاه پرداخت و شبکه بانکی (شاپرک) که معمولاً با کدهای خطای درگاه پرداخت عمومی مانند ۱۱۲ یا ۱۰۲ نشان داده میشود. در مقاله " شاپرک چیست (در تب جدید) " میتوانید در مورد این وب سایت مطالعه نمایید.
۳. مشکلات سمت کاربر (خریدار آنلاین)
این‌ها رایج‌ترین دلایلی هستند که کاربران با مشکل پرداخت اینترنتی مواجه می‌شوند.
مشکلات مربوط به کارت و حساب بانکی:
- موجودی ناکافی در درگاه پرداخت (کد ۱۰۵).
- وارد کردن اشتباه اطلاعات کارت (شماره کارت، رمز دوم، CVV2، تاریخ انقضا).
- محدودیت در سقف تراکنش روزانه.
مشکلات اینترنتی کاربر
سرعت پایین اینترنت، ناپایداری اتصال یا استفاده از VPN/فیلترشکن که ممکن است باعث اختلال در ارتباط با درگاه شود.
راهکارهای جامع برای رفع مشکل درگاه پرداخت
پس از شناسایی دلایل احتمالی، نوبت به ارائه راهکارهای عملی و مؤثر می‌رسد.
بررسی‌های اولیه و عیب‌یابی (برای پذیرنده)
1. بررسی لاگ‌های خطا (Error Logs): اولین گام، بررسی دقیق فایل‌های لاگ سرور (Error Log) و لاگ‌های درگاه پرداخت (در تب جدید) در پنل کاربری است.
2. تست با مرورگرهای مختلف: از کاربران بخواهید با مرورگرهای دیگر یا در حالت ناشناس (Incognito Mode) تلاش کنند تا مشکلات مربوط به کش و کوکی‌ها رفع شود.
3. اطمینان از به‌روز بودن سیستم‌ها: تمامی افزونه‌ها، قالب‌ها و هسته سیستم مدیریت محتوای خود را به آخرین نسخه پایدار به‌روزرسانی کنید.
4. نکته مهم برای پذیرندگان ایران پی مکس (کنترل فعالیت): ایران پی مکس میتواند هر زمان که به فعالیت کاربر یا پذیرنده‌ای مشکوک باشد، حساب کاربری وی را غیرفعال و مدارک بیشتری درخواست نماید. اگر با خطاهای غیرمنتظره مواجه شدید، پنل کاربری خود را بررسی کنید، زیرا ممکن است حساب شما موقتاً غیرفعال شده باشد.
رفع خطاهای مربوط به پیکربندی
- بررسی و تصحیح API Key، Secret Key و CallBack URL: اطمینان حاصل کنید که تمامی این اطلاعات در پنل وبسایت و همچنین در پنل کاربری درگاه پرداخت شما به صورت دقیق و بدون هیچ‌گونه اشتباه تایپی وارد شده و با یکدیگر مطابقت دارند.
- بازبینی تنظیمات SSL: از معتبر بودن و منقضی نشدن گواهینامه SSL وبسایت خود مطمئن شوید و همیشه از پروتکل HTTPS استفاده کنید.
راهکارهای مربوط به کارت و حساب بانکی (برای کاربر)
1. اطمینان از موجودی کافی: قبل از انجام تراکنش، از کافی بودن موجودی حساب بانکی اطمینان حاصل کنید.
2. استفاده صحیح از رمز دوم پویا: اطمینان حاصل کنید که رمز دوم پویا را به درستی و در زمان مقرر وارد می‌کنید.
تماس با پشتیبانی و ملاحظات تسویه حساب
در صورتی که مشکل حل نشد، با پشتیبانی درگاه پرداخت تماس بگیرید.
- نکته تسویه حساب ایران پی مکس: درگاه پرداخت اینترنتی ایران پی مکس میتواند با توجه به سابقه عضویت و تعداد شکایات، سرعت تسویه حساب با پذیرنده را از دوبار در روز تا ۷۲ ساعت یکبار تغییر دهد. اگر مشکل شما مربوط به زمان واریز وجه است، این مسئله به سابقه فعالیت شما بستگی دارد.
- رسیدگی به اختلاف (ایران پی مکس): اگر تراکنش ناموفق منجر به اختلاف شد، ایران پی مکس تلاش میکند با ایجاد محیط گفتگو بین خریدار و فروشنده، موضوع را حل و فصل نماید.
برای آشنایی با نحوه انتقال مالی در درگاه پرداخت مقاله " درگاه پرداخت چگونه کار میکند (در تب جدید) " را مطالعه نمایید.
نتیجه گیری
رفع مشکل اتصال به درگاه پرداخت نیازمند یک رویکرد سیستماتیک و گام به گام است. با درک دلایل رایج بروز این مشکلات، استفاده از راهکارهای عیب‌یابی مناسب و رعایت نکات امنیتی برای تشخیص درگاه بانکی اصلی، میتوانید تجربه‌ای روان و امن را برای مشتریان خود فراهم آورید و از از دست رفتن فرصت‌های فروش جلوگیری کنید. استفاده از درگاهی مانند ایران پی مکس با قابلیت تراکنش هوشمند، ریسک عدم اتصال ناشی از مشکلات فنی موقتی در شبکه بانکی را به حداقل می‌رساند.
