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

# Hata Kodlarını Yönetme

> API isteklerinde karşılaşabileceğiniz hata kodları ve açıklamaları

<Note>
  Entegrasyon aşamasında bazı hata kodları ile karşılaşabilirsiniz. Bu hata kodları, API isteklerinizde oluşabilecek sorunları anlamanıza yardımcı olur.
</Note>

***

## Hata Kodları

| Kod   | Açıklama                                                                                                                      |
| :---- | :---------------------------------------------------------------------------------------------------------------------------- |
| 100   | Rate limit aşıldı. Lütfen bir süre bekleyip tekrar deneyin.                                                                   |
| 900   | Sistemsel hata oluştu. Lütfen destek ekibimizle iletişime geçiniz.                                                            |
| 901   | Doğrulama hataları oluştu.                                                                                                    |
| 902   | Tanınmayan URL. Lütfen API dokümantasyonunu kontrol ediniz.                                                                   |
| 1000  | Yetkisiz erişim.                                                                                                              |
| 1001  | Yetkisiz IP adresi.                                                                                                           |
| 1002  | Geçersiz ya da süresi dolmuş token.                                                                                           |
| 1003  | İstek formatı `application/json` ya da `application/x-www-form-urlencoded` olmalıdır.                                         |
| 1004  | Geçersiz veya eksik token. Lütfen Authorization header içerisinde geçerli bir secret key gönderdiğinizden emin olun.          |
| 1005  | Bu işlem için yetkiniz yok. Farklı bir API anahtarı kullanın.                                                                 |
| 1006  | Bu işlem için tanımlı yetkiniz bulunmamaktadır.                                                                               |
| 1100  | Kimlik doğrulama bilgileriniz (public/secret key) geçersiz.                                                                   |
| 1101  | Secret key geçersiz.                                                                                                          |
| 1200  | Token oluşturulurken teknik bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                        |
| 2000  | Ödeme işlemi sırasında bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                             |
| 2001  | Ödeme işlemi log bilgileri kaydedilirken bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                           |
| 2002  | Ödeme işlemi detay bilgileri güncellenirken bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                        |
| 2003  | Ödeme işlemi iptal edilirken bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                       |
| 2004  | Herhangi bir ödeme işlemi bulunamadı.                                                                                         |
| 2005  | Ödeme işlemi zaten özetlenmiş durumda.                                                                                        |
| 2006  | Ödeme işlemi henüz özetlenmemiş durumda.                                                                                      |
| 2020  | Ödeme işlemine ait finansal bilgiler bulunamadı.                                                                              |
| 2030  | Ödeme işlemi detay bilgileri bulunamadı.                                                                                      |
| 2040  | İade işlemi bulunamadı.                                                                                                       |
| 2100  | Ödeme işlemi oluşturulurken bir sorun oluştu. Lütfen destek ekibimizle iletişime geçin.                                       |
| 2101  | Ödeme sayfası oluşturulurken hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                           |
| 2102  | Ödeme sayfası güncellenirken hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                           |
| 2200  | Access ID bulunamadı.                                                                                                         |
| 2201  | Access ID süresi sona erdi.                                                                                                   |
| 2300  | Geçersiz kart numarası.                                                                                                       |
| 2301  | Banka bilgisi bulunamadı.                                                                                                     |
| 3000  | Ödeme sistemi ile bağlantı kurulurken bir hata oluştu.                                                                        |
| 3001  | Ödeme sistemi ile kimlik doğrulama sırasında bir hata oluştu.                                                                 |
| 3002  | Ödeme sistemine bağlantı zaman aşımına uğradı. Lütfen tekrar deneyin.                                                         |
| 3003  | Ödeme sisteminden geçersiz bir yanıt alındı. Lütfen destek ekibimizle iletişime geçin.                                        |
| 3004  | Ödeme işlemi ile ilgili bilinmeyen bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                 |
| 3005  | Ödeme işlemi ile ilgili beklenmeyen hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                    |
| 3006  | Ödeme sistemi entegrasyonu bulunamadı. Lütfen destek ekibimizle iletişime geçin.                                              |
| 3007  | Seçilen taksit seçeneği tanımlı POS için desteklenmiyor. Lütfen tek çekim olarak değiştirip tekrar deneyin.                   |
| 3008  | Seçilen ön provizyon (pre-auth) işlemi tanımlı POS için desteklenmiyor.                                                       |
| 3500  | Üye işyeri ön provizyon (pre-auth) işlemini desteklemiyor.                                                                    |
| 4000  | Üye işyerine henüz komisyon/taksit bilgisi tanımlanmadı.                                                                      |
| 4001  | Seçilen taksit seçeneği üye işyeri için desteklenmiyor.                                                                       |
| 5000  | 3D Ödeme yöntemi desteklenmiyor ya da tanımlı değil.                                                                          |
| 6000  | Günlük ödeme özeti bulunamadı.                                                                                                |
| 6001  | Günlük ödeme özeti log kaydı oluşturulurken bir hata oluştu.                                                                  |
| 6002  | Günlük ödeme özeti log kaydı bulunamadı.                                                                                      |
| 6003  | Günlük ödeme özeti oluşturulurken teknik bir hata oluştu.                                                                     |
| 6004  | Günlük ödeme özeti geri alma işlemi sırasında bir hata oluştu.                                                                |
| 6005  | Günlük ödeme özeti iade işlemi özetleme sırasında bir hata oluştu.                                                            |
| 6006  | Günlük ödeme özeti zaten ödenmiş durumda.                                                                                     |
| 7000  | Üye işyeri limit bilgisi tanımlanmadı.                                                                                        |
| 7001  | Günlük ödeme tutar limiti aşıldı.                                                                                             |
| 7002  | Günlük ödeme işlem sayısı limiti aşıldı.                                                                                      |
| 7003  | Non-3D işlemler için günlük ödeme tutar limiti aşıldı.                                                                        |
| 7004  | Non-3D işlemler için günlük işlem sayısı limiti aşıldı.                                                                       |
| 7005  | Aylık ödeme tutar limiti aşıldı.                                                                                              |
| 7006  | Non-3D işlemler için aylık ödeme tutar limiti aşıldı.                                                                         |
| 7007  | Tekil işlem için ödeme tutar limiti aşıldı.                                                                                   |
| 7008  | Non-3D tekil işlem için ödeme tutar limiti aşıldı.                                                                            |
| 7009  | Geçersiz ödeme yöntemi.                                                                                                       |
| 7010  | Aylık ödeme özeti bulunamadı.                                                                                                 |
| 7011  | Non-3D işlemler için aylık işlem sayısı limiti aşıldı.                                                                        |
| 7012  | Aylık işlem sayısı limiti aşıldı.                                                                                             |
| 7013  | Üye işyeri white label ödeme özelliğini desteklemiyor.                                                                        |
| 8000  | Üye işyeri şu anda işlem yapmaya kapalı. Lütfen daha sonra tekrar deneyiniz.                                                  |
| 8001  | Üye işyerine ait POS sistemi şu anda işlem yapmaya kapalı. Lütfen daha sonra tekrar deneyiniz.                                |
| 8002  | Bloklama işlemi sırasında bir sorun oluştu. Lütfen tekrar deneyiniz.                                                          |
| 9000  | Bu işlem için zaten bekleyen bir iade talebi mevcut. Mevcut iade işleminin tamamlanmasını bekleyin.                           |
| 9001  | İade edilebilir tutar, işlem tutarını aşmaktadır. Daha önce yapılan iade işlemlerini kontrol edin.                            |
| 9002  | İade işlemi oluşturulurken bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                         |
| 9003  | İşlem tutarının tamamı iade edilmiş durumda.                                                                                  |
| 9004  | İade edilebilir başarılı bir ödeme bulunamadı.                                                                                |
| 9100  | Bu işlem için zaten bekleyen bir itiraz talebi mevcut. Mevcut sürecin tamamlanmasını bekleyin.                                |
| 9101  | İtiraz tutarı, işlem tutarını aşmaktadır. Daha önce başlatılmış itiraz işlemlerini kontrol edin.                              |
| 9102  | İtiraz işlemi oluşturulurken bir hata oluştu. Lütfen destek ekibimizle iletişime geçin.                                       |
| 9103  | İşlem tutarının tamamı için itiraz başlatılmış durumda.                                                                       |
| 9104  | İtiraz oluşturulabilecek başarılı ödeme bulunamadı. Lütfen işlem numarasını ve ödeme durumunu kontrol edin.                   |
| 10000 | Güvenlik kontrolü sırasında gerekli parametreler eksik. Gönderilen veri manipüle edilmiş olabilir.                            |
| 10001 | Güvenlik kontrol parametreleri şifre çözme işlemi sırasında doğrulanamadı.                                                    |
| 10002 | Güvenlik kontrolünde kullanılan gizli anahtar (Secret Key) geçersiz.                                                          |
| 10003 | Fingerprint imza doğrulaması başarısız oldu. Veri bütünlüğü sağlanamıyor.                                                     |
| 10004 | Güvenlik kontrolü sırasında bir hata tespit edildi. Veri doğruluğunu kontrol edin.                                            |
| 10005 | Güvenlik kontrolü sırasında beklenmeyen bir hata oluştu. Teknik destekle iletişime geçin.                                     |
| 10006 | Geçersiz bir erişim kimliği (Access ID) tespit edildi.                                                                        |
| 10007 | Erişim kimliği (Access ID) doğrulanamadı.                                                                                     |
| 10008 | Erişim kimliği (Access ID) şifre çözme işlemi sırasında doğrulanamadı.                                                        |
| 10009 | İşlem kimliği (Transaction ID) doğrulanamadı.                                                                                 |
| 10010 | İşlem kimliği (Transaction ID) bulunamadı.                                                                                    |
| 10011 | Fingerprint doğrulama işlemi başarısız oldu. `fp_signature` ve `fp_request_id` geçerli değil.                                 |
| 10012 | Fingerprint verisi eksik. Lütfen fingerprint doğrulama bilgilerini kontrol edin.                                              |
| 10013 | Fingerprint JS tarafından bir hata bildirildi.                                                                                |
| 10014 | Webhook üzerinden fingerprint verisi alınamadı.                                                                               |
| 10015 | FingerprintJS servisinden veri alınırken bir hata oluştu.                                                                     |
| 10016 | Sisteme tanımlı güvenlik anahtarları bulunamadı.                                                                              |
| 10017 | Üye işyerine ait fraud tanımlamaları bulunamadı.                                                                              |
| 10018 | Üye işyerine ait fingerprint fraud politikası bulunamadı.                                                                     |
| 10019 | Şüpheli skor limiti aşıldı.                                                                                                   |
| 10020 | VPN bağlantısı tespit edildi.                                                                                                 |
| 10021 | Proxy kullanımı tespit edildi.                                                                                                |
| 10022 | Gizli mod kullanımı tespit edildi.                                                                                            |
| 10023 | 5 dakikalık işlem limiti aşıldı.                                                                                              |
| 10024 | Cihaz emülatörü tespit edildi.                                                                                                |
| 10025 | Jailbreak yapılmış cihaz tespit edildi.                                                                                       |
| 10026 | Sanal makine kullanımı tespit edildi.                                                                                         |
| 10027 | Cihaz manipülasyonu tespit edildi.                                                                                            |
| 10028 | Bot etkinliği tespit edildi.                                                                                                  |
| 10029 | Konum uyuşmazlığı tespit edildi.                                                                                              |
| 10030 | Tor ağı bağlantısı tespit edildi.                                                                                             |
| 10031 | Sahte kimlikli tarayıcı (anti-detect browser) tespit edildi.                                                                  |
| 10032 | Root yetkili cihaz tespit edildi.                                                                                             |
| 10033 | Frida hooking framework tespit edildi.                                                                                        |
| 10034 | Sahte konum (GPS spoofing) tespit edildi.                                                                                     |
| 10035 | Man-in-the-Middle (MitM) saldırısı tespit edildi.                                                                             |
| 10036 | IP adresi kara listede tespit edildi.                                                                                         |
| 10037 | Son 30 günde 3 veya daha fazla itiraz tespit edildiği için ödeme alınamıyor.                                                  |
| 10038 | Son 24 saatte 5 veya daha fazla başarısız ödeme tespit edildiği için ödeme alınamıyor.                                        |
| 10039 | Son 1 saatte aynı kart ile çok fazla işlem denemesi tespit edildi.                                                            |
| 10040 | Son 24 saatte aynı kart ile çok fazla işlem denemesi tespit edildi.                                                           |
| 10041 | Son 1 saatte aynı IP adresinden çok fazla işlem denemesi tespit edildi.                                                       |
| 11000 | İşlem sırasında beklenmeyen bir durum oluştu. Ödemenizin durumu kontrol ediliyor. Lütfen birkaç dakika içinde tekrar deneyin. |
| 11001 | Bu işlem güvenlik politikalarını ihlal ediyor. Lütfen destek ekibimizle iletişime geçin.                                      |
| 12000 | Bu e-posta adresi ile kayıtlı bir hesap zaten var.                                                                            |
| 12001 | Üye işyeri kaydı sırasında bir sorun oluştu. Lütfen destek ekibimizle iletişime geçin.                                        |
| 12002 | Üye işyeri kaydının güncellenmesi sırasında bir sorun oluştu. Lütfen destek ekibimizle iletişime geçin.                       |
| 13000 | Belirttiğiniz webhook URL adresi için bazı olaylar daha önce zaten tanımlanmış.                                               |
| 14000 | Hash değeri eksik. Lütfen parametreleri kontrol edin.                                                                         |
| 14001 | Hash değeri geçersiz. Lütfen parametreleri kontrol edin.                                                                      |
| 15000 | Ürün bulunamadı. Lütfen ürün bilgilerinizi kontrol edin.                                                                      |
| 15001 | Ürünlerin toplam tutarı ile ödeme tutarı uyuşmuyor.                                                                           |
