> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Hata yönetimi

> HTTP kodunu, iş sonucunu ve mali kesinliği birlikte değerlendirin; belirsiz sonucu körlemesine tekrarlamayın.

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.

```json theme={null}
{
  "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

1. Aynı iş için yeni bir istek başlatmayı durdurun; yeni anahtar üretmeyin.
2. Varsa işlem kimliğiyle [durumu okuyun](/api-reference/islem-takibi/muhasip-get-apps-operations-operationid).
3. `result` içindeki güvenli kimliklerle ilgili belge, ödeme veya siparişi kontrol edin.
4. `review_required`, `dispatching` veya `provider_accepted` sonucunu otomatik tekrar izni saymayın.
5. 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ı](/rehberler/islem-takibi)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.