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
10051errorGroup: örneğin
NOT_SUFFICIENT_FUNDSerrorName: örneğin
ErrorerrorMessage: örneğin
Kart limiti yetersiz, yetersiz bakiye
iyzico, hata kodlarını gruplara ayırmaktadır. Banka Hata Kodları 10000 ile başlarken, Kart Saklama Hata Mesajları 3000 ile başlamaktadır.
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;
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.
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.
1
Sistem hatası oluştu
true
Tekrar deneyebilir veya destek ekibiyle iletişime geçebilirsiniz.
2
Sistem hatası oluştu
true
Tekrar deneyebilir veya destek ekibiyle iletişime geçebilirsiniz.
3
email gönderilmesi zorunludur
true
Ödeme isteğinde buyerEmail parametresi eklenmesi gerekmektedir.
4
email en fazla 100 karakter olmalıdır
true
buyerEmail parametresine, 100 karakterden az bir değer set edilmesi gerekmektedir.
5
email hatalı format ile gönderilmiştir
true
buyerEmail, email formatında gönderilmelidir.
8
identityNumber gönderilmesi zorunludur
true
Ödeme isteğinde identityNumber parametresi eklenmesi gerekmektedir.
9
identityNumber en fazla 50 karakter olmalıdır
true
identityNumber parametresine, 50 karakterden az bir değer set edilmesi gerekmektedir.
10
identityNumber en az 5 karakter olmalıdır
true
identityNumber parametresine, 5 karakterden fazla bir değer set edilmesi gerekmektedir.
11
Geçersiz istek
true
Parametreler uygun formatta set edilmediği taktirde alınabilmektedir. Detaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
12
Kart numarası geçersizdir
true
Kart numarası luhn algoritmasına uygun bir formatta gönderilmediğinde bu hata mesajı dönmektedir..
13
expireMonth geçersizdir
true
expireMonth, geçmiş veya hatalı formatta gönderildiğinde bu hata mesajı alınabiilmektedir.
14
expireYear geçersizdir
true
expireYear, geçmiş veya hatalı formatta gönderildiğinde bu hata mesajı alınabilmektedir.
15
cvc geçersizdir
true
CVC, 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.
16
cardHolderName gönderilmesi zorunludur
true
API Ödeme isteğinde cardHolderName parametresi eklenmesi gerekmektedir.
19
cardHolderName en fazla 100 karakter olmalıdır
true
cardHolderName parametresine, 100 karakterden az bir değer set edilmesi gerekmektedir.
20
conversationId en fazla 255 karakter olmalıdır
true
conversationId parametresine, 255 karakterden az bir değer set edilmesi gerekmektedir.
21
cardAlias en fazla 293 karakter olmalıdır
true
cardAlias parametresine, 293 karakterden az bir değer set edilmesi gerekmektedir.
22
IP en fazla 50 karakter olmalıdır.
true
İade servisinde IP değeri, 50 karakterden az olacak şekilde gönderilmesi gerekmektedir.
23
callbackUrl gönderilmesi zorunludur
true
CF Ödeme isteğinde callbackUrl parametresi eklenmesi gerekmektedir.
25
gsmNumber gönderilmesi zorunludur
true
Ödeme isteğinde gsmNumber parametresi eklenmesi gerekmektedir.
26
gsmNumber en fazla 25 karakter olmalıdır
true
gsmNumber parametresine, 25 karakterden az bir değer set edilmesi gerekmektedir.
27
Geç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 kısmında alınan hataları da içeren hata mesajları bu kategoriye girmektedir. Kodları ve açıklamaları aşağıdaki gibidir.
1000
Geçersiz imza
true
Oluşturulan hash değeri iyzico tarafında eşleşmediğinde alınır. Örnek kodlar üzerinden tekrar kontrol edebilirisiz.
1001
API Bilgileri Bulunamadı
true
API 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.
1003
Yetkilendirme hatası
true
Örnek collection üzerinden kontrollerinizi sağlayabilir, detaylı bilgi için destek ekibimizle iletişime geçebilirsiniz.
1004
Random string gönderilmesi zorunludur
true
Postman'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.
1006
api key gönderilmesi zorunludur
true
İstekte set edilen API değeri kontrol edilmelidir. API değeri olmadığında bu hata alınmaktadır.
1007
Signature gönderilmesi zorunludur
true
Bu hata mesajı API ve Güvenlik anahtarı olmadan bir sorgu yapıldığında alınmaktadır.
1008
Authorization header prefix bulunamadı
true
Örnek collection üzerinden kontrollerinizi sağlayabilir, detaylı bilgi için destek ekibimizle iletişime geçebilirsiniz.
1009
Authorization header string gönderilmesi zorunludur
true
Postmanden 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.
2000
Bu servis sadece pazaryeri müşterilerine açıktır
true
Pazaryeri olmayan bir hesapta pazaryeri servislerine istek atıldığında bu hata alınmaktadır
2001
Alt ü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.
2002
Alt üye işyeri bulunmaktadır
true
Daha önce aynı externalId değeri ile farklı bir altüye oluşturulduysa, hata alınabilir. externalId değeri değiştirilip tekrar denenebilir.
2003
subMerchantKey gönderilmesi zorunludur
true
İstekte set edilen subMerchantKey değeri kontrol edilmelidir. subMerchantKey değeri gönderilmediğinde bu hata alınmaktadır.
2004
subMerchantType gönderilmesi zorunludur
true
İstekte set edilen subMerchantType değeri kontrol edilmelidir. subMerchantType değeri gönderilmediğinde bu hata alınmaktadır.
2005
Iban gönderilmesi zorunludur
true
Update submerchant servisinde IBAN parametresi requeste eklenmediğinde bu hata dönmektedir.
2007
subMerchantExternalId gönderilmesi zorunludur
true
Pazaryerinde altüye oluştururken subMerchantExternalId gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2008
subMerchantExternalId en fazla 255 karakter olmalıdır
true
subMerchantExternalId parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2009
address gönderilmesi zorunludur
true
Pazaryerinde altüye oluştururken address gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2010
address en fazla 255 karakter olmalıdır
true
address parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2011
address en az 5 karakter olmalıdır
true
address parametresini 5 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2012
contactName gönderilmesi zorunludur
true
Pazaryerinde altüye oluştururken contactName gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2013
contactName en fazla 100 karakter olmalıdır
true
contactName parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2014
contactName en az 2 karakter olmalıdır
true
contactName parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2015
contactSurname gönderilmesi zorunludur
true
Pazaryerinde altüye oluştururken contactSurname gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz.
2016
contactSurname en fazla 100 karakter olmalıdır
true
contactSurname parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2017
contactSurname en az 2 karakter olmalıdır
true
contactName parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2018
taxOffice gönderilmesi zorunludur
true
Şahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, taxOffice gönderilmesi zorunlu bir parametredir.
2019
taxOffice en fazla 255 karakter olmalıdır
true
taxOffice parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2020
taxOffice en az 3 karakter olmalıdır
true
taxOffice parametresini 3 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2021
legalCompanyTitle gönderilmesi zorunludur
true
Şahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, legalCompanyTitle gönderilmesi zorunlu bir parametredir.
2022
legalCompanyTitle en fazla 255 karakter olmalıdır
true
legalCompanyTitle parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2023
legalCompanyTitle en az 3 karakter olmalıdır
true
legalCompanyTitle parametresini 3 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2024
taxNumber gönderilmesi zorunludur
true
Şahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, taxNumber gönderilmesi zorunlu bir parametredir.
2025
taxNumber en fazla 100 karakter olmalıdır
true
taxNumber parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2026
taxNumber en az 2 karakter olmalıdır
true
taxNumber parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz.
2028
name en fazla 255 karakter olmalıdır
true
name parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz.
2029
gsmNumber en fazla 25 karakter olmalıdır
true
gsmNumber parametresini 25 karakterden daha az bir değer göndererek tekrar deneyebilirsiniz.
2030
Gönderilen iban hatalı formattadır
true
Gö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.
3000
externalId en fazla 255 karakter olmalıdır
true
Kart kaydetme esnasında gönderilen externalId değerini 255'ten az bir değer göndererek tekrar deneyebilirsiniz.
3001
cardUserKey gönderilmesi zorunludur
true
Retrieve cards isteğine cardUserKey parametresini set ederek tekrar deneyebilirsiniz.
3002
cardToken gönderilmesi zorunludur
true
Delete card isteğine cardToken parametresini set ederek tekrar deneyebilirsiniz.
3003
card bilgisi gönderilmesi zorunludur
true
Kart oluşturma servislerinde kart bilgileri, "card" içerisinde gönderilmelidir. Hata alınan istekte bu alanı kontrol edebilirsiniz.
1401
Kart numarası gönderilmesi zorunludur
true
Kart oluşturma servisinde, cardNumber parametresinde, kart bilgisinin gönderilmesi gerekmektedir. Bu bilgiyi set ederek tekrar deneyebilirsiniz.
3005
cardUserKey bulunamadı
true
Kart 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.
3006
cardToken bulunamadı
true
Hata alınan istekte gönderilen cardToken bilgisinin kontrol edilmesi gerekmektedir.
3007
Kart saklama özelliği tanımlı değil
true
Hesapta 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.
3008
Encryption hatası
true
Detaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
3009
Decryption hatası
true
Detaylı bilgi için destek ekibiyle iletişime geçebilirsiniz.
3012
Email kart numarası içeremez
true
Kart kaydederken gönderilen email parametresinde kart numarası olmaması gerekmektedir.
3013
externalId kart numarası içeremez
true
Kart 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.
5001
paymentTransactionId gönderilmesi zorunludur
true
Approve servisinde paymentTransactionId zorunlu bir parametre olduğundan dolayı request'e eklenmediğinde bu hata mesajı dönmektedir.
5111
cardUserKey bilgisi cardToken ile birlikte gönderilmelidir
true
Saklı 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.
5002
paymentId gönderilmesi zorunludur
true
3DS 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.
5005
subMerchantKey gönderilmesi zorunludur
true
iyzico 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.
5006
binNumber gönderilmesi zorunludur
true
binNumber parametresi ilgili servis için zorunlu bir parametredir ve servise gönderilmediği zaman bu hata dönmektedir.
5007
binNumber 6 karakter olmalıdır
true
Set edilen binNumber parametresi, 6 veya 8 haneli değer almalıdır. Bu değer dışında ilgili hata alınmaktadır.
5008
Fiyat bilgisi 100,000 değerinden fazla veya eşit olamaz
true
Hesabınız üzerinde bulunan maksimum ödeme tutarının arttırılması için destek ekibimizle iletişime geçebilirsiniz.
5014
3dsecure esnasında conversation data decrypt edilemedi
true
Create 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.
5024
Bu ödeme kırılımının onaylanabilmesi için alt üye işyerinin identityNumber bilgisinin olması gerekir
true
identityNumber 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.
5050
basketItemPrice sıfırdan küçük veya sıfıra eşit olamaz
true
iyzico 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.
5062
Gönderilen tutar tüm kırılımların toplam tutarına eşit olmalıdır
true
Sepetteki ü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.
5064
Bu ödeme kırılımı önceden onaylanmıştır
true
Daha önce onay verilmiş bir kırılıma tekrar onay verilmek istendiğinde ilgili hata mesajı alınmaktadır.
5066
Bin bulunamadı
true
iyzico'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.
5077
Marketplace üye işyeri için ürün ödemesinde bütün sepet kırılımlarında subMerchantKey gönderilmelidir
true
Pazaryeri 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.
5078
SubMerchantKeylere ait alt üye işyerleri sistemde bulunamadı
true
subMerchantKey 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ı
true
Cancel requestindeki paymentId parametresine yanlış bir değer set edilince bu hata mesajı dönmektedir.
5087
Üye İşyerine Ait Ödeme Kaydı Bulunamadı
true
Create 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ı
true
Retrieve 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.
5064
Bu ödeme kırılımı önceden onaylanmıştır
true
Daha ö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çemedi
true
Detaylı 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
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.
Last updated