درگاهی که کار نمی‌کند، بدترین نوع خرابی سایت است — چون سایت بالاست، مشتری هست، و دقیقاً در لحظه‌ی پرداخت همه‌چیز متوقف میشود. بدتر از آن، حالتی است که پول کم میشود ولی سفارش ثبت نمی‌شود.
خبر خوب این است که تقریباً همه‌ی این خرابی‌ها یکی از چند علت مشخص دارند. این راهنما اول کمک میکند بفهمید در کدام دسته‌اید، بعد راه رفع همان را می‌دهد.
چهار نقطه‌ی توقف با چهار خانواده‌ی علت کاملاً متفاوت
دسته‌ی اول: به صفحهی بانک نمی‌رسید
۱. کلید یا شناسه‌ی درگاه اشتباه وارد شده
رایج‌ترین علت. یک فاصله‌ی اضافه در ابتدا یا انتهای کلید کافی است که اتصال برقرار نشود.
راه رفعکلید را از پنل پرداخت‌یار دوباره کپی کنید و مستقیم در تنظیمات افزونه بچسبانید. از تایپ دستی خودداری کنید و بعد از چسباندن، ابتدا و انتهایش را از فاصله‌ی اضافه پاک کنید.
۲. درگاه هنوز تایید نهایی نشده
گاهی اطلاعات اتصال داده میشود ولی درگاه هنوز در وضعیت بررسی است. در این حالت هر چه تنظیمات را عوض کنید فایده ندارد.
راه رفعوضعیت درگاه را در پنل ببینید. اگر «در انتظار تایید» است، مشکل از سایت شما نیست.
۳. حالت آزمایشی روشن مانده
اگر افزونه در حالت تست است، تراکنش واقعی انجام نمی‌شود — یا برعکس، حالت تست خاموش است ولی کلید تست وارد شده.
راه رفعحالت افزونه و نوع کلید باید با هم بخوانند: کلید واقعی با حالت عادی، کلید تست با حالت آزمایشی.
دسته‌ی دوم: به بانک می‌روید ولی خطا می‌گیرید
۴. دامنه‌ی ثبت‌شده با دامنه‌ی سایت نمی‌خواند
درگاه برای یک دامنه‌ی مشخص صادر میشود. اگر روی زیردامنه، دامنه‌ی دوم یا نسخهی آزمایشی تست کنید، بانک درخواست را رد میکند. همین موضوع در بازطراحی سایت هم پیش می‌آید.
راه رفعدامنه‌ی ثبت‌شده در پنل را با دامنه‌ای که کاربر واقعاً روی آن خرید میکند یکی کنید — از جمله وجود یا نبود www.
۵. مبلغ خارج از محدوده‌ی مجاز
برای تراکنش‌ها حداقل و گاهی حداکثر مبلغ تعریف میشود. سفارش با مبلغ صفر یا خیلی کم (مثلاً بعد از کد تخفیف صددرصدی) خطا می‌دهد.
راه رفعحداقل مبلغ سبد خرید را در فروشگاه تعریف کنید و برای سفارش‌های صفر ریالی، مسیر پرداخت را کلاً دور بزنید.
۶. واحد پول اشتباه
اگر فروشگاه به تومان کار کند و درگاه ریال بخواهد (یا برعکس)، مبلغ ده برابر یا یک‌دهم میشود. این خطا معمولاً با یک تراکنش واقعی فوراً لو می‌رود.
راه رفعواحد پول فروشگاه و تنظیم افزونه باید هماهنگ باشند. حتماً با یک خرید واقعی کم‌مبلغ تست بگیرید و مبلغ روی صفحهی بانک را با مبلغ سبد مقایسه کنید.
دسته‌ی سوم: پول کم شد ولی سفارش ثبت نشد
چرا این حالت از همه خطرناک‌تر استمشتری پول داده و سفارشی نمی‌بیند. اگر سریع رسیدگی نشود، هم اعتماد از دست می‌رود هم ممکن است به شکایت برسد. و چون سایت ظاهراً سالم است، معمولاً دیر متوجه می‌شوید — وقتی مشتری تماس می‌گیرد.
۷. صفحهی بازگشت نادرست
بعد از پرداخت، بانک کاربر را به آدرسی در سایت شما برمی‌گرداند تا سفارش نهایی شود. اگر این آدرس اشتباه باشد یا خطا بدهد، پرداخت انجام شده ولی سفارش ثبت نمی‌شود.
راه رفعآدرس بازگشت در پنل درگاه را با آدرسی که افزونه انتظار دارد یکی کنید. بعد از هر بازطراحی یا تغییر ساختار آدرسها، این را دوباره بررسی کنید.
۸. تداخل کش یا افزونه
افزونهی کش می‌تواند صفحهی بازگشت را نسخهی ذخیره‌شده تحویل دهد و فرایند نهایی‌سازی اجرا نشود. افزونه‌های بهینه‌ساز هم گاهی درخواست بازگشت را می‌شکنند.
راه رفعصفحه‌های سبد خرید، تسویه و بازگشت باید از کش مستثنا باشند. اگر بعد از نصب یک افزونهی تازه مشکل شروع شده، همان اول آن را بررسی کنید.
دسته‌ی چهارم: تسویه انجام نمی‌شود
۹. اطلاعات حساب ناقص یا ناهماهنگ
اگر شماره‌ی شبا اشتباه باشد، یا نام صاحب حساب با متقاضی درگاه یکی نباشد، تراکنش انجام میشود ولی تسویه معلق می‌ماند.
راه رفعشبا و نام صاحب حساب را در پنل بررسی کنید. نام صاحب حساب، مالک دامنه و متقاضی درگاه باید یک نفر باشند — همان قاعده‌ای که در راهنمای مالکیت دارایی‌های دیجیتال توضیح داده‌ایم.
جدول تشخیص سریع
نشانه
محتمل‌ترین علت
اول این را چک کنید
دکمه‌ی پرداخت هیچ کاری نمی‌کند
کلید اشتباه یا درگاه غیرفعال
کلید و وضعیت درگاه در پنل
خطای «درگاه معتبر نیست»
ناهماهنگی دامنه
دامنه‌ی ثبت‌شده با و بدون www
مبلغ روی صفحهی بانک غلط است
واحد پول ریال/تومان
تنظیم واحد پول افزونه
خطا فقط برای سفارش‌های کوچک
حداقل مبلغ تراکنش
حداقل مبلغ سبد خرید
پرداخت موفق، سفارش ثبت نشد
صفحهی بازگشت یا کش
آدرس بازگشت و استثنای کش
همه‌چیز درست، پول نمی‌آید
شبا یا نام صاحب حساب
اطلاعات حساب در پنل
دیروز کار میکرد، امروز نه
تغییر اخیر سایت یا افزونه
آخرین تغییری که انجام دادید
روش درست تست
پس از هر تغییر، این را انجام دهید
یک خرید واقعی با کمترین مبلغ ممکن، نه فقط محیط آزمایشی
مبلغ روی صفحهی بانک را با مبلغ سبد خرید مقایسه کنید
بعد از پرداخت، ببینید سفارش در پنل فروشگاه ثبت شده
ایمیل یا پیامک تایید سفارش را بررسی کنید
یک بار هم پرداخت را وسط کار لغو کنید و ببینید سایت درست برمیگردد
تراکنش را تا مرحله‌ی تسویه دنبال کنید
همین تست را روی موبایل هم تکرار کنید
تست با محیط آزمایشی کافی نیست. بیشتر خطاهای واقعی — واحد پول، صفحهی بازگشت، کش — فقط در تراکنش واقعی خودشان را نشان میدهند.
اگر می‌خواهید از اول درست راه بیفتد
بخش بزرگی از این خطاها وقتی پیش می‌آید که درگاه با عجله و بدون تست وصل شده باشد. اگر هنوز درگاه نگرفته‌اید یا می‌خواهید عوضش کنید، سرویسی را انتخاب کنید که افزونهی رسمی و پشتیبانی شبانه‌روزی داشته باشد — چون مشکل درگاه ساعت اداری نمی‌شناسد.
در پروژه‌های خودمان بیشتر از سیزپی استفاده می‌کنیم: پرداخت‌یار دارای مجوز بانک مرکزی، با افزونهی آماده برای ووکامرس، پشتیبانی ۲۴ ساعته و قابلیت تسهیم وجوه.
دریافت درگاه سیزپیثبت‌نام و آپلود مدارک کاملاً آنلاین است. شروع ثبت‌نام — این لینک معرف ماست و هزینه یا شرایطی برای شما تغییر نمی‌دهد.
اگر همین حالا درگاه از کار افتاده و فروش متوقف شده، به این ترتیب پیش بروید:
۱اول ببینید مشکل عمومی است یا فقط شماپنل درگاه را باز کنید؛ اگر اعلان قطعی سرویس هست، مشکل از سایت شما نیست و فقط باید منتظر بمانید.
۲آخرین تغییر را به یاد بیاوریدافزونه‌ی جدید؟ بهروزرسانی؟ تغییر قالب؟ تقریباً همیشه پاسخ همین‌جاست.
۳یک تراکنش واقعی کم‌مبلغ انجام دهیدو دقیقاً ببینید کجا متوقف می‌شوید — این جواب، دسته‌ی مشکل را مشخص میکند.
۴اگر افزونهی تازه‌ای نصب شده، موقتاً غیرفعالش کنیدو دوباره تست کنید. این ساده‌ترین راه تشخیص تداخل است.
۵کش را کامل پاک کنیدو در پنجره‌ی ناشناس تست بگیرید، نه در مرورگری که صفحهی قدیمی را دارد.
اگر فروشتان بالاست، درگاه دوم داشته باشیدفروشگاه‌های پرتراکنش معمولاً دو درگاه فعال نگه می‌دارند. وقتی یکی از کار می‌افتد، مشتری حتی متوجه نمی‌شود — به‌جای اینکه فروش چند ساعت قطع شود.
به مشتری‌ای که پولش کم شده چه بگویید
این بخش فنی نیست ولی از بخش فنی مهم‌تر است. نحوه‌ی برخورد شما تعیین میکند مشتری ناراضی میشود یا وفادار:
اول تراکنش را پیدا کنید، بعد تماس بگیریدبا شماره‌ی پیگیری تماس بگیرید، نه با «بررسی می‌کنیم». مشتری می‌خواهد بداند پولش گم نشده.
وضعیت واقعی را بگوییداگر تراکنش موفق بوده و فقط سفارش ثبت نشده، همین را بگویید و سفارش را دستی ثبت کنید.
اگر برگشت خودکار است، زمانش را بگوییدمبهم گذاشتن زمان، بیشتر از خود مشکل اعتماد را از بین میبرد.
خودتان پیش‌قدم شویداگر در پنل تراکنش بدون سفارش دیدید، پیش از اینکه مشتری تماس بگیرد شما تماس بگیرید. این یک مشکل را به یک تجربه‌ی مثبت تبدیل میکند.
تراکنش بدون سفارش را باید فعالانه پایش کنید، نه منتظر تماس مشتری بمانید. هفته‌ای یک بار پنل درگاه را با سفارش‌های فروشگاه تطبیق دهید.
اگر نمی‌خواهید این‌ها را خودتان پیگیری کنید، بررسی دوره‌ی درگاه جزو پشتیبانی سایت است — چون یک درگاه خراب که چند روز کسی متوجهش نشود، از هر خرابی دیگری گران‌تر تمام میشود.
خطاهای رایج و معنی‌شان
پیام‌های خطا معمولاً کلی‌اند، ولی الگویشان قابل تشخیص است:
چیزی که می‌بینید
معنای محتمل
اقدام
صفحهی سفید بعد از کلیک پرداخت
خطای سمت سایت یا تداخل افزونه
گزارش خطای سایت را ببینید؛ افزونه‌های اخیر را غیرفعال کنید
«اطلاعات پذیرنده نامعتبر است»
کلید اشتباه یا درگاه غیرفعال
کلید را دوباره از پنل کپی کنید
«آدرس بازگشت نامعتبر»
ناهماهنگی دامنه یا صفحهی بازگشت
دامنه و آدرس بازگشت را در پنل تطبیق دهید
«مبلغ نامعتبر»
واحد پول یا حداقل مبلغ
ریال/تومان و حداقل سبد خرید را بررسی کنید
برگشت به صفحهی اصلی بدون پیام
صفحهی بازگشت یا کش
استثنای کش و آدرس بازگشت
«تراکنش قبلاً انجام شده»
ارسال دوباره‌ی همان شناسه
معمولاً پرداخت موفق بوده؛ در پنل بررسی کنید
اگر سایت شما اختصاصی است، نه ووکامرس
در سایت کدنویسی‌شده، خطاها همان‌ها هستند ولی نقطه‌ی بررسی فرق میکند:
تایید تراکنش سمت سرورنهایی کردن سفارش باید بر اساس تایید سرور به سرور باشد، نه صرفاً بازگشت کاربر به صفحه. اگر فقط به بازگشت کاربر تکیه کنید، بستن پنجره یعنی سفارش گم‌شده.
ذخیره‌ی شناسه‌ی تراکنشپیش از فرستادن کاربر به بانک، سفارش را با وضعیت «در انتظار پرداخت» ثبت کنید تا هیچ پرداختی بی‌ردیف نماند.
جلوگیری از ثبت دوبارهاگر کاربر صفحهی بازگشت را رفرش کند، نباید سفارش دوم ثبت شود.
ثبت گزارش خطاپاسخ خام درگاه را ذخیره کنید؛ بدون آن، عیب‌یابی حدس زدن است.
در سایت اختصاصی، بیشتر مشکلات «پول کم شد ولی سفارش ثبت نشد» از همین یک اشتباه می‌آید: نهایی کردن سفارش فقط بر اساس بازگشت کاربر، نه تایید سرور.
چطور بفهمید مشکل از درگاه است یا از سایت
۱آیا فقط پرداخت مشکل دارد یا کل سایت؟اگر صفحه‌های دیگر هم کند یا خطادار هستند، مشکل عمومی‌تر است و باید اول آن را حل کنید.
۲آیا برای همه‌ی کاربران است یا بعضی؟اگر فقط بعضی کاربران، معمولاً مرورگر، کش یا کارت بانکی خاص است نه درگاه.
۳آیا فقط روی موبایل است؟مشکل قالب یا اسکریپت نسخهی موبایل، نه درگاه.
۴آیا فقط برای مبالغ خاص است؟حداقل یا حداکثر مبلغ تراکنش.
۵آیا از یک زمان مشخص شروع شده؟آخرین تغییر سایت را بررسی کنید؛ تقریباً همیشه همان است.
اگر سایتتان کلاً کند یا ناپایدار است، مشکل جای دیگری است — راهنمای تشخیص علت قطعی سایت نقطه‌ی شروع بهتری است.
تطبیق ماهانه — کاری که جلوی فاجعه را می‌گیرد
یک بار در ماه، فهرست تراکنش‌های موفق پنل درگاه را با سفارش‌های فروشگاه مقایسه کنید. هر تراکنشی که سفارش متناظر ندارد، یک مشتری است که پول داده و چیزی نگرفته.
۱فهرست تراکنش‌های موفق ماه را از پنل بگیریدمعمولاً خروجی فایل دارد.
۲فهرست سفارش‌های پرداخت‌شده را از فروشگاه بگیریدهمان بازه‌ی زمانی.
۳تعداد و مجموع مبلغ را مقایسه کنیداگر یکی نبود، مورد به مورد بررسی کنید.
۴هر اختلاف را پیگیری کنیدیا سفارش را دستی ثبت کنید یا مبلغ را برگردانید — و به مشتری خبر دهید.
این کار ماهی چند دقیقه وقت میبرد و تنها راه پیدا کردن تراکنش‌های بی‌سفارش است. بدون آن، فقط وقتی خبردار می‌شوید که مشتری عصبانی تماس بگیرد.
چه چیزی را خودتان می‌توانید و چه چیزی نه
مشکل
خودتان
نیاز به کمک
کلید اشتباه در افزونه
بله
—
حالت آزمایشی روشن مانده
بله
—
واحد پول ریال/تومان
بله
—
حداقل مبلغ سبد خرید
بله
—
صفحهی بازگشت نادرست
معمولاً بله، از پنل درگاه
اگر سایت اختصاصی است
استثنای کش
بسته به افزونه
اگر تنظیمات پیچیده است
ناهماهنگی دامنه
بله، از پنل درگاه
—
خطای سمت سرور
خیر
بله
سایت اختصاصی با خطای تایید تراکنش
خیر
بله — نیازمند بررسی کد
نکتهبیشتر موارد بالا در دسته‌ی «خودتان» هستند. پیش از تماس با هر کسی، فهرست دسته‌ی اول را یک بار بررسی کنید — احتمالاً همان‌جا حل میشود.
اگر بازطراحی یا انتقال در پیش دارید
درگاه را در فهرست کارهای پس از انتشار بگذارید
کلید درگاه در نصب جدید وارد شده
آدرس بازگشت در پنل با ساختار آدرس جدید می‌خواند
دامنه‌ی ثبت‌شده همان دامنه‌ی نهایی است، با یا بدون www
صفحه‌های سبد، تسویه و بازگشت از کش مستثنا شده‌اند
یک تراکنش واقعی کوچک انجام و تا تسویه دنبال شده
ایمیل و پیامک تایید سفارش تست شده
این یکی از رایج‌ترین چیزهایی است که بعد از بازطراحی میشکند و دیر فهمیده میشود. فهرست کامل کارهای پس از انتشار در راهنمای بازطراحی بدون از دست دادن رتبه آمده است.
سؤالات متداول
مشتری پول داده ولی سفارش ثبت نشده؛ پولش از بین رفته؟
معمولاً نه. تراکنش در پنل درگاه قابل پیگیری است و یا بهصورت خودکار برمیگردد یا قابل تایید دستی است. اول تراکنش را در پنل پیدا کنید، بعد با مشتری تماس بگیرید — این تماس، تفاوت بین مشتری ناراضی و مشتری وفادار است.
درگاه دیروز کار میکرد، امروز نه؛ چه شده؟
تقریباً همیشه چیزی عوض شده: افزونهی جدید، بهروزرسانی، تغییر آدرس صفحهها، یا انقضای درگاه. از آخرین تغییری که انجام دادهاید شروع کنید.
بعد از بازطراحی سایت درگاه از کار افتاد؛ طبیعی است؟
بله و رایج است. با تغییر ساختار آدرسها، صفحهی بازگشت معمولاً میشکند. این را در فهرست کارهای پس از انتشار بگذارید — همانطور که در راهنمای بازطراحی بدون از دست دادن رتبه گفتهایم.
درگاه روی کامپیوتر کار میکند ولی روی موبایل نه
معمولاً مشکل قالب یا اسکریپت در نسخهی موبایل است، نه خود درگاه. صفحهی تسویه را روی موبایل واقعی تست کنید نه فقط با کوچک کردن پنجره.
چند وقت یکبار باید درگاه را تست کنم؟
بعد از هر بهروزرسانی، هر تغییر قالب و هر نصب افزونهی جدید. اگر پشتیبانی سایت دارید، این جزو بررسیهای دورهای است.
میشود دو درگاه داشت تا اگر یکی خراب شد فروش قطع نشود؟
بله و برای فروشگاههای پرتراکنش پیشنهاد میشود. افزونهها معمولاً اجازهی فعال بودن چند درگاه همزمان را میدهند.
اگر فروشگاه‌تان هنوز راه نیفتاده یا فرایند خریدش کامل نیست، طراحی سایت فروشگاهی نقطه‌ی شروع است.
درگاهتان کار نمی‌کند؟بگویید کجا متوقف می‌شوید — علت را پیدا می‌کنیم، رفعش می‌کنیم و با تراکنش واقعی تست می‌گیریم. بررسی اولیه رایگان است.
