Ödeme işlemleri sırasında terminalin döndürdüğü yanıt kodları, başarısız işlemin nedenini hızlıca anlamayı sağlar. Sanal POS hata kodları; bankanın, kart şemasının ya da ödeme ağının sisteme ilettiği standart ret mesajlarıdır ve her kod farklı bir senaryoya karşılık gelir.

Kart sahibi için doğru adımı atmanın, işyeri için ise teknik süreçleri sağlıklı yönetmenin ilk koşulu bu kodları doğru okumaktır. Aşağıda en sık karşılaşılan pos hata kodları, diğer önemli ret kodları ve güncel bir referans tablosu bir arada sunulmaktadır.

En Sık Karşılaşılan Kritik POS Hata Kodları

POS işlemlerinde belirli hata kodları diğerlerine kıyasla çok daha sık karşımıza çıkar. Her birinin farklı bir nedeni ve çözüm yolu vardır.

Hata Kodu 05 – Do Not Honour

Kredi kartı red kodları arasında en yaygın olanlardan biridir. Bankanın genel ret kararını ifade eder; yetersiz limit, şüpheli işlem tespiti ya da geçici hesap kısıtlaması bu kodun başlıca tetikleyicileridir.

Kart sahibinin bankasını arayarak ret nedenini öğrenmesi ve gerekirse işlemi daha sonra yeniden denemesi önerilir. 05 hata kodu zaman içinde kendiliğinden çözülebileceği gibi banka onayıyla da giderilebilir.

Hata Kodu 51 – Yetersiz Bakiye

Kart sahibinin hesabında ya da kredi kartı limitinde yeterli fon bulunmadığını gösterir. Çözüm yolu doğrudandır: hesaba para yüklenmesi ya da limiti yeterli farklı bir kartla işlemin yeniden denenmesi gerekir.

Sanal pos entegrasyon hataları arasında sıklıkla kayıt altına alınan bu kod, işyeri tarafında herhangi bir yapısal sorunun göstergesi değildir.

Hata Kodu 57 – İzin Verilmeyen İşlem

Hata kodu 57, kullanılan kartın söz konusu işlem tipinde ya da işyeri kategorisinde kullanılmasına izin verilmediğini ifade eder. Kurumsal kartların bireysel harcama kategorilerinde kullanılmaya çalışılması ya da yalnızca belirli sektörlere tanımlı kartların farklı bir MCC kodu altındaki işlemde denenmesi bu koda yol açabilir.

Hata Kodu 58 – Terminal'de Tanımlı Değil

Hata kodu 58, işlem tipinin terminalde tanımlı olmadığını ya da o terminalde izin verilmediğini gösterir. Taksit seçeneklerinin terminal konfigürasyonuyla uyumsuz olduğu durumlarda sıkça karşılaşılır. Terminal yazılımının güncellenmesi ya da işyeri servis sağlayıcısıyla iletişime geçilmesi sorunu çözer.

Hata Kodu 093 – Mevzuat veya Kampanya Uyumsuzluğu

Pos return codes listesinde özel bir konuma sahip olan 093, işlemin kural ihlali nedeniyle reddedildiğini bildirir. Taksit kısıtlamalarına tabi ürün kategorilerinde taksitli işlem denenmesi, kampanya koşullarına uymayan kart kullanımı ya da bölgesel kısıtlamalar bu kodu tetikler.

093 hata kodunun tüm nedenleri ve çözüm adımları için iyzico hata kodları sayfasındaki teknik dokümantasyona başvurulabilir.

Diğer Önemli Hata Kodları ve Anlamları

Sanal pos hata mesajları yalnızca yukarıdaki beş kodla sınırlı değildir. Aşağıda kendi detay sayfası bulunmayan ancak işlem süreçlerinde önemli bir yere sahip olan kodlar açıklanmaktadır.

Hata Kodu 41 ve 43 – Kayıp veya Çalıntı Kart

Kod 41, kartın kayıp bildirildiğini; 43 ise çalıntı olarak işaretlendiğini gösterir. Her iki durumda da işlem reddedilir ve fiziksel POS ortamında karta el konulması gerekebilir. Kredi kartı ret nedenleri arasında güvenlik kaynaklı en ciddi kategoride yer alır.

Hata Kodu 54 – Süresi Dolmuş Kart

Kartın son kullanma tarihinin geçtiğini ifade eder. Çözüm için kart sahibinin bankasından yeni kart talep etmesi gerekir. İşyeri tarafında yapılabilecek bir müdahale yoktur.

Hata Kodu 91 – Banka veya Ağ Erişilemiyor

Kart veren bankanın ya da ödeme ağının erişilemez olduğunu ya da zaman aşımına uğradığını gösterir. Geçici bir bağlantı sorunudur; işlemi birkaç dakika sonra yeniden denemek çoğunlukla yeterlidir.

