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