# Hata Kodları iyzico API'sine istek attığınızda ve iletmiş olduğunuz istekte veya ödemede hatalı olan noktalar varsa, iyzico size ilgili istekte veya ödemede bir hata olduğunu, ilgili hatanın numerik koduyla birlikte ilgili hatanın açıklamasını da iletir. İlgili hatanın numerik kodu `errorCode` değişkeninde, hatanın içeriğine dair mesaj ise `errorMessage` içerisinde size iletilir. Status parametresinin "failure" değerine sahip olmasıyla belirtilen bir hata oluştuğunda, iyzico ödeme API'si ilgili değişkenleri aşağıdaki gibi iletir. * **errorCode**: örneğin `10051` * **errorGroup**: örneğin `NOT_SUFFICIENT_FUNDS` * **errorName**: örneğin `Error` * **errorMessage**: örneğin `Kart limiti yetersiz, yetersiz bakiye` {% hint style="info" %} Bankaya bağlı olarak bazı anahtar/değer çiftleri yetersiz yanıt verebilir. {% endhint %} iyzico, hata kodlarını gruplara ayırmaktadır. [Banka Hata Kodları](#banka-hata-kodlari) 10000 ile başlarken, Kart Saklama Hata Mesajları 3000 ile başlamaktadır. {% hint style="info" %} 1 dakika içerisinde 5'ten fazla kez aynı hata ile karşılaşmanız durumunda hesap yöneticiniz ile veya adresi üzerinden destek ekibimiz ile iletişime geçebilirsiniz. {% endhint %} Aşağıdaki hata gruplarında, sık karşılaşılan hata mesajları yer almaktadır. Tüm hata kodlarının listesine ulaşmak için; {% file src="" %} Hata Mesajları ile ilgili tüm sorularınız için adresi ile iletişime geçebilirsiniz. {% endfile %} ### Banka Hata Kodları İlgili istek başarılı bir şekilde atıldığında ve ödeme başlatıldığında, bankadan dönen ödeme yanıtlarını içeren hatalar bu grupta değerlendirilmektedir. Bu gruba ait hata kodları ve açıklamaları aşağıdaki gibidir. | Hata Grubu | Servis Hata Mesajı | Servis Yanıtı | Gerekli Aksiyon | Açıklama | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DO\_NOT\_HONOUR | İşlem onaylanmadı | 10005 | Ödeme işlemi sırasında hata oluştu, bankanız ile irtibata geçiniz. |

Kart kaynaklı bir hatadır, kart hamilinin bankası ile iletişime geçmesi gerekmektedir.


