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 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.

iyzico, hata kodlarını gruplara ayırmaktadır. Banka Hata Kodları kodları 10000 ile başlarken, Kart Saklama Hata Mesajları 3000 ile başlamaktadır.

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.a

Kod	Açıklama
1	Sistem hatası oluştu
2	Sistem hatası oluştu
3	email gönderilmesi zorunludur
4	email en fazla {0} karakter olmalıdır
5	email hatalı format ile gönderilmiştir
6	request objesi gönderilmesi zorunludur
7	{0} için gönderilen tarih formatı hatalı
8	identityNumber gönderilmesi zorunludur
9	identityNumber en fazla {0} karakter olmalıdır
10	identityNumber en az {0} karakter olmalıdır
11	Geçersiz istek
12	Kart numarası geçersizdir
13	expireMonth geçersizdir
14	expireYear geçersizdir
15	cvc geçersizdir
16	cardHolderName gönderilmesi zorunludur
17	Kartınızın son kullanma tarihi geçersizdir
18	identityNumber {0} hatalı format ile gönderilmiştir
19	cardHolderName en fazla {0} karakter olmalıdır
20	conversationId en fazla {0} karakter olmalıdır
21	cardAlias en fazla {0} karakter olmalıdır
22	IP en fazla {0} karakter olmalıdır
23	Callback url gönderilmesi zorunludur
24	{0} gönderilmesi zorunludur
25	gsmNumber gönderilmesi zorunludur
26	gsmNumber en fazla {0} karakter olmalıdır
27	Geçersiz telefon numarası
28	Metadata Formatı Geçersiz
29	claimToken gönderilmesi zorunludur
30	memberId gönderilmesi zorunludur
31	conversationId zararlı kod içeriyor olabilir

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.

Kod	Açıklama
1000	Geçersiz imza
1001	api bilgileri bulunamadı
1002	Üye işyeri bulunamadı
1003	Yetkilendirme hatası
1004	Random string gönderilmesi zorunludur
1005	Request objesi gönderilmesi zorunludur
1006	api key gönderilmesi zorunludur
1007	Signature gönderilmesi zorunludur
1008	Authorization header prefix bulunamadı
1009	Authorization header string gönderilmesi zorunludur
1010	Gateway üye işyeri bulunamadı
1011	Authorize edilen üye işyeri ile üye iş yeri numarası uyuşmuyor
1012	Aktif platform bulunamadı
1013	Uygulama adıyla eşleşen kullanıcı bulunamadı
1014	Güvenlik bilgileri bulunamadı
1015	Uygulama adı gönderilmesi zorunludur

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.

Kod	Açıklama
2000	Bu servis sadece pazaryeri müşterilerine açıktır
2001	Alt üye işyeri bulunamadı
2002	Alt üye işyeri bulunmaktadır
2003	subMerchantKey gönderilmesi zorunludur
2004	subMerchantType gönderilmesi zorunludur
2005	Iban gönderilmesi zorunludur
2007	subMerchantExternalId gönderilmesi zorunludur
2008	subMerchantExternalId en fazla {0} karakter olmalıdır
2009	address gönderilmesi zorunludur
2010	address en fazla {0} karakter olmalıdır
2011	address en az {0} karakter olmalıdır
2012	contactName gönderilmesi zorunludur
2013	contactName en fazla {0} karakter olmalıdır
2014	contactName en az {0} karakter olmalıdır
2015	contactSurname gönderilmesi zorunludur
2016	contactSurname en fazla {0} karakter olmalıdır
2017	contactSurname en az {0} karakter olmalıdır
2018	taxOffice gönderilmesi zorunludur
2019	taxOffice en fazla {0} karakter olmalıdır
2020	taxOffice en az {0} karakter olmalıdır
2021	legalCompanyTitle gönderilmesi zorunludur
2022	legalCompanyTitle en fazla {0} karakter olmalıdır
2023	legalCompanyTitle en az {0} karakter olmalıdır
2024	taxNumber gönderilmesi zorunludur
2025	taxNumber en fazla {0} karakter olmalıdır
2026	taxNumber en az {0} karakter olmalıdır
2027	taxOffice {0} alfabetik karakterlerden oluşmalıdır
2028	name en fazla {0} karakter olmalıdır
2029	gsmNumber en fazla {0} karakter olmalıdır
2030	Gönderilen iban hatalı formattadır
2031	contactName {0} alfabetik karakterlerden oluşmalıdır
2032	contactSurname {0} alfabetik karakterlerden oluşmalıdır
2033	legalCompanyTitle {0} alfabetik ve nümerik karakterlerden oluşmalıdır
2034	gsmNumber alfabetik karakter içermemelidir
2035	taxNumber nümerik karakterlerden oluşmalıdır
2036	Swiftcode gönderilmesi zorunludur
2037	Alt üye işyeri banka hesap kuru, üye işyeri yerel banka hesap kuruyla aynı olmalıdır
2038	Türk lirası hesaplarının ibanları TR ile başlamalıdır
2039	Swiftcode en fazla {0} karakter olmalıdır
2040	Geçersiz Para Gönderimi Açıklaması

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.

Kod	Açıklama
3000	externalId en fazla {0} karakter olmalıdır
3001	cardUserKey gönderilmesi zorunludur
3002	cardToken gönderilmesi zorunludur
3003	card bilgisi gönderilmesi zorunludur
1401	Kart numarası gönderilmesi zorunludur
3014	merchantId bilgisi gönderilmesi zorunludur
3015	changeManagementId bilgisi gönderilmesi zorunludur
3016	anonymizationType bilgisi gönderilmesi zorunludur
3022	toMerchantId bilgisi gönderilmesi zorunludur
3004	Kart saklama sırasında hata oluştu
3005	cardUserKey bulunamadı
3006	cardToken bulunamadı
3007	Kart saklama özelliği tanımlı değil
3008	Encryption hatası
3009	Decryption hatası
3010	Kart bulunamadı
3011	Card user key eşleşmedi
3012	Email kart numarası içeremez
3013	externalId kart numarası içeremez
3017	Kart anonimleştirme sırasında bir hata oluştu.
3018	Kart saklama blacklist özelliği tanımlı değil
3019	Aktif blacklist bulunamadı
3020	Aktif blacklist zaten mevcut.
3021	Kart user güncellemesi sırasında bir hata oluştu.

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

Kod	Açıklama
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.