پرش به محتوای اصلی
مدیریت دانشبهسازان ملت
دانش فنی و تخصصیدستورالعملمنتشرشدهداخلی

دستورالعمل بررسی خطاهای ارتباطی سرویس‌های پرداخت

تاریخ انتشار
۱۸ مرداد ۱۴۰۵
آخرین به‌روزرسانی
۷ آبان ۱۴۰۵
زمان مطالعه
۱۱ دقیقه
بازدید
۲٬۳۱۰
پیشنهاد اصلاح

خلاصه مدیریتی

روال گام‌به‌گام شناسایی، دسته‌بندی و رفع خطاهای ارتباطی میان سرویس‌های پرداخت، سوئیچ و شبکه شاپرک؛ همراه با کدهای خطای رایج و مسیر تشدید به تیم‌های مسئول.

هدف و دامنه کاربرد

کاهش زمان تشخیص و رفع خطاهای ارتباطی سرویس‌های پرداخت و جلوگیری از ارجاع‌های نادرست میان تیم‌ها.

دامنه کاربرد

این دستورالعمل برای پشتیبانی سطح دو، تیم توسعه سرویس‌های پرداخت و کارشناسان شیفت مرکز عملیات شبکه کاربرد دارد و ارتباط با سوئیچ داخلی، شاپرک و شبکه شتاب را پوشش می‌دهد.

پیش‌نیازها

  • دسترسی خواندنی به داشبوردهای پایش سرویس‌های پرداخت
  • دسترسی به سامانه جست‌وجوی لاگ
  • آشنایی با کدهای پاسخ استاندارد ISO 8583

شرح دانش

دسته‌بندی خطاهای ارتباطی

پیش از هر اقدام، نوع خطا را مشخص کنید؛ بیشتر ارجاع‌های نادرست از اشتباه گرفتن خطای شبکه با خطای کسب‌وکار ناشی می‌شود.

  • خطای اتصال: پاسخ‌نگرفتن در سطح TCP یا TLS، معمولاً مرتبط با شبکه یا گواهی
  • Timeout: اتصال برقرار است اما پاسخ در زمان مقرر نمی‌رسد
  • پاسخ نامعتبر: قالب پیام یا امضای دیجیتال پاسخ صحیح نیست
  • خطای کسب‌وکار: پاسخ معتبر با کد رد تراکنش؛ این مورد خطای ارتباطی نیست

مسیر تشدید

اگر خطای اتصال یا Timeout بیش از ۵ دقیقه ادامه یابد یا نرخ خطا از ۲ درصد کل تراکنش‌ها بیشتر شود، موضوع به‌عنوان رخداد اولویت یک ثبت و به مرکز عملیات شبکه و راهبر فنی تیم پرداخت اطلاع داده می‌شود.

مراحل اجرا

  1. ۱

    بررسی داشبورد سلامت

    نرخ خطا، زمان پاسخ و وضعیت اتصال به هر مقصد را در داشبورد سلامت پرداخت بررسی کنید تا دامنه اختلال مشخص شود.

  2. ۲

    ردیابی تراکنش نمونه

    با شناسه رهگیری یک تراکنش ناموفق، مسیر آن را در لاگ سرویس‌ها دنبال کنید و آخرین نقطه موفق را بیابید.

  3. ۳

    تفکیک نوع خطا

    بر اساس دسته‌بندی بالا، نوع خطا را تعیین و در تیکت رخداد ثبت کنید.

  4. ۴

    اقدام اصلاحی یا ارجاع

    برای خطاهای شناخته‌شده راهکار بخش خطاهای رایج را اجرا کنید؛ در غیر این صورت طبق مسیر تشدید ارجاع دهید.

  5. ۵

    ثبت درس‌آموخته

    پس از رفع اختلال، علت ریشه‌ای و راهکار را در صفحه گزارش رخداد ثبت کنید تا این دستورالعمل به‌روز بماند.

تصاویر و نمودارها

مسیر تراکنش پرداخت تا شبکه شاپرک
  1. ۱درگاه پرداختدریافت درخواست
  2. ۲سرویس پرداختاعتبارسنجی و ثبت
  3. ۳سوئیچ داخلیمسیریابی پیام
  4. ۴شاپرکتأیید نهایی
شکل ۱: نقاط احتمالی بروز خطای ارتباطی در مسیر تراکنش پرداخت.

نکات تخصصی

زمان سرورها را همیشه با NTP همگام نگه دارید؛ اختلاف زمانی چندثانیه‌ای می‌تواند به رد امضای پیام‌ها و خطای پاسخ نامعتبر منجر شود.

پیش از راه‌اندازی مجدد هر سرویس، از وضعیت تراکنش‌های در جریان آن مطمئن شوید تا تراکنش نامشخص ایجاد نشود.

خطاهای رایج و راهکارها

راهکار:پیکربندی Connection Pool و زمان انتظار نسخه جدید را با نسخه قبلی مقایسه کنید؛ بیشتر موارد به تغییر ناخواسته همین مقادیر برمی‌گردد.

مستندات و منابع مرتبط

  • جدول کدهای پاسخ شاپرک و معادل داخلی

    Excel · ۸۶ کیلوبایت

    پیوست
  • قالب گزارش رخداد

    Word · ۳۲ کیلوبایت

    پیوست
  • چگونه خطای Timeout در فراخوانی سرویس‌های شاپرک را عیب‌یابی کنیم؟

    صفحه دانش

    مشاهده

آیا این محتوا مفید بود؟

۱۴۱ همکار این دانش را مفید دانسته‌اند.

پیشنهاد اصلاح محتوا

اطلاعاتی نادرست، قدیمی یا ناقص دیدید؟ به مالک دانش اطلاع دهید.

نظرات و بازخورد همکاران۱

    • حمید نوروزیکارشناس ارشد زیرساخت و پایش· ۸ آبان ۱۴۰۵

      در شیفت شب هفته گذشته با همین روال، خطای گواهی را در کمتر از ۲۰ دقیقه پیدا کردیم. مسیر تشدید حالا بسیار شفاف است.