Links

Hata Kodları

Genel Bakış

iyzico ödeme API'sinde banka tarafından geri gönderilen hata mesajları 10.000'ler ile başlamaktadır. En yaygın hata kodları, 10005 gibi hata kodunun başına 10.000 eklenerek anında döndürülür. 10.000'den küçük hata kodları, API tarafından döndürülen doğrulama veya business hata kodları olarak adlandırılır.
Status parametresinin "failure" değerine sahip olmasıyla belirtilen bir hata oluştuğunda, iyzico ödeme API'si şu şekilde yanıt verir:
  • errorCode: örneğin 10051
  • errorGroup: örneğin NOT_SUFFICIENT_FUNDS
  • errorName: örneğin Error
  • errorMessage: örneğin Kart limiti yetersiz, yetersiz bakiye
Bankaya bağlı olarak bazı anahtar/değer çiftleri yetersiz yanıt verebilir.
Aşağıdaki liste en çok bilinen hata gruplarından oluşmaktadır;
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
Last modified 7mo ago