Hata Kodu 96 – Sistem Arızası

Genel bir sistem ya da ağ arızasına işaret eder. Provision error codes arasında altyapı kaynaklı olanların başında gelir. Sorun işyerinden ya da üye iş yeri servis sağlayıcısından kaynaklanıyor olabilir; teknik destek hattına başvurmak gerekebilir.

Hata Kodu 99 – Tanımsız Hata

Bankaya özgü ya da standart şema içinde karşılığı olmayan genel hata kodudur. Pos cihazının hata vermesi durumlarında 99 kodu görülüyorsa bankayla doğrudan iletişime geçmek en etkili çözüm yoludur.

Güncel Sanal POS Hata Kodları Listesi

Aşağıdaki tablo, pos hata kodları tablosunu ve her kodun kısa açıklamasını bir arada sunmaktadır. Geliştiriciler, entegrasyon ekipleri ve işyeri sahipleri için hızlı başvuru kaynağı olarak tasarlanmıştır.

Tablodaki kodların tamamına ait teknik detaylar ve entegrasyon örnekleri için iyzico hata kodları dokümantasyon sayfası incelenebilir.

Sanal POS Hata Oranları Nasıl Düşürülür?

Kredi kartı red kodlarının sıklığını azaltmak, hem dönüşüm oranlarını artırır hem de müşteri deneyimini iyileştirir. İşyeri tarafında uygulanabilecek başlıca önlemler şunlardır:

• Terminal ve entegrasyon yazılımını güncel tutun: Eski sürümler, yeni kart şeması kurallarıyla uyumsuzluğa yol açabilir.
• MCC kodunun doğruluğunu periyodik olarak teyit edin: Yanlış kategori kodu, 57 ve 58 gibi ret kodlarının temel nedenlerinden biridir.
• Taksit kısıtlamalarına uygun konfigürasyon yapın: BDDK düzenlemelerine göre taksit uygulanamayan kategorilerde taksit seçeneğini devre dışı bırakın.
• Hata kodlarını düzenli olarak raporlayın: Hangi kodun ne sıklıkta göründüğünü takip etmek, sistemsel sorunları erken tespit etmeyi sağlar.
• 3D Secure kullanımını zorunlu kılın: Güvenlik katmanı eklenmesi, şüpheli işlem kaynaklı ret oranlarını önemli ölçüde azaltır.
• Müşterilere hata anında yönlendirici mesaj gösterin: Hatanın nedenini basit bir dille açıklamak, terk oranını düşürür.

Entegrasyon altyapısını güçlendirmek isteyen işyerleri sanal pos çözümleriyle ödeme akışını daha stabil bir temele oturtabilir.

Yüz yüze satış kanalında da hata oranlarını azaltmak isteyenler için fiziki pos başvurusu sürecinde doğru terminal konfigürasyonu kritik bir adımdır.

Sanal POS Hata Kodu Aldığımda Ne Yapmalısınız?

Hata kodu alındığında yapılacak ilk iş, kodun kaynağını doğru belirlemektir. Aynı hata hem kart sahibini hem de işyerini ilgilendiriyor olabilir; doğru tarafın harekete geçmesi süreci kısaltır.

Kart Sahibi Ne Yapmalı?

• Hata kodunu not alın ve bankanızın müşteri hizmetlerini arayarak nedenini sorun.
• Taksit seçeneği kaldırılarak işlem tek çekim olarak tekrar denenebilir.
• Kartın yurt dışı kullanımı, online alışveriş ya da belirli sektörlere kapalı olup olmadığını internet bankacılığından kontrol edin.
• Kart bilgilerinin (numara, son kullanma tarihi, CVV) doğru girildiğini teyit edin.
• Sorun devam ediyorsa farklı bir kart ya da ödeme yöntemi tercih edin.

İşyeri Ne Yapmalı?

• Hata kodunu kayıt altına alın ve sıklığını izleyin; tekrarlayan kodlar sistemsel bir soruna işaret edebilir.
• Terminal yazılımının güncel olduğunu ve MCC kodunun doğru tanımlandığını kontrol edin.
• Taksit kısıtlamalarıyla çelişen bir konfigürasyon olup olmadığını gözden geçirin.
• Ödeme altyapısı sağlayıcınızın teknik destek hattına başvurarak log kayıtlarını inceleyin.
• Sanal pos entegrasyon hataları söz konusuysa API dokümantasyonu üzerinden hata kodunun tanımını ve önerilen işlem akışını doğrulayın.

Teknik dokümantasyona ve hata kodu referans listesine ulaşmak için iyzico hata kodları sayfası ziyaret edilebilir.