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 Karta el koy PICKUP_CARD
10201 Kart, işleme izin vermedi CARD_NOT_PERMITTED
10202 Ödeme işlemi esnasında genel bir hata oluştu UNKNOWN
10203 Önceden onaylanan işlem APPROVED_COMPLETED
10204 Ödeme işlemi esnasında genel bir hata oluştu UNKNOWN
10205 E-posta geçerli formata değil INVALID_CHARS_IN_EMAIL
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
10212 CVC2 yanlış girme deneme sayısı aşıldı CVC2_MAX_ATTEMPT
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
10218 Banka kartları ile taksit yapılamaz DEBIT_CARDS_INSTALLMENT_NOT_ALLOWED
10219 Bankaya gönderilen istek zaman aşımına uğradı REQUEST_TIMEOUT
10220 Ödeme alınamadı DECLINED
10221 Terminal yurtdışı kartlara kapalı NOT_PERMITTED_TO_FOREIGN_CARD
10222 Terminal taksitli işleme kapalı NOT_PERMITTED_TO_INSTALLMENT
10223 Gün sonu yapılmalı REQUIRES_DAY_END
10224 Para çekme limiti aşılmış EXCEEDS_WITHDRAWAL_AMOUNT_LIMIT
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
10230 İstek bankadan hata aldı REQUEST_BLOCKED_BY_BANK
10231 Satış tutarı ödül puanından düşük olamaz SALES_AMOUNT_LESS_THAN_AWARD
10232 Geçersiz tutar INVALID_AMOUNT
10233 Geçersiz kart tipi INVALID_CARD_TYPE
10234 Yetersiz ödül puanı NOT_SUFFICIENT_AWARD
10235 American Express kart hatası AMEX_CAN_USE_ONLY_MR
10236 Ödeme işlemi esnasında genel bir hata oluştu UNKNOWN