İçindekiler
Sanal POS hata kodları, bir kart işlemi tamamlanmadığında bankanın geri gönderdiği iki haneli yanıt kodlarıdır. Ödeme ekranında gördüğünüz “Red 05” ya da “Red 57” gibi ifadeler bu kodlardan gelir; her red kodu işlemin neden reddedildiğini tarif eder.
Bu kodlar, kartlı ödeme sistemlerinde kullanılan ISO 8583 mesajlaşma standardına dayanır. Bu nedenle aynı kod, farklı bankalarda ve sanal POS altyapılarında büyük ölçüde aynı anlamı taşır.
Bu yazıda en sık karşılaşılan sanal POS hata kodları ve çözümlerine ulaşabilirsiniz.
Sanal POS Hata Kodu Nedir? Nasıl Çalışır?
Bir tahsilat denemesinde ödeme altyapınız, kart bilgilerini kartı çıkaran bankaya iletir. Banka işlemi değerlendirir ve geriye bir yanıt kodu döner. “00” onay anlamına gelir; diğer tüm kodlar işlemin neden ilerlemediğini anlatır.
Bu yanıt saniyeler içinde gelir ve ödeme sayfasında kısa bir mesaja dönüştürülür. Mesajın yalnızca ham kod biçiminde gösterilmesi, kullanıcının sorunun nedenini ve atması gereken adımı anlayamamasına yol açabilir. Bu durum, ödeme sürecinin tamamlanmadan sonlandırılması riskini artırır.
Hata Kodu Nereden Üretilir? Kart mı, Banka mı, Sistem mi?
Kodları incelemeden önce hatanın kaynağını belirlemek gerekir. İzlenecek çözüm yolu buna göre değişir.
- Kart sahibinin bankasından kaynaklanan hatalar: Red 05, 51, 57, 62 ve 75 bu gruba girer. Banka; bakiye, limit, işlem izni veya güvenlik kuralları nedeniyle işlemi onaylamayabilir. Bu durumlarda kart sahibinin bankasıyla iletişime geçmesi gerekir.
- POS yetkilerinden kaynaklanan hatalar: Red 58 bu grubun tipik bir örneğidir. İşlem türü, taksit seçeneği, para birimi veya kart markası işletmenin sanal POS tanımında yetkilendirilmemiş olabilir. Yetki tanımlarının işletme ve ödeme hizmeti sağlayıcısı tarafından kontrol edilmesi gerekir.
- Entegrasyon veya veri girişinden kaynaklanan hatalar: Red 12, 14 ve 82 bu grupta değerlendirilir. Yanlış parametre, hatalı işlem akışı veya eksik kart bilgisi söz konusu olabilir. Hatanın niteliğine göre entegrasyonun kontrol edilmesi ya da kart bilgilerinin yeniden girilmesi gerekir.
- Sistem kaynaklı hatalar: Red 91 ve benzeri kodlar bankaya geçici olarak ulaşılamadığını gösterir. İşlem, kısa bir süre sonra yeniden denenebilir.
Bu sınıflandırma, hata koduna göre hangi tarafın aksiyon alması gerektiğini belirlemeyi kolaylaştırır.
En Sık Karşılaşılan Sanal POS Hata Kodları Listesi
| Kod | Anlamı | Neden alınır? | Kim aksiyon almalı? |
|---|---|---|---|
| 05 | Genel red (Do Not Honor) | Banka gerekçe bildirmeden reddeder | Kart sahibi / banka |
| 12 | Geçersiz işlem | Desteklenmeyen işlem türü veya hatalı akış | İşletme / geliştirici |
| 14 | Geçersiz kart numarası | Kart numarası hatalı girilmiş | Kart sahibi |
| 41 / 43 | Kayıp veya çalıntı kart | Karta kayıp-çalıntı bildirimi yapılmış | İşlem yapılmamalı |
| 51 | Yetersiz bakiye | Limit veya bakiye işlem tutarını karşılamıyor | Kart sahibi |
| 54 | Kartın süresi dolmuş | Son kullanma tarihi geçmiş | Kart sahibi |
| 57 | Kart sahibine bu işlem izni yok | İnternet veya mail order işlemine kapalı kart | Kart sahibi / banka |
| 58 | Terminale açık olmayan işlem | POS tanımında ilgili işlem türü yetkili değil | İşletme / sağlayıcı |
| 62 | Kısıtlı kart | Kart belirli işlem türlerine kısıtlanmış | Kart sahibi / banka |
| 75 | Şifre deneme sayısı aşıldı | Hatalı şifre denemesi sınırı aşılmış | Kart sahibi / banka |
| 82 | Hatalı CVV | Güvenlik kodu yanlış girilmiş | Kart sahibi |
| 91 | Bankaya ulaşılamıyor | Banka sistemlerinde geçici kesinti | Kısa süre sonra yeniden denenmeli |
| 94 | Yinelenen işlem | Aynı istek birden fazla gönderilmiş | İşletme / geliştirici |
Tablonun son sütunu, çözüm sürecini kimin yürütmesi gerektiğini gösterir. Kodun anlamının yanı sıra doğru aksiyon sahibinin belirlenmesi, sorunun daha hızlı sonuçlandırılmasını sağlar.
Red 05 Hata Kodu Nedir? (İzin Verilmedi / Genel Red)
ISO 8583’te “Do Not Honor” olarak tanımlanan 005 hata kodu, kartı çıkaran bankanın gerekçe bildirmeden işlemi reddettiği anlamına gelir. Sık karşılaşılan bu kod, ret nedenine ilişkin ayrıntılı bilgi sağlamaz.
Bu yanıt; limit yetersizliği, kartın internet veya yurt dışı işlemlerine kapalı olması ya da bankanın risk değerlendirmesi gibi farklı nedenlerden kaynaklanabilir. Kesin neden yalnızca kartı çıkaran banka tarafından açıklanabileceği için kart sahibinin bankasıyla iletişime geçmesi önerilir.
Red 57 / Hata Kodu 57 Nedir? (İşlem Tipine İzin Yok)
ISO 8583 karşılığı “Transaction not permitted to cardholder” olan hata kodu 57, kart sahibinin o işlem türü için bankasında tanımlı yetkisi olmadığını gösterir. Türkiye’de en yaygın nedeni kartın internet veya mail order işlemlerine kapalı olmasıdır.
Red 57 ile Red 58 farklı kaynaklara işaret eder: 57 kart sahibinin işlem yetkisiyle, 58 ise iş yerinin POS yetkileriyle ilgilidir. Kartın internet işlemlerine kapalı olması durumunda kart sahibi, bankasının mobil uygulamasından ilgili izni açabilir veya bankasıyla iletişime geçebilir.
Red 51 / Hata Kodu 51 Nedir? (Yetersiz Bakiye)
Red 51, kartın kullanılabilir limitinin veya hesap bakiyesinin işlem tutarını karşılamadığını gösterir.
Müşteriye farklı bir kart kullanma, uygunsa taksit sayısını değiştirme veya alternatif bir ödeme yöntemine yönelme seçenekleri sunulabilir.
Red 58 / Hata Kodu 58 Nedir? (Terminale Açık Olmayan İşlem)
058 hata kodu, ISO 8583’te “Transaction not permitted to terminal” olarak geçer. Kod, ilgili işlem türünün iş yerinin sanal POS tanımında yetkilendirilmediğini gösterir.
Yaygın nedenler arasında anlaşmada tanımlı olmayan bir taksit sayısının kullanılması, döviz cinsinden tahsilat denenmesi veya sözleşme kapsamında bulunmayan bir kart markasının kabul edilmeye çalışılması yer alır. Hata farklı kartlarla da tekrarlanıyorsa sanal POS yetki tanımlarının kontrol edilmesi gerekir.
Hata Kodu 12 Nedir? (Geçersiz İşlem)
012 hata kodu, gönderilen işlemin banka tarafından tanınmadığını gösterir. Genellikle entegrasyon kaynaklıdır: yanlış işlem tipi gönderilmiş, provizyon ve satış akışı hatalı sıralanmış ya da anlaşma kapsamında olmayan bir taksit denenmiştir.
Red 12 hata kodu birden fazla işlemde tekrarlanıyorsa entegrasyon kaynaklı bir sorun olasılığı değerlendirilmelidir. İşlem parametreleri, ödeme hizmeti sağlayıcısının dokümantasyonuna göre kontrol edilmelidir.
Hata Kodu 75 Nedir? (Şifre Deneme Sayısı Aşıldı)
75 kodu, kart sahibinin izin verilen şifre deneme sayısını aştığını gösterir. Bir güvenlik önlemidir ve kart geçici olarak kilitlenir.
Kart sahibinin bankasıyla iletişime geçerek şifre deneme hakkını yeniden etkinleştirmesi gerekir. Ödeme sayfasında, kartın geçici olarak kullanıma kapatılmış olabileceğini ve kart sahibinin bankasıyla iletişime geçmesi gerektiğini belirten açıklayıcı bir mesaj gösterilmelidir.
Hata Kodu 82 Nedir? (Hatalı CVV)
82 kodu, kartın arka yüzündeki üç haneli güvenlik kodunun yanlış girildiğini gösterir. Kart sahibi güvenlik kodunu kontrol edip doğru bilgiyi girdikten sonra işlemi yeniden deneyebilir.
Bu kodun sık görülmesi durumunda ödeme formunun kullanılabilirliği incelenmelidir. CVV bilgisinin kart üzerinde nerede bulunduğunu gösteren kısa bir açıklama veya görsel, hatalı girişleri azaltmaya yardımcı olabilir.
Hata Kodu 62 Nedir? (Kısıtlı Kart)
62 kodu, kartın belirli işlem türlerine veya bölgelere kısıtlandığını gösterir. Kurumsal kartlarda harcama kategorisi kısıtı, bireysel kartlarda yurt dışı işlem kısıtı en yaygın nedenlerdir.
Kısıtlama yalnızca kartı çıkaran banka tarafından kaldırılabilir. Bu nedenle kart sahibinin bankasıyla iletişime geçmesi gerekir.
Sanal POS Hata Kodlarını Müşterilere Nasıl Anlatmalısınız?
Hata kodlarının doğru yönetilmesi, teknik destek sürecinin yanı sıra ödeme deneyimini ve işlem tamamlama oranını da etkiler. Ödeme ekranında yalnızca ham kodu göstermek yerine kullanıcıya izleyebileceği adımı açıklamak, gereksiz sepet terklerini azaltabilir.
Bu süreçte üç temel ilke uygulanabilir:
- Kodu değil, izlenecek adımı açıklayın. “Red 51” ifadesi yerine “Kartınızın kullanılabilir limiti bu işlem için yeterli olmayabilir. Farklı bir kart deneyebilir veya uygun olması hâlinde taksit seçeneklerini değiştirebilirsiniz.” gibi yönlendirici bir mesaj kullanılabilir.
- Doğru tarafa yönlendirin. Kart kaynaklı kodlarda (05, 51, 57, 62, 75) kart sahibinin bankasıyla iletişime geçmesi gerekir. Terminal kaynaklı kodlarda (58) ise işletmenin sanal POS yetkilerini ödeme hizmeti sağlayıcısıyla birlikte kontrol etmesi gerekir.
- Alternatif ödeme yöntemleri sunun. Ödeme reddedildiğinde farklı kart, havale veya kapıda ödeme gibi kullanılabilir seçenekler aynı ekranda gösterilebilir. Böylece kullanıcı, satın alma sürecine başka bir yöntemle devam edebilir.
Sıkça Sorulan Sorular
Sanal POS’ta red 05 hatası neden alınır?
Red 05, kartı çıkaran bankanın gerekçe bildirmeden işlemi reddettiği genel red kodudur. Limit yetersizliği, kartın internet işlemlerine kapalı olması veya bankanın güvenlik değerlendirmesi bu yanıta neden olabilir. Kod bankadan geldiği için kart sahibinin bankasıyla iletişime geçmesi önerilir.
Hata kodu 57 nasıl çözülür?
Hata kodu 57, kart sahibinin o işlem türü için bankasında yetkisi olmadığını gösterir. En yaygın nedeni kartın internet veya mail order işlemlerine kapalı olmasıdır. Müşterinin bankasının mobil uygulamasından internet işlem iznini açması ya da bankasını araması gerekir.
Müşteri bir hata koduyla karşılaştığında ne yapılmalı?
Öncelikle kodun kaynağı belirlenmelidir. 05, 51, 57, 62 ve 75 kart veya kartı çıkaran banka kaynaklıdır; kart sahibi bankasına yönlendirilmelidir. 58, iş yerinin POS yetki tanımlarıyla ilgilidir ve ödeme hizmeti sağlayıcısıyla görüşülmesini gerektirir. 12 entegrasyonla, 14 ve 82 ise kart bilgilerinin girişiyle ilişkili olabilir. Her durumda kullanıcıya yalnızca ham kod değil, izleyebileceği çözüm adımı gösterilmelidir.
Sanal POS ile fiziksel POS hata kodları aynı mıdır?
Büyük ölçüde aynıdır, çünkü ikisi de ISO 8583 standardındaki yanıt kodlarını kullanır. Fark kodların görülme sıklığındadır: sanal POS’ta kart fiziksel olarak ibraz edilmediği için 57, 82 ve 3D Secure kaynaklı redler daha sık; fiziksel POS’ta ise cihaz ve bağlantı kaynaklı kodlar öne çıkar.
Hata kodu 58 (terminale açık olmayan işlem) ne demek?
58 kodu, denenen işlem türünün iş yerinin POS tanımında yetkilendirilmediğini gösterir. Anlaşmada bulunmayan bir taksit sayısı, döviz cinsinden tahsilat veya kapsam dışı bir kart markası tipik nedenlerdir. İlgili yetki tanımlarının ödeme hizmeti sağlayıcısı tarafından kontrol edilmesi gerekir.
Sanal POS hata kodları nasıl önlenir?
Kart kaynaklı retler işletmenin kontrolü dışında olduğu için sanal POS hatalarının tamamı önlenemez. Bununla birlikte entegrasyon ve terminal kaynaklı hatalar azaltılabilir: canlıya geçmeden önce tüm işlem senaryoları test edilmeli, taksit ve kart markası yetkileri güncel tutulmalı, ödeme formundaki CVV ve son kullanma tarihi alanları açık biçimde belirtilmelidir.