| | INVALID\_TRANSACTION | Geçersiz işlem | 10012 | Ödeme işlemi sırasında hata oluştu, bankanız ile irtibata geçiniz. | Kart kaynaklı hatadır, kart hamilinin bankası ile iletişime geçmesi tavsiye edilmektedir. | | FRAUD\_SUSPECT | Ödeme güvenlik denetimini geçemedi | 10034 | İşleme banka tarafından izin verilmemiştir. | Fraud tedbiri. Banka tarafından işleme izin verilmez. Müşteri fraud'u uygulayan kişi olabilir, müşteriye bilgi verilmemesi ve bankaya yönlendirilmesi tavsiye edilir. | | PICKUP\_CARD | Kayıp kart, karta el koyunuz | 10041 | Pin deneme sayısı aşıldı, işleme banka tarafından izin verilmemektedir. | Kullanıcı birden fazla kez pin değerini yanlış girdiğinde alınır, banka karta kısıt koyar. Müşteri fraud'u uygulayan kişi olabilir, müşteriye bilgi verilmemesi ve bankaya yönlendirilmesi tavsiye edilir. | | LOST\_CARD | Kayıp kart, karta el koyunuz | 10041 | İşleme banka tarafından izin verilmemektedir. | Kayıp / Çalıntı kart bildirimidir. Banka tarafından işleme izin verilmez. Müşteri fraud'u uygulayan kişi olabilir, müşteriye bilgi verilmemesi ve bankaya yönlendirilmesi tavsiye edilir. | | STOLEN\_CARD | Çalıntı kart, karta el koyunuz | 10043 | İşleme banka tarafından izin verilmemektedir. | Kayıp / Çalıntı kart bildirimidir. Banka tarafından işleme izin verilmez. Müşteri fraud'u uygulayan kişi olabilir, müşteriye bilgi verilmemesi ve bankaya yönlendirilmesi tavsiye edilir. | | NOT\_SUFFICIENT\_FUNDS | Kart limiti yetersiz, yetersiz bakiye | 10051 | Kart limiti yetersiz, yetersiz bakiye. | Kartın limiti yetersiz olduğu durumda alınır. | | EXPIRED\_CARD | Son kullanma tarihi hatalı | 10054 | Son kullanma tarihi hatalı. Kartınızın vadesi dolmuştur. | Kartın vadesi geçtiği durumda alınır. | | NOT\_PERMITTED\_TO\_CARDHOLDER | Kart sahibi bu işlemi yapamaz | 10057 | Kartınız bu işlem için kısıtlıdır, bankanız ile irtibata geçiniz. | Kart bankası tarafında karta koyulan kısıt durumunda alınır, kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | NOT\_PERMITTED\_TO\_TERMINAL | Terminalin bu işlemi yapmaya yetkisi yok | 10058 | Ödeme sırasında hata oluştu, firma temsilcisi ile irtibata geçiniz. | Pos bankası tarafında alınan bir hatadır, kart kaynaklı olabilmektedir. iyzico ile işlem özelinde iletişime geçiniz. | | INVALID\_CVC2 | Cvc2 bilgisi hatalı | 10084 | Girilen CVV değeri hatalı veya geçersiz. | Ödeme isteğinde gönderilen cvv değeri hatalı veya banka tarafında geçersiz olduğunda alınır. Kullanıcı tekrar işlem deneyebilir tekrar hata alınması durumunda bankası ile iletişime geçebilir. | | RESTRICTED\_BY\_LAW | Kartınız internetten alışverişe kapalıdır. Açtırmak için Bankanız ile irtibata geçebilirsiniz. | 10093 | Kartınız internet alışverişine kapalıdır, bankanız ile irtibata geçiniz. | Kart internet bankacılığına kapalı olduğunda alınır, kart hamili bankası ile iletişime geçerek yada destekliyorsa bankasının mobil uygulaması üzerinden kartının internet bankacılığını açabilir | | CARD\_NOT\_PERMITTED | Kart, işleme izin vermedi | 10201 | Kart işleme izin vermedi, bankanız ile irtibata geçiniz. | Kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | UNKNOWN | Ödeme işlemi esnasında genel bir hata oluştu | 10202 | Ödeme işlemi sırasında hata oluştu, firma temsilcisi ile irtibata geçiniz. | Banka tarafından beklenen istek yapısında oluşabilecek hata, iyzico ile işlem özelinde irtibata geçiniz. | | INVALID\_XML\_END\_TAG | Ödeme işlemi esnasında genel bir hata oluştu | 10204 | Ödeme işlemi sırasında hata oluştu, firma temsilcisi ile irtibata geçiniz. | iyzico ile işlem özelinde irtibata geçiniz. | | INVALID\_CHARS\_IN\_EMAIL | E-posta geçerli formata değil | 10205 | E-posta adresi geçerli formatta değil, e-posta adresinizi kontrol ediniz. | iyzico ile işlem özelinde irtibata geçiniz. | | REFER\_TO\_CARD\_ISSUER | Bankanızdan onay alınız | 10207 | Bankanızdan onay alınız. | Kart kaynaklı bir hatadır, kart hamilinin bankası ile iletişime geçmesi gerekmektedir. | | INVALID\_MERCHANT\_OR\_SP | Üye işyeri kategori kodu hatalı | 10208 | Ödeme işlemi sırasında hata oluştu, firma temsilcisi ile iletişime geçiniz. | iyzico ile işlem özelinde irtibata geçiniz. | | BLOCKED\_CARD | Bloke statülü kart | 10209 | Bloke statülü kart, bankanız ile irtibata geçiniz. | Kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | INVALID\_CAVV | Hatalı CAVV bilgisi | 10210 | Hatalı CVC bilgisi, tekrar deneyiniz. | Ödeme isteğinde gönderilen cvv değeri hatalı veya banka tarafında geçersiz olduğunda alınır. Kullanıcı tekrar işlem deneyebilir tekrar hata alınması durumunda bankası ile iletişime geçebilir. | | INVALID\_ECI | Hatalı ECI bilgisi | 10211 | Ödeme sırasında hata oluştu, bankanız ile irtibata geçiniz. | Kart kaynaklı bir hatadır, kart hamilinin bankası ile iletişime geçmesi gerekmektedir. | | CVC2\_MAX\_ATTEMPT | CVC2 yanlış girme deneme sayısı aşıldı | 10212 | CVC yanlış girme deneme sayısı aşıldı, bankanız ile irtibata geçiniz. | Kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | BIN\_NOT\_FOUND | BIN bulunamadı | 10213 | BIN bulunamadı, firma temsilcisi ile irtibata geçiniz. | iyzico ile işlem özelinde irtibata geçiniz. | | COMMUNICATION\_OR\_SYSTEM\_ERROR | İletişim veya sistem hatası | 10214 | Banka tarafında hata oluştu, daha sonra tekrar deneyiniz. | Banka tarafında yaşanan anlık, süreli veya işlem özelindeki hatalarda alınır, iyzico ile ilgili işlem özelinde iletişime geçilebilir. | | INVALID\_CARD\_NUMBER | Geçersiz kart numarası | 10215 | Geçersiz kart, hatalı kart, kart numaranızı kontrol ediniz. | Ödeme formunda girilen kart numarasının son kullanıcı tarafından kontrol edilmelidir, tekrar hata alınması durumunda kart hamili bankası ile iletişime geçebilir.. | | NO\_SUCH\_ISSUER | Bankası bulunamadı | 10216 | Banka tarafında hata oluştu, daha sonra tekrar deneyiniz. | Kart bankasında yaşanan geçici veya süreli kesintilerde alınan hatadır, hatanın devamı halinde iyzico ile ilgili işlem özelinde iletişime geçilebilir. | | DEBIT\_CARDS\_REQUIRES\_3DS | Banka kartları sadece 3D Secure işleminde kullanılabilir | 10217 | İşlem 3D olarak gerçekleştirilmelidir. | Kart bankasının banka kartıyla yapılan işlemde, işlemin 3D gerçekleştirilmesini ilettiği durumda alınır. | | DEBIT\_CARDS\_INSTALLMENT\_NOT\_ALLOWED | Banka kartları ile taksit yapılamaz | 10218 | Banka kartları ile taksit yapılamaz, tekrar deneyiniz. | Banka kartı ile taksit seçildiğinde alınır. | | REQUEST\_TIMEOUT | Bankaya gönderilen istek zaman aşımına uğradı | 10219 | Banka tarafında bir hata oluştu, daha sonra tekrar deneyiniz. | Banka tarafında yaşanan anlık, süreli veya işlem özelindeki hatalarda alınır, iyzico ile ilgili işlem özelinde iletişime geçilebilir. | | DECLINED | Ödeme alınamadı | 10220 | Tekrar deneyiniz, hata alınması durumunda bankanız ile irtibata geçiniz. | Anlık banka hatası, kullanıcı tekrar deneyerek tekrar hata alması durumunda bankası ile iletişime geçebilir. İlgili hata detayı iyzico Merchant Panelden kontrol edilebilir, iyzico ile işlem özelinde iletişime geçilebilir. | | NOT\_PERMITTED\_TO\_FOREIGN\_CARD | Terminal yurtdışı kartlara kapalı | 10221 | Yurtdışı kartlara işlem izni bulunmamaktadır, firma temsilcisi ile irtibata geçiniz. | Hesap yurt dışı kartlara kapalı olduğunda alınır. Yurt dışı kartlar ile işlem almak isteyen üye iş yerleri iyzico hesap temsilcisi ile iletişime geçilebilir. | | NOT\_PERMITTED\_TO\_INSTALLMENT | Terminal taksitli işleme kapalı | 10222 | Pos taksitli işleme kapalıdır, firma temsilcisi ile irtibata geçiniz. | İşlemin geçtiği pos özelinde taksit yapılamadığı durumda alınır, iyzico taksit servisi ile ilgili işlem özelinde güncel taksit bilgileri çekilebilir, eğer taksitli işlem alınmak isteniyorsa ve daha önce anlaşılmamış ise, iyzico hesap temsilcisi ile iletişime geçilebilir. | | REQUIRES\_DAY\_END | Gün sonu yapılmalı | 10223 | Pos gün sonu yapılmalıdır. | İlgili hata iade isteklerinde aynı gün gerçekleşen işleme iade isteği atıldığında alınabilmektedir. | | EXCEEDS\_WITHDRAWAL\_AMOUNT\_LIMIT | Para çekme limiti aşılmış | 10224 | Kartınızın işlem limiti aşılmıştır, bankanız ile irtibata geçiniz. | Kart özelinde işlem limiti aşıldığında alınır, kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | RESTRICTED\_CARD | Kısıtlı kart | 10225 | Kartınız bu işlem için kısıtlıdır, bankanız ile irtibata geçiniz. | Kart bankası tarafında ilgili karta özelinde bulunan bir kısıt nedeniyle alınır, kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | EXCEEDS\_ALLOWABLE\_PIN\_TRIES | İzin verilen PIN giriş sayısı aşılmış | 10226 | İzin verilebilir pin deneme sayısını aştınız, bankanız ile irtibata geçiniz. | Kullanıcı birden fazla kez pin değerini yanlış girdiğinde alınır, kart hamili detaylı bilgi için kart bankası ile iletişime geçmelidir. | | INVALID\_PIN | Geçersiz PIN | 10227 | Pin numarası yanlış, tekrar deneyiniz. | Kullanıcı pin numarasını yanlış girdiğinde alınır, tekrar işlem denemesi önerilir. | | ISSUER\_OR\_SWITCH\_INOPERATIVE | Banka veya terminal işlem yapamıyor | 10228 | Banka tarafında bir hata oluştu, daha sonra tekrar deneyiniz. | Kart bankasında yaşanan geçici veya süreli kesintilerde alınan hatadır. | | INVALID\_EXPIRE\_YEAR\_MONTH | Son kullanma tarihi geçersiz | 10229 | Kartın son kullanma tarihi hatalıdır, tekrar deneyiniz. | Ödeme isteğinde iletilen kartın son kullanma tarihi yanlış iletildiğinde alınır, kullanıcı kontrol sağlayarak tekrar işlem deneyebilir. | | REQUEST\_BLOCKED\_BY\_BANK | İstek bankadan hata aldı | 10230 | Ödeme isteği banka tarafından bloklandı, bankanız ile irtibata geçiniz. | Ödeme isteğini bankanın bloklaması durumunda ilgili hata alınır, iyzico ile işlem özelinde iletişime geçilebilir. | | SALES\_AMOUNT\_LESS\_THAN\_AWARD | Satış tutarı ödül puanından düşük olamaz | 10231 | Satış tutarı kullanılan puandan düşük olamaz | Ödeme isteğinde gönderilen puan değeri, işlem ücretinden daha fazla olduğunda alınır. | | INVALID\_AMOUNT | Geçersiz tutar | 10232 | Geçersiz tutar, bankanız ile irtibata geçiniz. | Kart kaynaklı hatadır, kart hamilinin bankası ile iletişime geçmesi tavsiye edilmektedir. | | INVALID\_CARD\_TYPE | Geçersiz kart tipi | 10233 | Geçersiz kart tipi, bankanız ile irtibata geçiniz. | Banka tarafından alınan bir hatadır, işlem özelinde banka ile iletişime geçilebilir. | | NOT\_SUFFICIENT\_AWARD | Yetersiz ödül puanı | 10234 | Yetersiz puan. | Ödeme isteğinde iletilen puan değeri, kullanıcının sahip olduğu puandan daha yüksek olduğunda alınır. | | AMEX\_CAN\_USE\_ONLY\_MR | American Express kart hatası | 10235 | American Express kart hatası, bankanız ile irtibata geçiniz. | Kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | REFUND\_NOT\_ALLOWED\_FOR\_THIS\_DEBIT\_CARD | Debit kart işlemlerinde iade yapılamaz | 10237 | Debit kart işlemlerinde iade yapılamaz | iyzico ile işlem özelinde irtibata geçiniz. Bankadan detaylı bilgi alınabilir. | | INPUT\_DATA | Geçersiz işlem | 10238 | Geçersiz işlem | Alternatif ödeme methodu hatasıdır. | | USER\_ABORT | Ödeme kullanıcı tarafından iptal edildi | 10239 | Ödeme kullanıcı tarafından iptal edildi | Alternatif ödeme methodu hatasıdır. | | TIMEOUT | Gönderilen istek zaman aşımına uğradı | 10240 | Gönderilen istek zaman aşımına uğradı | Alternatif ödeme methodu hatasıdır. | | REMOTE\_ERROR | İletişim veya sistem hatası | 10241 | İletişim veya sistem hatası | Alternatif ödeme methodu hatasıdır. | | LOCAL\_ERROR | İletişim veya sistem hatası | 10242 | İletişim veya sistem hatası | Alternatif ödeme methodu hatasıdır. | | LOCAL\_DECLINE | Ödeme alınamadı | 10243 | Ödeme alınamadı | Alternatif ödeme methodu hatasıdır. | | REMOTE\_DECLINE | Ödeme alınamadı | 10244 | Ödeme alınamadı | Alternatif ödeme methodu hatasıdır. | | QUOTA | Ödeme kırılımına ait verilen iade tutarı ve önceden iade edilen toplam tutar kırılımın tutarından büyük olamaz | 10245 | Ödeme kırılımına ait verilen iade tutarı ve önceden iade edilen toplam tutar kırılımın tutarından büyük olamaz | Alternatif ödeme methodu hatasıdır. | | REFUND\_DECLINE | Alternatif ödeme metoduyla gerçekleştirdiğiniz işlem için şu an iade işlemi yapamıyorsunuz, lütfen bir süre sonra tekrar deneyiniz | 10246 | Alternatif ödeme metoduyla gerçekleştirdiğiniz işlem için şu an iade işlemi yapamıyorsunuz, lütfen bir süre sonra tekrar deneyiniz | Alternatif ödeme methodu hatasıdır. | | BANK\_TRANSFER | Banka transferi ödemesi yapılmadı | 10247 | Banka transferi ödemesi yapılmadı | Havale/Eft yöntemi ile beklenen ödeme alınmadığında servisten dönen yanıttır. | | EXCEEDED\_TRANSACTION\_AMOUNT | İşlem yapmak istediğin tutar işlem limitini aşmaktadır, şu an için sana yardımcı olamıyoruz. | 10248 | İşlem yapmak istediğin tutar işlem limitini aşmaktadır, bankanız ile irtibata geçiniz. | Kart hamili bankası ile iletişime geçerek detaylı bilgi alabilir. | | FUND\_API | Fund api ödemesi sırasında bir hata oluştu. | 10249 | Bakiye ödemesi sırasında bir hata oluştu, firma temsilcisi ile irtibata geçiniz. | iyzico ile işlem özelinde irtibata geçiniz. | | LOYALTY\_USAGE\_INSTALLMENT\_NOT\_ALLOWED | Taksitli islem icin puan kullanilamaz. | 10250 | Taksitli islem icin puan kullanilamaz. | Bütün bankalarda geçerli değildir, İş Bankasından yapılan puan kullanımı içeren işlemlerde taksit gönderimi yapıldığında işlem bankadan hata alır. | | LOYALTY\_MIXED\_USAGE\_NOT\_ALLOWED | İşlem yapılan kart icin puan ve kart limiti beraber kullanilamaz | 10251 | İşlem yapılan kart icin puan ve kart limiti beraber kullanilamaz | Bütün bankalarda geçerli değildir, World kart ailesi kartlarda kartın bankası Yapıkredi değil ise, işlemin ya tamamı puan ile ödenmeli yada işlemde hiç puan kullandırılmamalıdır. | | CALLBACK\_3DS | | | 3D Secure doğrulaması aşamasında hata oluştu. |

