خطاهای رایج Callback و روش رفع آنها
راهنمای عیبیابی خطاهای مسیر بازگشت پرداخت و اطلاعرسانی تغییر Callback
چرا Callback اینقدر مهم است؟
در فرآیند پرداخت اینترنتی، پس از انجام موفق تراکنش، کاربر باید به آدرسی که از سوی پذیرنده تعریف شده است، بازگردانده شود. این آدرس با عنوان Callback URL شناخته میشود و نقش مهمی در تکمیل فرآیند پرداخت دارد. صحت عملکرد این مرحله، تأثیر مستقیمی بر تجربه کاربر و پایداری فرآیند پرداخت دارد.
Callback URL نامعتبر
علت: آدرس Callback ثبتشده در پنل اسنپپی با آدرسی که واقعاً در سایت شما برای بازگشت پرداخت تعریف شده، مطابقت ندارد.
- وارد پنل پذیرندگان اسنپپی شوید.
- بخش تنظیمات فنی یا اطلاعات درگاه را بررسی کنید.
- آدرس Callback را با آدرس دقیق صفحه بازگشت سایت خود مقایسه کنید.
- در صورت مغایرت، آدرس صحیح را ثبت کنید.
شماره موبایل با فرمت نادرست
علت: کاربر شماره موبایل را با فرمت اشتباه (مثلاً با صفر اول یا کد کشور اضافی) وارد کرده است. افزونه اسنپپی بهطور خودکار کد کشور 98+ را در نظر میگیرد.
- به کاربر آموزش دهید شماره موبایل را بدون صفر اول و بدون کد کشور وارد کند. مثلاً به جای
0912xxxxxxxیا+98912xxxxxxxفقط912xxxxxxxرا وارد کند. - در صورت توسعه اختصاصی، در سمت سرور ورودی کاربر را نرمالایز کنید (حذف صفر اول و کاراکترهای غیرعددی).
گواهی SSL نامعتبر یا عدم استفاده از HTTPS
علت: آدرس Callback یا صفحه بازگشت از پروتکل HTTP استفاده میکند، در حالی که درگاه اسنپپی نیاز به HTTPS دارد.
- اطمینان حاصل کنید سایت شما گواهی SSL فعال دارد (قفل سبز در نوار آدرس).
- آدرس Callback باید با
https://شروع شود، نهhttp://. - در صورت استفاده از CDN یا فایروال، تنظیمات را بررسی کنید تا ترافیک HTTPS قطع نشود.
IP سرور وایتلیست نشده است
علت: سرور اسنپپی سعی دارد نتیجه پرداخت را به Callback شما ارسال کند، اما IP سرور سایت شما در فایروال یا افزونه امنیتی مسدود شده است.
- لیست IPهای اسنپپی را در فایروال سرور یا افزونه امنیتی (مثل Wordfence) وایتلیست کنید.
- IPهای اصلی:
185.206.93.115,185.206.94.25,37.152.176.176,188.121.106.231
Timeout یا عدم پاسخگویی سرور
علت: سرور سایت شما دیر پاسخ میدهد یا به دلیل ترافیک بالا، نتوانسته درخواست Callback را پردازش کند.
- سرعت میزبانی خود را بهبود دهید (هاست قویتر، استفاده از Cache).
- بررسی کنید که صفحه Callback عملیات سنگین انجام ندهد – بهتر است پردازشهای سنگین را به صف (Queue) منتقل کنید.
- مطمئن شوید حداکثر زمان اجرای اسکریپت (max_execution_time) در سرور کافی است (حداقل ۳۰ ثانیه).
تغییر Callback و نحوه اطلاعرسانی رسمی
در برخی شرایط، به دلایل فنی یا تغییرات ساختاری، ممکن است پذیرنده نیاز به تغییر Callback خود داشته باشد. از آنجا که این آدرس از پیش در سیستم اسنپپی ثبت میشود، هرگونه تغییر بدون اطلاعرسانی صحیح میتواند منجر به اختلال در دریافت وضعیت تراکنشها شود.
دلایل نیاز به تغییر Callback
- تغییر ساختار سایت یا فرم پرداخت: آدرس قبلی دیگر پاسخگو نیست.
- انتقال سرویسها به سرور جدید یا دامنه دیگر: آدرس Callback قبلی معتبر نخواهد بود.
- بروزرسانیهای امنیتی یا تغییر در سیاستهای شرکت: نیاز به بهروزرسانی آدرس.
- اصلاح خطاهای واردشده در آدرس Callback قبلی: تصحیح آدرس نادرست ثبتشده.
روشهای رسمی اطلاعرسانی تغییر Callback
برای ثبت درخواست تغییر Callback، وارد بخش فرمهای درخواست پذیرندگان شوید. و از لیست فرم: تغییر آدرس بازگشت (Callback URL) را انتخاب کنید و درخواست خود را ثبت کنید.
وارد لینک زیر شوید و فرم را تکمیل کنید. لازم است نامه رسمی درخواست خود را در فرم بارگذاری نمایید.
🔗 ورود به فرم تغییر Callback (لینک در پنل پذیرندگان)
- آدرس Callback جدید باید از قبل فعال و در دسترس باشد.
- نام برند/شرکت دقیقاً مطابق با اطلاعات ثبتشده در اسنپپی باشد.
- در صورت استفاده از تیکت، شماره پیگیری را نزد خود نگه دارید.
- تیم فنی اسنپپی پس از بررسی درخواست، تغییر لازم را اعمال خواهد کرد.
سوالات متداول درباره خطاهای Callback
Callback URL آدرسی است که پس از انجام موفق تراکنش، اسنپپی درخواست بازگشتی را به آن ارسال میکند تا پذیرنده بتواند وضعیت نهایی تراکنش را دریافت کرده و اقدامات لازم (ثبت سفارش، تأیید پرداخت، ارائه خدمت) را انجام دهد. صحت عملکرد این مرحله تأثیر مستقیمی بر تجربه کاربر و پایداری فرآیند پرداخت دارد.
این خطا زمانی رخ میدهد که آدرس Callback ثبتشده در پنل اسنپپی با آدرسی که واقعاً در سایت شما برای بازگشت پرداخت تعریف شده مطابقت ندارد. برای رفع آن: وارد پنل پذیرندگان شوید، بخش تنظیمات فنی یا اطلاعات درگاه را بررسی کنید، آدرس Callback را با آدرس دقیق صفحه بازگشت سایت مقایسه و در صورت مغایرت، آدرس صحیح را ثبت کنید.
این خطا زمانی رخ میدهد که کاربر شماره موبایل را با فرمت اشتباه (با صفر اول یا کد کشور اضافی) وارد کرده است. افزونه اسنپپی بهطور خودکار کد کشور 98+ را در نظر میگیرد. راهحل: به کاربر آموزش دهید شماره را بدون صفر اول و بدون کد کشور وارد کند (مثلاً 912xxxxxxx). در توسعه اختصاصی، ورودی را در سمت سرور نرمالایز کنید.
درگاه اسنپپی نیاز به HTTPS دارد؛ بنابراین آدرس Callback و صفحه بازگشت باید با https:// شروع شوند، نه http://. اگر سایت شما گواهی SSL فعال نداشته باشد، خطای «محتوا فقط از طریق HTTPS مجاز است» یا «Mixed Content Warning» رخ میدهد. راهحل: فعالسازی گواهی SSL و اطمینان از اینکه CDN یا فایروال ترافیک HTTPS را قطع نمیکند.
سرور اسنپپی سعی میکند نتیجه پرداخت را به Callback شما ارسال کند، اما اگر IP سرور سایت شما در فایروال یا افزونه امنیتی مسدود شده باشد، خطای «IP address not allowed» رخ میدهد. راهحل: لیست IPهای اسنپپی (185.206.93.115، 185.206.94.25، 37.152.176.176، 188.121.106.231) را در فایروال یا افزونه امنیتی مثل Wordfence وایتلیست کنید.
خطای Timeout زمانی رخ میدهد که سرور سایت شما دیر پاسخ میدهد یا به دلیل ترافیک بالا نتوانسته درخواست Callback را پردازش کند. راهحل: سرعت میزبانی خود را بهبود دهید (هاست قویتر، استفاده از Cache)، مطمئن شوید صفحه Callback عملیات سنگین انجام نمیدهد (پردازشهای سنگین به صف منتقل شود)، و بررسی کنید که max_execution_time در سرور حداقل ۳۰ ثانیه باشد.
برای تغییر Callback باید از روشهای رسمی استفاده کنید: وارد بخش فرمهای درخواست پذیرندگان شوید و از لیست فرم، «تغییر آدرس بازگشت (Callback URL)» را انتخاب کنید و درخواست خود را ثبت نمایید. لازم است نامه رسمی درخواست خود را در فرم بارگذاری کنید. توجه: ایمیل و تماس تلفنی برای تغییر Callback پذیرفته نمیشود.
اگر تغییر Callback بدون اطلاع به اسنپپی انجام شود، نتیجه پرداخت به آدرس قبلی ارسال میشود و پذیرنده قادر به دریافت وضعیت صحیح تراکنش نخواهد بود. این موضوع میتواند منجر به اختلال در فرآیند ثبت سفارش و تأیید پرداخت شود. بنابراین پیش از هرگونه تغییر در ساختار سایت، دامنه یا تنظیمات فنی، مراتب تغییر Callback را بهصورت رسمی به اسنپپی اطلاع دهید.
جمعبندی
آدرس Callback یکی از حیاتیترین تنظیمات درگاه پرداخت است. خطاهای رایج شامل نامعتبر بودن آدرس، فرمت اشتباه شماره موبایل، نبود SSL، عدم وایتلیست IP و Timeout سرور میشوند. برای رفع هرکدام راهحلهای مشخصی ارائه شد.
در صورت نیاز به تغییر Callback، حتماً از روشهای رسمی (فرم پرسلاین یا تیکت پرتال) استفاده کنید و از نمونه فرم ارائهشده پیروی نمایید. هرگونه تغییر بدون اطلاعرسانی باعث اختلال در دریافت وضعیت تراکنشها خواهد شد.
