Hata yönetimi - Muhasip API

HTTP kodu, kaynak cevabı ve mali işlemin kesinliği ayrı bilgilerdir. 200 yanıtı ilgili kaynağın bütün alt adımlarının başarıyla tamamlandığı anlamına gelmeyebilir. Ağ kesintisi de işlemin yapılmadığını kanıtlamaz.

Durum	Yapılacak işlem
`400`	İstek alanını ve zorunlulukları düzeltin; aynı geçersiz isteği döngüyle göndermeyin.
`401` / `403`	Kimlik, firma, ürün, IP ve modül izinlerini kontrol edin.
`404`	Kimliği ve firma kapsamını doğrulayın; başka firmada kayıt aramayın.
`409`	İşlem durumu, hedef kilidi veya aynı anahtardaki içerik çatışmasını inceleyin. Yeni anahtar kilidi aşmaz.
`422`	Ret nedenini kontrol edin. Alanlar hatalıysa düzeltin; desteklenmeyen işlemi yeniden göndermeyin.
`429`	Varsa `Retry-After` bilgisini değerlendirin. Mali çağrıyı otomatik yeniden göndermeyin.
`502`	Belirsiz mali sonuç olabilir. Makbuzu ve belge/ödemeyi inceleyin; `retryable:false` ise yeniden göndermeyin.
`503`	Kayıt/hizmet erişimi sorunu olabilir. Varsa `operationId` ile mevcut işlemi araştırın.
JSON olmayan cevap / zaman aşımı	Yanıtın kesilmesini mali etkinin oluşmadığına kanıt saymayın.

Hata gövdeleri tek biçimli değildir

Bazı doğrulama hataları result:[{type,joiType,path,label}], diğerleri code/message alanları içerir. Ortak hız sınırı cevabında status boolean yerine sayısal 429 olabilir. 411, 412, 406 veya 407 gibi mevcut kodları da kaynak açıklamasıyla değerlendirin.

{
  "status": false,
  "code": "UPSTREAM_RESULT_UNCERTAIN",
  "message": "İşlem sonucunu durum adresinden kontrol ediniz.",
  "retryable": false
}

Örnek temsilîdir; her hata aynı alanları içermez. Hata yanıtında makbuz/işlem kimliği verilmişse saklayın. Gizli anahtarı, SMS kodunu ve ham belge içeriğini hata raporuna koymayın.

Mali sonuç belirsizse

Aynı iş için yeni bir istek başlatmayı durdurun; yeni anahtar üretmeyin.
Varsa işlem kimliğiyle durumu okuyun.
result içindeki güvenli kimliklerle ilgili belge, ödeme veya siparişi kontrol edin.
review_required, dispatching veya provider_accepted sonucunu otomatik tekrar izni saymayın.
Yalnız failed_before_dispatch ve uygun retryable:true koşulunda, aynı iş referansıyla kontrollü tekrar değerlendirin.

İşlem durumları ve tekrar koşulları