Kullanıcının 3D formunda kendisini başarılı bir şekilde doğrulayamadığı durumlarda işlemin bulunduğu statüdür.

| | INIT\_3DS | | | 3D Secure doğrulaması aşamasında hata oluştu. |

Bir işlemin statüsü aşağıdaki durumlarda init\_threeds statüsünde kalır;

- Kullanıcı kendi isteği ile 3D formunu terk ettiğinde,
- Kullanıcı 3D formunu çeşitli nedenler ile göremediğinde (Network kaynaklı, İnternet servis sağlayıcı kaynaklı internet hızının düşük olması, kullanıcının enviromentı kaynaklı, 3D formunun kullanıcı ekranında açılamadığı durumlarda)
- Yabancı kart üzerinden gerçekleşen işlemlerde, kullanıcının telefonuna sms gelmemesi gibi durumlarda
- Kartın veya Kart bankasının 3D'yi desteklemediği durumlarda
- Yabancı kart özelinde kullanıcının 3D şifresini oluşturmadığı durumlarda

| ### Genel Hata Kodları Genel Hata Kodları, genel olarak sizin attığınız istek sırasında ödeme bilgilerinde eksik kalan bir bilgi kaynaklı olabilmektedir. İlgili Hata Kodları ve sebepleri aşağıdaki tabloda verilmektedir.
KodHata MesajıRetryAçıklama
1Sistem hatası oluştutrueTekrar deneyebilir veya destek ekibiyle iletişime geçebilirsiniz.
2Sistem hatası oluştutrueTekrar deneyebilir veya destek ekibiyle iletişime geçebilirsiniz.
3email gönderilmesi zorunludurtrueÖdeme isteğinde buyerEmail parametresi eklenmesi gerekmektedir.
4email en fazla 100 karakter olmalıdırtruebuyerEmail parametresine, 100 karakterden az bir değer set edilmesi gerekmektedir.
5email hatalı format ile gönderilmiştirtruebuyerEmail, email formatında gönderilmelidir.
8identityNumber gönderilmesi zorunludurtrueÖdeme isteğinde identityNumber parametresi eklenmesi gerekmektedir.
9identityNumber en fazla 50 karakter olmalıdırtrueidentityNumber parametresine, 50 karakterden az bir değer set edilmesi gerekmektedir.
10identityNumber en az 5 karakter olmalıdırtrueidentityNumber parametresine, 5 karakterden fazla bir değer set edilmesi gerekmektedir.
11Geçersiz istektrueParametreler uygun formatta set edilmediği taktirde alınabilmektedir. Detaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
12Kart numarası geçersizdirtrueKart numarası luhn algoritmasına uygun bir formatta gönderilmediğinde bu hata mesajı dönmektedir..
13expireMonth geçersizdirtrueexpireMonth, geçmiş veya hatalı formatta gönderildiğinde bu hata mesajı alınabiilmektedir.
14expireYear geçersizdirtrueexpireYear, geçmiş veya hatalı formatta gönderildiğinde bu hata mesajı alınabilmektedir.
15cvc geçersizdirtrueCVC, American Express kartlarda 4 haneli, diğer kartlarda ise 3 haneli olmalıdır. Bu kurala uymayan bir CVC, ilgili hata mesajını döndürmektedir.
16cardHolderName gönderilmesi zorunludurtrueAPI Ödeme isteğinde cardHolderName parametresi eklenmesi gerekmektedir.
19cardHolderName en fazla 100 karakter olmalıdırtruecardHolderName parametresine, 100 karakterden az bir değer set edilmesi gerekmektedir.
20conversationId en fazla 255 karakter olmalıdırtrueconversationId parametresine, 255 karakterden az bir değer set edilmesi gerekmektedir.
21cardAlias en fazla 293 karakter olmalıdırtruecardAlias parametresine, 293 karakterden az bir değer set edilmesi gerekmektedir.
22IP en fazla 50 karakter olmalıdır.trueİade servisinde IP değeri, 50 karakterden az olacak şekilde gönderilmesi gerekmektedir.
23callbackUrl gönderilmesi zorunludurtrueCF Ödeme isteğinde callbackUrl parametresi eklenmesi gerekmektedir.
25gsmNumber gönderilmesi zorunludurtrueÖdeme isteğinde gsmNumber parametresi eklenmesi gerekmektedir.
26gsmNumber en fazla 25 karakter olmalıdırtruegsmNumber parametresine, 25 karakterden az bir değer set edilmesi gerekmektedir.
27Geçersiz telefon numarasıtrue+90 ile başlayan ve bir telefon numarası gönderilmesi gerekmektedir.
### Kimlik Doğrulama Hata Kodları iyzico API bağlantısı gerçekleştirilirken, atılan istekte [Kimlik Doğrulama](https://docs.iyzico.com/on-hazirliklar/kimlik-dogrulama#sha256-kimlik-dogrulama) kısmında alınan hataları da içeren hata mesajları bu kategoriye girmektedir. Kodları ve açıklamaları aşağıdaki gibidir.
KodHata MesajıRetryAçıklama
1000Geçersiz imzatrueOluşturulan hash değeri iyzico tarafında eşleşmediğinde alınır. Örnek kodlar üzerinden tekrar kontrol edebilirisiz.
1001API Bilgileri BulunamadıtrueAPI bilgileri ve baseUrl değeri eşleşmediğinde veya hesapta kısıtlama bulunması durumunda alınır. Live vs Sandbox sayfasını ziyaret edebilirsiniz. Hesabınızın kısıt kontrolü için destek ekibiyle iletişime geçebilirsiniz.
1002Üye işyeri bulunamadıtrueİstekte kullanılan API bilgisi kontrol edilmelidir. API bilgisi doğru değilse üye işyeri bulunamadı hatası dönmektedir.
1003Yetkilendirme hatasıtrueÖrnek collection üzerinden kontrollerinizi sağlayabilir, detaylı bilgi için destek ekibimizle iletişime geçebilirsiniz.
1004Random string gönderilmesi zorunludurtruePostman'den yapılan işlemlerde headers bölümünde x-iyzi-rnd parametresi gönderilmelidir. Bu parametre gönderilmeden istek yapıldığında ilgili hata mesajı alınmaktadır.
1006api key gönderilmesi zorunludurtrueİstekte set edilen API değeri kontrol edilmelidir. API değeri olmadığında bu hata alınmaktadır.
1007Signature gönderilmesi zorunludurtrueBu hata mesajı API ve Güvenlik anahtarı olmadan bir sorgu yapıldığında alınmaktadır.
1008Authorization header prefix bulunamadıtrueÖrnek collection üzerinden kontrollerinizi sağlayabilir, detaylı bilgi için destek ekibimizle iletişime geçebilirsiniz.
1009Authorization header string gönderilmesi zorunludurtruePostmanden gönderilen istekte, headers bölümünde "Authoriaztion" tanımalaması yapılması gerekmektedir. Örnek collection üzerinden kontrollerinizi sağlayabilirsiniz.
### Pazaryeri Onboarding Hata Mesajları Üye işyerinin, onboarding aşamasında gerekli olan bilgilerden IBAN, vergi dairesi gibi bilgilerinin eksik olma durumunda karşılaştığı hatalar bu grupta yer almaktadır. Hata kodları ve mesajları aşağıdaki gibidir.
Kod Hata MesajıRetryAçıklama
2000Bu servis sadece pazaryeri müşterilerine açıktırtruePazaryeri olmayan bir hesapta pazaryeri servislerine istek atıldığında bu hata alınmaktadır
2001Alt üye işyeri bulunamadıtrueİstekte set edilen submerchantExternalId değerini kontrol edilmelidir. submerchantExternalId değeri, hesaptaki altüyelerden birine ait değilse bu hata mesajı dönmektedir.
2002Alt üye işyeri bulunmaktadırtrueDaha önce aynı externalId değeri ile farklı bir altüye oluşturulduysa, hata alınabilir. externalId değeri değiştirilip tekrar denenebilir.
2003subMerchantKey gönderilmesi zorunludurtrueİstekte set edilen subMerchantKey değeri kontrol edilmelidir. subMerchantKey değeri gönderilmediğinde bu hata alınmaktadır.
2004subMerchantType gönderilmesi zorunludurtrueİstekte set edilen subMerchantType değeri kontrol edilmelidir. subMerchantType değeri gönderilmediğinde bu hata alınmaktadır.
2005Iban gönderilmesi zorunludurtrueUpdate submerchant servisinde IBAN parametresi requeste eklenmediğinde bu hata dönmektedir.
2007subMerchantExternalId gönderilmesi zorunludurtruePazaryerinde altüye oluştururken subMerchantExternalId gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2008subMerchantExternalId en fazla 255 karakter olmalıdırtruesubMerchantExternalId parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2009address gönderilmesi zorunludurtruePazaryerinde altüye oluştururken address gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2010address en fazla 255 karakter olmalıdırtrueaddress parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2011address en az 5 karakter olmalıdırtrueaddress parametresini 5 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2012contactName gönderilmesi zorunludurtruePazaryerinde altüye oluştururken contactName gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2013contactName en fazla 100 karakter olmalıdırtruecontactName parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2014contactName en az 2 karakter olmalıdırtruecontactName parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2015contactSurname gönderilmesi zorunludurtruePazaryerinde altüye oluştururken contactSurname gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2016contactSurname en fazla 100 karakter olmalıdırtruecontactSurname parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2017contactSurname en az 2 karakter olmalıdırtruecontactName parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2018taxOffice gönderilmesi zorunludurtrueŞahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, taxOffice gönderilmesi zorunlu bir parametredir.
2019taxOffice en fazla 255 karakter olmalıdırtruetaxOffice parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2020taxOffice en az 3 karakter olmalıdırtruetaxOffice parametresini 3 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2021legalCompanyTitle gönderilmesi zorunludurtrueŞahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, legalCompanyTitle gönderilmesi zorunlu bir parametredir.
2022legalCompanyTitle en fazla 255 karakter olmalıdırtruelegalCompanyTitle parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2023legalCompanyTitle en az 3 karakter olmalıdırtruelegalCompanyTitle parametresini 3 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2024taxNumber gönderilmesi zorunludurtrueŞahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, taxNumber gönderilmesi zorunlu bir parametredir.
2025taxNumber en fazla 100 karakter olmalıdırtruetaxNumber parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2026taxNumber en az 2 karakter olmalıdırtruetaxNumber parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2028name en fazla 255 karakter olmalıdırtruename parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2029gsmNumber en fazla 25 karakter olmalıdırtruegsmNumber parametresini 25 karakterden daha az bir değer göndererek tekrar deneyebilirsiniz.
2030Gönderilen iban hatalı formattadırtrueGönderilen IBAN değeri, 26 karakterli gerçek bir IBAN formatında olmalıdır.
### Kart Saklama Doğrulama Hataları Kart Saklama istekleri için gerekli olan bilgilerin eksik gönderilmesi sonrasında alınan hatalar bu grupta yer almaktadır. İlgili hata kodları ve mesajları aşağıdaki gibidir.
Kod Hata MesajıRetryAçıklama
3000externalId en fazla 255 karakter olmalıdırtrueKart kaydetme esnasında gönderilen externalId değerini 255'ten az bir değer göndererek tekrar deneyebilirsiniz.
3001cardUserKey gönderilmesi zorunludurtrueRetrieve cards isteğine cardUserKey parametresini set ederek tekrar deneyebilirsiniz.
3002cardToken gönderilmesi zorunludurtrueDelete card isteğine cardToken parametresini set ederek tekrar deneyebilirsiniz.
3003card bilgisi gönderilmesi zorunludurtrueKart oluşturma servislerinde kart bilgileri, "card" içerisinde gönderilmelidir. Hata alınan istekte bu alanı kontrol edebilirsiniz.
1401Kart numarası gönderilmesi zorunludurtrueKart oluşturma servisinde, cardNumber parametresinde, kart bilgisinin gönderilmesi gerekmektedir. Bu bilgiyi set ederek tekrar deneyebilirsiniz.
3005cardUserKey bulunamadıtrueKart detayları alınmak istenen user için, gönderilen cardUserKey bilgisi sistemde tanımlı değilse bu hata mesajı dönmektedir. Gönderilen bilginin doğruluğunu kontrol edebilirsiniz.
3006cardToken bulunamadıtrueHata alınan istekte gönderilen cardToken bilgisinin kontrol edilmesi gerekmektedir.
3007Kart saklama özelliği tanımlı değiltrueHesapta kart saklama özelliği tanımlı değilken kart saklama servisine istek atıldığında alınmaktadır. iyzico panelinde eklentiler sekmesinden kart saklama özelliğini satın alarak hesabınızda kart saklama özelliğini aktif edebilirsiniz.
3008Encryption hatasıtrueDetaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
3009Decryption hatasıtrueDetaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
3012Email kart numarası içeremeztrueKart kaydederken gönderilen email parametresinde kart numarası olmaması gerekmektedir.
3013externalId kart numarası içeremeztrueKart kaydederken gönderilen externalId parametresinde kart numarası olmaması gerekmektedir.
### Validasyon Hataları Validasyon hataları, hatalı bilgi, fraud, limit vb. farklı durumlardan dolayı iyzico tarafından dönen hata mesajlarıdır.
Kod Hata MesajıRetryAçıklama
5001paymentTransactionId gönderilmesi zorunludurtrueApprove servisinde paymentTransactionId zorunlu bir parametre olduğundan dolayı request'e eklenmediğinde bu hata mesajı dönmektedir.
5111cardUserKey bilgisi cardToken ile birlikte gönderilmelidirtrueSaklı kart ile atılan ödeme isteklerinde cardUserKey ve cardToken bilgisi birlikte gönderilmelidir. cardToken bilgisi ödeme isteğine set edilmediğinde ilgili hata mesajı dönmektedir.
5002paymentId gönderilmesi zorunludurtrue3DS entegrasyonunun ikinci adımı olan ödeme tamamlama aşamasında, create threeds payment servisinde paymentId gönderilmesi zorunlu bir parametredir. iyzico'ya göndermiş olduğunuz bu istekte paymentId değeri bulunmuyorsa bu hata dönmektedir.
5005subMerchantKey gönderilmesi zorunludurtrueiyzico servislerinde fiyatı belirleyen parametreler sıfırdan büyük bir değer olmalıdır. Bu parametrelerden herhangi birine sıfır set edilirse iyzico'dan ilgili hata mesajı dönmektedir.
5006binNumber gönderilmesi zorunludurtruebinNumber parametresi ilgili servis için zorunlu bir parametredir ve servise gönderilmediği zaman bu hata dönmektedir.
5007binNumber 6 karakter olmalıdırtrueSet edilen binNumber parametresi, 6 veya 8 haneli değer almalıdır. Bu değer dışında ilgili hata alınmaktadır.
5008Fiyat bilgisi 100,000 değerinden fazla veya eşit olamaztrueHesabınız üzerinde bulunan maksimum ödeme tutarının arttırılması için destek ekibimizle iletişime geçebilirsiniz.
50143dsecure esnasında conversation data decrypt edilemeditrueCreate threeds payment servisine gönderdiğiniz conversationData değerini kontrol etmenizi rica ederiz. Eğer bu veri tarafınıza boş olarak iletildiyse, ilgili servise de boş olarak gönderebilirsiniz.
5024Bu ödeme kırılımının onaylanabilmesi için alt üye işyerinin identityNumber bilgisinin olması gerekirtrueidentityNumber parametresi girilmeden oluşturulan submerchantların kırılımları onaylanmamaktadır. İlgili submerchant önce update edilip identityNumber parametresi tanımlanmalı daha sonra bu kırılıma onay verilmelidir.
5050basketItemPrice sıfırdan küçük veya sıfıra eşit olamaztrueiyzico servislerinde fiyat parametreleri sıfırdan küçük veya eşit olamaz. İlgili hata request içindeki itemlardan en az birinin fiyatının sıfırdan küçük veya eşit olduğu durumlarda alınmaktadır.
5062Gönderilen tutar tüm kırılımların toplam tutarına eşit olmalıdırtrueSepetteki ürünlerin toplam tutarı price parametresine eşit olmalıdır. Sepetteki ürünlerin toplamı ile price parametresinde yazan değer eşit olmadığında "Gönderilen tutar tüm kırılımların toplam tutarına eşit olmalıdır " hata mesajı dönmektedir.
5064Bu ödeme kırılımı önceden onaylanmıştırtrueDaha önce onay verilmiş bir kırılıma tekrar onay verilmek istendiğinde ilgili hata mesajı alınmaktadır.
5066Bin bulunamadıtrueiyzico'da Türk bankalarına ait BIN'ler bulunmaktadır. Yabancı bankalara ait bir BIN ile sorgu yapıyorsanız bundan dolayı ilgili mesajla karşılaşıyor olabilirsiniz.
5077Marketplace üye işyeri için ürün ödemesinde bütün sepet kırılımlarında subMerchantKey gönderilmelidirtruePazaryeri entegrasyonunda her bir ürün içerisinde ürünün hangi alt satıcıya ait olduğunu(submerchantKey) ve bu alt satıcıya işlemden ne kadar tutar aktarılmasını belirten(submerchantPrice) parametrelerin bulunması gerekmektedir.
5078SubMerchantKeylere ait alt üye işyerleri sistemde bulunamadıtruesubMerchantKey değeri yanlış veya hesabınıza tanımlı olmayan bir değer gönderilir ise bu hata mesajı alınabilmektedir.
5086Üye işyerine ait ödeme kaydı bulunamadıtrueCancel requestindeki paymentId parametresine yanlış bir değer set edilince bu hata mesajı dönmektedir.
5087Üye İşyerine Ait Ödeme Kaydı BulunamadıtrueCreate threeds payment servisinde gönderilen paymentId bilgisi hatalı gönderildiğinde bu hata alınabilmektedir. Create threeds payment servisinde gönderilen parametrenin doğru olup olmadığı kontrol edilmelidir.
5087Üye İşyerine Ait Ödeme Kaydı BulunamadıtrueRetrieve payment result servisinde, sorgulama yapılacak ödeme işlemine ait paymentId değeri gönderilmelidir. paymentId değeri yanlış girilirse, bu hata mesajı ile karşılaşılabilir.
5064Bu ödeme kırılımı önceden onaylanmıştırtrueDaha önce onay verilmiş bir kırılıma tekrar onay verilmek istendiğinde ilgili hata mesajı alınmaktadır.
6001Ödeme Bilgisi Güvenlik Denetimini GeçemeditrueDetaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
### Pazaryeri Payout Hataları Pazaryeri ürününe sahip olan kullanıcılarımızın, ilgili pazaryeri dağıtımları esnasında aldığı hatalar bu grupta yer almaktadır. İlgili hataların kodları ve açıklamaları aşağıdaki gibidir.a | Kod | Açıklama | | ---- | -------------------------------------------------------------------------------------------- | | 4000 | subMerchantKey gönderilmesi zorunludur | | 4001 | Reason gönderilmesi zorunludur | | 4002 | Alt üye işyeri bulunamadı | | 4003 | Gönderenin bakiye kaydı yok | | 4004 | Gönderenin bakiyesi yetersiz | | 4005 | Üye işyerinin mahsuplaşma servisini kullanmaya yetkisi bulunmamaktadır | | 4006 | Mahsuplaşma yapabilmek için alt üye işyerinin bakiyeye para gönderim ayarı kapalı olmalıdır. |