Sanal Pos Hata Kodları: Anlamları ve Çözüm Yöntemleri
Online tahsilat işlemlerinde sanal POS hata kodlarının anlamları, en pratik çözüm adımları ve tekrar etmemesi için önleyici öneriler. Güncellendi:
Hata Kodu Tablosu (Hızlı Bakış)
En sık görülen kodları hızlıca kontrol etmek için tabloyu kullanın. Detaylı açıklamalar ve adım adım çözümler bir alt bölümde.
| Kod | Kısa Açıklama | Önerilen Çözüm |
|---|---|---|
| 01 | Banka onaylamadı | Kart sahibi bankasıyla görüşmeli |
| 04 | Kart blokeli/alıkonulmalı | Bankayla iletişim |
| 05 | İşlem reddedildi (genel) | Limit/güvenlik kontrolü |
| 12 | Geçersiz işlem | Entegrasyon/işlem tipi kontrolü |
| 13 | Geçersiz tutar | Tutarı düzeltin |
| 14 | Geçersiz kart numarası | Kart bilgilerini doğrulayın |
| 30 | Biçim/alan hatası | Alan/format doğrulaması |
| 41 | Kayıp kart | Yeni kart talebi |
| 43 | Çalıntı kart | İşlem yapılmaz, banka |
| 51 | Yetersiz bakiye | Bakiye ekleyin/başka kart |
| 54 | S.K.T. geçmiş | Yeni kart kullanın |
| 55 | Hatalı PIN | Doğru PIN, blokeye dikkat |
| 57 | İşlem izni yok (kart) | İnternet iznini açtırın |
| 58 | İşlem izni yok (POS) | Üye işyeri yetki kontrolü |
| 61 | Limit aşıldı | Tutarı düşürün/limit artırın |
| 62 | Kısıtlı kart (bölge/tip) | Kart kısıtını kaldırın |
| 65 | İşlem sayısı/limit aşıldı | Daha sonra deneyin |
| 75 | PIN deneme sayısı aşıldı | Kart bloke, banka |
| 91 | Banka yanıt vermiyor | Biraz sonra tekrar |
| 92 | Geçersiz banka/yol | Kart/banka doğrulama |
| 94 | Yinelenen işlem | Kayıtları kontrol edin |
| 96 | Sistem hatası | Tekrar deneyin, destek |
Sanal Pos Hata Kodları – Detay, Açıklamalar ve Çözüm Yöntemleri
01 – Banka Onaylamadı
Anlam: Banka güvenlik/riske bağlı olarak işlemi reddetti.
Çözüm: Kart sahibi, bankasıyla iletişime geçerek internet/uluslararası işlem izinlerini ve güvenlik blokelerini kontrol etmelidir. Üye işyeri tarafı, tutar ve para birimini doğrulamalıdır.
04 – Kart Blokeli / Alıkonulmalı
Anlam: Kart kayıp-çalıntı bildirimi veya ağır güvenlik şüphesi.
Çözüm: İşlem yapılmamalı. Kart sahibi bankadan yeni kart talep etmelidir.
05 – İşlem Reddedildi (Genel Ret)
Anlam: Kart ya da hesap uygun değil, bankanın genel reddi.
Çözüm: Limit, internet izni, bölge kısıtı ve güvenlik kontrolleri. Devam ederse kart/banka ile görüşülmeli.
12 – Geçersiz İşlem
Anlam: İşlem tipi bankaca desteklenmiyor (ör. yanlış capture/refund akışı).
Çözüm: Entegrasyon parametreleri ve iş akışını (Auth, Capture, Void, Refund) bankanın dökümantasyonuna göre düzeltin.
13 – Geçersiz Tutar
Anlam: Tutar 0/negatif veya üye işyeri/banka limitlerini aşıyor.
Çözüm: Tutar formatı (ondalık, para birimi) ve limitleri doğrulayın.
14 – Geçersiz Kart Numarası
Anlam: PAN hatalı veya tanınmıyor.
Çözüm: Kart bilgileri yeniden girilmeli; maskeleme/format/boşluk sorunları için frontend doğrulaması ekleyin.
30 – Biçim/Alan Hatası
Anlam: Alan adları, uzunluklar veya kodlama hatalı.
Çözüm: API şemasını takip edin; ISO tarih/para formatı, 3D sonucu, taksit/para birimi kodlarını doğrulayın.
41 – Kart Kayıp
Anlam: Kayıp bildirimi olan kart kullanımı.
Çözüm: İşlem reddedilmeli; kart sahibi bankayla görüşür.
43 – Kart Çalıntı
Anlam: Çalıntı olarak işaretlenen kart.
Çözüm: İşlem yapılmaz; kart sahibi bankayla iletişime geçer.
51 – Yetersiz Bakiye
Anlam: Hesapta yeterli bakiye yok.
Çözüm: Bakiye yükleme veya farklı kart. Taksit tutarı/ön provizyon kontrolleri.
54 – Kartın Son Kullanma Tarihi Geçmiş
Anlam: Kart süresi dolmuş.
Çözüm: Güncel son kullanma tarihi olan kartla deneyin.
55 – Hatalı PIN
Anlam: Yanlış PIN girildi.
Çözüm: Doğru PIN kullanın; tekrar eden hatalarda bloke riski.
57 – İşlem İzni Yok (Kart)
Anlam: Kart, e-ticaret/uluslararası işleme kapalı.
Çözüm: Banka mobil uygulamasından internet ve yurtdışı iznini açtırın.
58 – İşlem İzni Yok (POS/Üye İşyeri)
Anlam: Üye işyeri yetkileri bu işlem için kapalı.
Çözüm: Bankanızdan işyeri kodu yetkilerini (taksit, para birimi, mail order vb.) açtırın.
61 – Limit Aşıldı
Anlam: Tutar kart veya işlem limitlerini aşıyor.
Çözüm: Tutarı düşürün; günlük/aylık limitleri kontrol edin.
62 – Kısıtlı Kart (Bölge/Tür)
Anlam: Kart belirli bölge/işlem türlerine kapalı.
Çözüm: Bölge/kategori kısıtlarını bankadan kaldırın.
65 – İşlem Sayısı/Limit Aşıldı
Anlam: Kart için tanımlı işlem adedi/limit aşıldı.
Çözüm: Daha sonra deneyin veya limit artırımı talep edin.
75 – PIN Deneme Sayısı Aşıldı
Anlam: Çoklu yanlış PIN; kart bloke olabilir.
Çözüm: Banka ile bloke kaldırma.
91 – Banka Yanıt Vermiyor
Anlam: Banka sistemleri geçici olarak erişilemiyor.
Çözüm: Kısa süre sonra tekrar deneyin; planlı bakım/yoğunluk olabilir.
92 – Geçersiz Banka/İletim Yolu
Anlam: Kartın bankası tanınmıyor veya yönlendirme hatası.
Çözüm: Kart BIN’i, para birimi ve yönlendirme ayarlarını kontrol edin.
94 – Yinelenen İşlem
Anlam: Aynı işlem birden fazla gönderildi.
Çözüm: Sipariş/ödeme kayıtlarını karşılaştırın; müşteriyi bilgilendirin; gerekirse iade/iptal yapın.
96 – Banka Sistem Hatası
Anlam: Genel teknik hata.
Çözüm: Bir süre sonra deneyin; sık oluyorsa banka/PSP teknik destek ile log paylaşın.
Tekrar Etmemesi İçin Önleyici Öneriler
- 3D Secure Zorunluluğu: Fraud ve ret oranlarını düşürür; bankanın risk filtrelerini geçmeyi kolaylaştırır.
- Ön Uç Doğrulama: Kart numarası Luhn kontrolü, S.K.T. ve CVC alan doğrulamaları.
- Doğru İş Akışı: Auth → Capture/Cancel → Refund sırayı API dökümantasyonuna göre uygulayın.
- Hata Günlüğü ve İzleme: Kod, mesaj, request-id’leri loglayın; yinelenen hatalar için uyarı kurun.
- Ölçüm: Ret oranı, 3DS başarısı, bankaya göre onay oranları için paneller oluşturun.
SSS – Sık Sorulan Sorular
“İşlem reddedildi (05)” hatasını neden alıyorum?
Genel ret kodudur. En sık nedenler: limit yetersizliği, kartın internet/uluslararası işlemlere kapalı olması, banka güvenlik filtreleri. Kart sahibinin bankasıyla kontrol etmesi gerekir.
“Banka yanıt vermiyor (91)” olduğunda ne yapmalıyım?
Genellikle geçici durumdur. Kısa süre sonra tekrar deneyin; bakım/yoğunluk kaynaklı olabilir.
“Yinelenen işlem (94)” müşteriyi iki kere mi çekti?
Aynı istek birden fazla gönderilmiş olabilir. Sipariş/ödeme kayıtlarını kontrol edin; mükerrer provizyon/çekim varsa iptal/iade süreçlerini uygulayın.
3D Secure zorunlu mu?
Zorunlu olmasa da onay oranını yükseltir ve chargeback riskini düşürür. Banka politikalarına göre bazı sektörlerde fiilen gereklidir.
