Hata Kodları

iyzico ödeme API'sinde bankadan dönen hata mesajları 10bin ile başlar. En çok alınan hata koldarının başına 10bin eklenerek yanıt olarak anında döner. Örnek "10005". 10 bin’den küçük hata kodları ise API'den dönen validasyon ya da business hata kodları olarak adlandırılır.

Bir hata oluştuğunda yani status parametresi failure değeri aldığında iyzico ödeme API'si aşağıdaki gibi yanıt döner:

  • errorCode: örneğin 10051
  • errorGroup: örneğin NOT_SUFFICIENT_FUNDS
  • errorName: örneğin Error
  • errorMessage: örneğin Kart limiti yetersiz, yetersiz bakiye
Hata Kodları Detayı
  • Eğer hata bankadan dönüyorsa 10binle başlayan hatalar alınır ve hata grubuna göre many-to-many olan hataları iyzico tasnif ederek, API'den döner. Hata grubuna göre (hata koduna göre değil, mutlaka grubu kullanın) üye iş yeri mapping yapabilir veya yanıt olarak dönen mesajı son kullanıcıya gösterebilir. Örneğin 051 limit yetersiz size 10051 koduyla ve NOT_SUFFICIENT_FUNDS grubuyla döner. Tüm liste aşağıdaki gibidir, ek olarak bu işlemleri panelde kırmızı kayıtlar olarak görebilirsiniz.
errorCode errorMessage errorGroup
10051 Kart limiti yetersiz, yetersiz bakiye NOT_SUFFICIENT_FUNDS
10005 İşlem onaylanmadı DO_NOT_HONOUR
10012 Geçersiz işlem INVALID_TRANSACTION
10041 Kayıp kart, karta el koyunuz LOST_CARD
10043 Çalıntı kart, karta el koyunuz STOLEN_CARD
10054 Vadesi dolmuş kart EXPIRED_CARD
10084 CVC2 bilgisi hatalı INVALID_CVC2
10057 Kart sahibi bu işlemi yapamaz NOT_PERMITTED_TO_CARDHOLDER
10058 Terminalin bu işlemi yapmaya yetkisi yok NOT_PERMITTED_TO_TERMINAL
10034 Dolandırıcılık şüphesi FRAUD_SUSPECT
10093 Kartınız e-ticaret işlemlerine kapalıdır. Bankanızı arayınız. RESTRICTED_BY_LAW
10201 Kart, işleme izin vermedi CARD_NOT_PERMITTED
10204 Ödeme işlemi esnasında genel bir hata oluştu UNKNOWN
10206 CVC uzunluğu geçersiz INVALID_CVC2_LENGTH
10207 Bankanızdan onay alınız REFER_TO_CARD_ISSUER
10208 Üye işyeri kategori kodu hatalı INVALID_MERCHANT_OR_SP
10209 Bloke statülü kart BLOCKED_CARD
10210 Hatalı CAVV bilgisi INVALID_CAVV
10211 Hatalı ECI bilgisi INVALID_ECI
10213 BIN bulunamadı BIN_NOT_FOUND
10214 İletişim veya sistem hatası COMMUNICATION_OR_SYSTEM_ERROR
10215 Geçersiz kart numarası INVALID_CARD_NUMBER
10216 Bankası bulunamadı NO_SUCH_ISSUER
10217 Banka kartları sadece 3D Secure işleminde kullanılabilir DEBIT_CARDS_REQUIRES_3DS
10219 Bankaya gönderilen istek zaman aşımına uğradı REQUEST_TIMEOUT
10222 Terminal taksitli işleme kapalı NOT_PERMITTED_TO_INSTALLMENT
10223 Gün sonu yapılmalı REQUIRES_DAY_END
10225 Kısıtlı kart RESTRICTED_CARD
10226 İzin verilen PIN giriş sayısı aşılmış EXCEEDS_ALLOWABLE_PIN_TRIES
10227 Geçersiz PIN INVALID_PIN
10228 Banka veya terminal işlem yapamıyor ISSUER_OR_SWITCH_INOPERATIVE
10229 Son kullanma tarihi geçersiz INVALID_EXPIRE_YEAR_MONTH
10232 Geçersiz tutar INVALID_AMOUNT