خلاصه مدیریتی
پاسخ تیم پرداخت به یکی از پرتکرارترین پرسش‌های توسعه‌دهندگان: تفکیک Timeout شبکه از تأخیر پردازش، تنظیم درست زمان‌های انتظار و رفتار صحیح در برابر پاسخ‌های نامشخص.
هدف و دامنه کاربرد
پاسخ به این پرسش که چرا فراخوانی سرویس‌های شاپرک با خطای Timeout مواجه می‌شود و توسعه‌دهنده چگونه باید آن را عیب‌یابی و مدیریت کند.
دامنه کاربرد
سرویس‌هایی که به‌طور مستقیم یا از طریق سوئیچ داخلی با شاپرک ارتباط دارند.
پیش‌نیازها
- دسترسی به لاگ سرویس‌ها
- آشنایی با دستورالعمل بررسی خطاهای ارتباطی سرویس‌های پرداخت
شرح دانش
پاسخ کوتاه
بیشتر Timeoutها از تنظیم نادرست زمان انتظار در سمت سرویس‌های ما ناشی می‌شوند، نه کندی شاپرک. زمان انتظار هر لایه باید از لایه بالاتر کوتاه‌تر باشد تا پاسخ دیرهنگام، تراکنش نامشخص ایجاد نکند.
تفکیک Timeout شبکه از تأخیر پردازش
اگر اتصال برقرار نشود، خطا در لایه شبکه است و باید به تیم زیرساخت ارجاع شود. اگر اتصال برقرار شده اما پاسخ دیر برسد، با شناسه رهگیری زمان هر مرحله را در لاگ بررسی کنید تا گلوگاه مشخص شود.
مراحل اجرا
- ۱
یافتن شناسه رهگیری
شناسه رهگیری تراکنش ناموفق را از لاگ سرویس یا گزارش پشتیبانی بیابید.
- ۲
مقایسه زمان‌ها
زمان ارسال درخواست و زمان ثبت Timeout را در لاگ سوئیچ و سرویس مقایسه کنید.
- ۳
بررسی پیکربندی
زمان انتظار اتصال و خواندن را با مقادیر مصوب جدول پیکربندی مقایسه کنید.
- ۴
استعلام وضعیت
برای تراکنش‌های با وضعیت نامشخص، پیش از هر اقدام از سرویس استعلام وضعیت استفاده کنید.
نکات تخصصی
مقدار مصوب زمان انتظار خواندن برای سرویس‌های خرید ۴۵ ثانیه و برای استعلام‌ها ۱۰ ثانیه است.
تلاش مجدد خودکار فقط برای عملیات استعلام مجاز است، نه برای ثبت تراکنش.
خطاهای رایج و راهکارها
مستندات و منابع مرتبط
- پیوست
جدول مقادیر مصوب زمان انتظار
Excel · ۱۸ کیلوبایت
- مشاهده
دستورالعمل بررسی خطاهای ارتباطی سرویس‌های پرداخت
صفحه دانش
نظرات و بازخورد همکاران۱
جدول مقادیر زمان انتظار خیلی کمک کرد. در همراه‌بانک هم همین مقادیر را اعمال کردیم.