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

# Hata Yönetimi

Bir istek başarısız olduğunda Fincraft API JSON formatında hata bilgisi döner. Tam hata kodu listesi için [Hata Kodları](/fincraft/genel/hata-kodlari) sayfasını kullanın.

## Hata yanıt formatı

```json theme={null}
{
  "errorCode": "6005",
  "errorMessage": "Geçersiz CVV"
}
```

| Alan           | Açıklama                      |
| -------------- | ----------------------------- |
| `errorCode`    | Sayısal veya string hata kodu |
| `errorMessage` | Hatanın açıklaması            |

| Alan           | Açıklama                      |
| -------------- | ----------------------------- |
| `errorCode`    | Sayısal veya string hata kodu |
| `errorMessage` | Hatanın açıklaması            |

## HTTP durum kodları

| Durum                       | Açıklama                                  |
| --------------------------- | ----------------------------------------- |
| `200 OK`                    | İstek başarılı                            |
| `400 Bad Request`           | Geçersiz parametre veya validasyon hatası |
| `401 Unauthorized`          | Token eksik veya geçersiz                 |
| `403 Forbidden`             | Erişim reddedildi (ör. hata kodu `1003`)  |
| `404 Not Found`             | İstenen kayıt bulunamadı                  |
| `500 Internal Server Error` | Sunucu hatası                             |

## Yaygın hata kodları

### Validasyon

### Validasyon

| Kod    | Açıklama                                             |
| ------ | ---------------------------------------------------- |
| `6001` | Geçersiz istek                                       |
| `6002` | Geçersiz tutar — ürün toplamı `amount` ile eşleşmeli |
| `6003` | Geçersiz kart numarası                               |
| `6005` | Geçersiz CVV                                         |
| `6012` | Ürün `externalId` değerleri benzersiz olmalı         |

### Ödeme akışı

| Kod    | Açıklama                                 |
| ------ | ---------------------------------------- |
| `2004` | Ödeme işlemi bulunamadı                  |
| `2014` | İşlem zaten iptal/iade edilmiş           |
| `2015` | İşlem durumu iptal/iade için uygun değil |
| `7004` | Yinelenen işlem                          |

### Kimlik ve limit

| Kod    | Açıklama            |
| ------ | ------------------- |
| `1003` | Erişim reddedildi   |
| `7002` | Yetersiz bakiye     |
| `7003` | İşlem limiti aşıldı |

<CardGroup cols={2}>
  <Card title="Tüm Hata Kodları" icon="list" href="/fincraft/genel/hata-kodlari">
    Sistem ve banka hata kodlarının tam listesi.
  </Card>

  <Card title="Enumlar" icon="book" href="/fincraft/genel/enumlar">
    `PaymentStatus`, `TransactionType` ve diğer enum değerleri.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Tüm Hata Kodları" icon="list" href="/fincraft/genel/hata-kodlari">
    Sistem ve banka hata kodlarının tam listesi.
  </Card>

  <Card title="Enumlar" icon="book" href="/fincraft/genel/enumlar">
    `PaymentStatus`, `TransactionType` ve diğer enum değerleri.
  </Card>
</CardGroup>