HSRCPAY Dökümantasyon

Request Trace ve İzlenebilirlik

İstekten işleme kadar request id, trace id ve operasyonel takip yaklaşımı.

Ödeme akışında izlenebilirlik, teknik hata çözüm süresini doğrudan etkiler.

Kimlik zinciri

Her istek için iki ayrı izleme kimliği kullanılması önerilir:

  • Request ID: tek HTTP isteğini temsil eder.
  • Trace ID: birden fazla adım/servis boyunca akışı birleştirir.

Uçtan uca takip modeli

  1. İstek girişinde kimlikler üretilir veya devralınır.
  2. Yanıtta istemciye geri döndürülür (ör. request/trace header'ları).
  3. İşlem kayıtlarına (routing plan, charge, olay vb.) iliştirilir.
  4. Dashboard ve log aramalarında aynı kimliklerle korelasyon yapılır.

Routing ve ödeme bağlamı

Routing plan kararları request/trace bağlamıyla saklanırsa:

  • Hangi adayın neden seçildiği
  • Hangi denemenin neden başarısız olduğu
  • Hangi callback/webhook’un aynı işlemle ilişkili olduğu

daha hızlı anlaşılır.

Operasyonel öneriler

  • Tüm hata loglarına request ve trace alanı ekle.
  • Uygulama ve gateway callback katmanlarında aynı trace zincirini koru.
  • Alarm sisteminde trace kimliğini ilk sınıf alan olarak taşı.

On this page