Hata Kodları

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