Sanal POS Hata Kodların Anlamları ve Çözümleri 2026

Sanal POS işlemlerinde görülen hata kodları, ödemenin neden tamamlanamadığını kısa bir “banka yanıtı” olarak gösterir. Güvenlik kontrolleri ve internet alışveriş limitleri daha sıkı olduğu için, aynı kod farklı sebeplerle de tetiklenebilir. Bu rehberde sanal pos hata kodların ne anlama geldiğini, müşteriye ne söyleneceğini ve işletme tarafında hangi kontrollerin yapılacağını net şekilde bulacaksınız.
Sanal POS Hata Kodu Nedir, Neden Oluşur?
Sanal POS hata kodu, bankanın (veya ödeme altyapısının) işlem isteğine verdiği yanıtın kısa biçimidir. Bazı sistemler kodu 2 haneli (05) bazıları 3 haneli (005) gösterebilir; anlam genelde aynıdır. Kodun kaynağı bazen kart/banka, bazen de entegrasyon ve parametre hatası olabilir. Sanal POS hata kodu sebepleri:
- Kart sahibinin bankası işlemi onaylamaz (limit, kısıt, güvenlik).
- Sanal POS/altyapı yanıt vermez (zaman aşımı, sistem arızası).
- İşyeri ayarları uygun değildir (taksit kapalı, iş yeri kısıtlı).
- Entegrasyonda alan/parametre uyuşmazlığı vardır (tutar biçimi, sipariş numarası, güvenlik imzası).
| Kaynak | Belirti | İlk Yapılacak |
|---|---|---|
| Banka/Kart | 05, 51, 54 gibi ret kodları | Müşteriden kart limitini ve internet alışveriş iznini kontrol etmesini iste |
| Güvenlik doğrulaması | Doğrulama ekranından geri dönme/başarısızlık | Doğrulama adımının tamamlanıp tamamlanmadığını kontrol et |
| Entegrasyon | “biçim/alan hatası”, “geçersiz işlem” | Gönderdiğin alanları ve işlem türünü kontrol et |
| Sistem | 91, 96, zaman aşımı | Tekrar denemeyi kontrollü yönet; provizyon kontrolü yap |
Hata Kodunu Görür Görmez Yapmanız Gerekenler
Birçok gereksiz deneme hem müşteriyi yorar hem de güvenlik filtrelerini tetikleyebilir. Bu yüzden önce hızlı kontrollerle sorunun “kart/banka mı, entegrasyon mu, sistem mi” olduğunu ayırmak en doğru adımdır. Aynı zamanda çift çekim riskini de en baştan yönetmiş olursun. Hemen dikkat etmeniz gerekenler:
- İşlem kaydı: Sipariş numarası, tutar, tarih-saat, müşteri bilgisi doğru mu?
- Deneme sayısı: Aynı kartla peş peşe çok deneme yapıldı mı?
- Kart kısıtı: İnternet alışverişi kapalı mı, limit/harcama kısıtı var mı?
- Tutar ve para birimi: Kuruş formatı, para birimi, taksit seçimi uyumlu mu?
- Zaman aşımı: “Yanıt gelmedi” türü bir durum mu, yoksa net ret mi?
- Provizyon kontrolü: Banka tarafında provizyon oluştu mu?
En Yaygın Sanal POS Hata Kodları ve Çözümleri (00-99)
Banka kredi kartı veya banka kartı yanıt kodları çoğunlukla “işlem onaylanmadı” demenin standartlaşmış halidir. Bu kodlar bankadan bankaya ufak farklılıklar gösterebilse de yaygın anlamları oldukça stabildir. Aşağıdaki kodlar, online e-ticarette en sık karşılaşılan klasik banka standardı hata kodlarıdır:
| Kod | Anlamı | Nedeni | Çözüm | Aksiyon Sahibi |
|---|---|---|---|---|
| 00 | Onaylandı | Sorun yok | İşlem tamam | İşlem tamam |
| 01 | Banka yönlendirmesi | Ek kontrol gerekir | Banka ile doğrulama | Müşteri/Banka |
| 03 | Üye iş yeri geçersiz | POS tanımı hatalı | Üye iş yeri bilgilerini kontrol | İş yeri/Altyapı |
| 04 | Kart alıkonulmalı | Güvenlik şüphesi | Kartı veren bankaya yönlendir | Müşteri/Banka |
| 05 | Reddedildi | Şüphe/limit | Farklı kart, banka teyidi | Müşteri/Banka |
| 12 | Geçersiz işlem | İşlem türü uyumsuz | İşlem tipi kontrolü | İş yeri/Yazılım |
| 13 | Geçersiz tutar | Tutar formatı/limit | Tutarı ve para birimini kontrol | İş yeri/Yazılım |
| 14 | Kart numarası hatalı | Hatalı kart bilgisi | Kart numarasını doğrula | Müşteri |
| 30 | Mesaj format hatası | Alan uyumsuzluğu | Entegrasyon alanlarını denetle | İş yeri/Yazılım |
| 41 | Kayıp kart | Banka blokajı | Banka ile görüşme | Müşteri/Banka |
| 43 | Çalıntı kart | Banka blokajı | Banka ile görüşme | Müşteri/Banka |
| 51 | Yetersiz bakiye/limit | Limit yetersiz | Limit artırımı ya da farklı kart | Müşteri |
| 54 | Kart süresi dolmuş | Son kullanma geçti | Yeni kart ile dene | Müşteri |
| 55 | Şifre/doğrulama hatası | Doğrulama yanlış | Doğru doğrulama ile tekrar | Müşteri |
| 57 | Kart işlemine izin yok | Kart kısıtı | Bankadan izin açtır | Müşteri/Banka |
| 58 | İş yerine izin yok | İş yeri kısıtı | POS yetkilerini kontrol | İş yeri/Altyapı |
| 61 | Tutar limiti aşıldı | Günlük/tek işlem limit | Tutarı böl, limit güncelle | Müşteri/Banka |
| 62 | Kısıtlı kart | Bölge/ürün kısıtı | Banka kısıtını kaldır | Müşteri/Banka |
| 63 | Güvenlik ihlali | Güvenlik kontrolü | Risk incelemesi | Banka/Altyapı |
| 65 | İşlem adedi aşıldı | Deneme sınırı | Bir süre bekle, banka teyidi | Müşteri/Banka |
| 75 | Şifre deneme aşıldı | Çok deneme | Bekle/banka ile açtır | Müşteri/Banka |
| 76 | Geçici işlem kaydı | Çakışma/tekrar | Tekrar denemeden önce kontrol | İş yeri/Altyapı |
| 77 | İşlem bulunamadı | İade/iptal uyumsuz | Referans numarasını doğrula | İş yeri/Altyapı |
| 78 | Kart bloke | Banka blokajı | Banka ile görüşme | Müşteri/Banka |
| 91 | Banka yanıt vermiyor | Zaman aşımı/yoğunluk | Tekrar dene, kayıt incele | İş yeri/Altyapı |
| 94 | Tekrarlı işlem | Aynı işlem tekrar | Tekrarı engelle, benzersiz numara | İş yeri/Yazılım |
| 96 | Sistem arızası | Geçici teknik hata | Tekrar dene, altyapı kaydı aç | İş yeri/Altyapı |
Müşteri Tarafında Çözüm Adımları: Banka Uygulaması, İnternet Alışverişi İzni, Limit
Müşteri tarafında görülen sanal POS redlerinin önemli kısmı, bankanın uygulama/şube içi güvenlik ayarları ve limit politikalarından kaynaklanır. Bu yüzden “kart bozuk” demeden önce banka uygulaması üzerinden birkaç temel ayarı kontrol etmek, sorunu çoğu zaman dakikalar içinde çözer. Ayrıca aynı kartla art arda denemeler, bankanın güvenlik sistemini tetikleyebileceği için deneme sayısını sınırlamak önemlidir.
- Müşteri hangi hallerde kontrol yapmalıdır?
- Kartla alışveriş sürekli reddediliyorsa
- Daha önce sorunsuz ödeme alınırken aniden reddetmeye başladıysa
- Yüksek tutarlı veya yurt dışı işlem denemesinden sonra sorun çıktıysa
- Kontrol Edin:
- İnternet alışverişi izni: Banka uygulamasında kart ayarlarından açık mı?
- 3D Güvenlik/Doğrulama: Banka bildirimleri kapalı mı, uygulama oturumu açık mı?
- Limitler: Günlük harcama limiti ve e-ticaret limiti yeterli mi?
- Kart durumu: Kart geçici blokede mi, şüpheli işlem uyarısı var mı?
- Doğru bilgi girişi: Son kullanma, güvenlik kodu, ad-soyad doğru mu?
E-Ticaret Kısıt Kodları: Kart İnternete Kapalıysa Ne Olur?
Kart internete kapalıysa banka, “bu işlem türüne izin yok” sınıfında bir ret döndürür. Bu, bazen kart ayarı (internet izni kapalı), bazen de banka kuralı (müşteri profili, ülke veya sektör kısıtı) nedeniyle olur. Aynı kartla art arda denemek geçici blokeyi tetikleyebilir.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 57 | İşlem kart için izinli değil | İnternet alışverişi kapalı / kart kısıtı | Banka uygulamasından internet alışverişi iznini açtır |
| 62 | Kısıtlı kart | Ülke/işlem türü kısıtı | Banka kısıtını kaldırma / farklı kart |
| 58 | İşlem işyeri/terminal için izinli değil | Üye işyeri işlem türü kapalı (ör. e-ticaret) | Sağlayıcı panelinden yetkileri kontrol et |
| 05 | Genel ret | Banka politikası / koruma | Farklı kart dene, ısrarı azalt |
| 12 | Geçersiz işlem | İşlem türü uyumsuz | İşlem tipi ve parametreleri düzelt |
Kart Kaynaklı Hata Kodları: Limit, Bakiye, Son Kullanma ve Kart Blokesi
Kart kaynaklı retlerde en sık sebep limit/bakiye yetersizliğidir; ikinci sırada son kullanma ve kartın temel bilgilerindeki uyumsuzluk gelir. Bazen bankalar “genel ret” döndürüp asıl sebebi uygulama içinde gösterir. Bu yüzden müşteri uygulamasındaki kart ekranı kritik ipucu verir.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 51 | Yetersiz bakiye/limit | Kullanılabilir limit yok | Tutarı düşür / farklı kart |
| 61 | Tutar limiti aşıldı | İşlem limiti | İnternet limitini artır / tutarı böl |
| 65 | Sıklık limiti aşıldı | Günlük işlem sayısı/limiti | Bekle, bankayla limit güncelle |
| 33 / 54 | Kart süresi dolmuş | Eski kart bilgisi | Yeni kart bilgisiyle dene |
| 78 | Kart aktif değil | Kart aktivasyonu yapılmamış | Banka uygulamasından kartı aktifleştir |
| 14 | Geçersiz kart numarası | Hatalı giriş | Kart bilgisini yeniden al |
| 82 | Son kullanma/CVV doğrulama sorunu görülebilir | Bilgi hatası / doğrulama uyumsuzluğu | Ay-yıl ve güvenlik kodunu yeniden kontrol et |
Güvenlik ve Risk Reddleri için Kodlar: Şüpheli İşlem, Deneme Sınırı ve Bloke Mantığı
Risk reddi, işlem “yanlış” olduğu için değil “şüpheli” göründüğü için olur. Aynı kartla kısa sürede çok deneme, alışılmadık cihaz/konum, yüksek tutar gibi etkenler bankanın risk kurallarını çalıştırır. Bu noktada en doğru yaklaşım, ardışık deneme yapmak yerine bankanın uyarı ekranını kontrol etmektir.
| Kod | Ne Anlatır | Kontrol | İşlem Sahibi |
|---|---|---|---|
| 59 | Şüpheli işlem | Banka uygulaması güvenlik uyarısı | Müşteri/Banka |
| 34 | Şüpheli işlem | Deneme sıklığı, tutar, konum | Müşteri/Banka |
| 63 | Güvenlik ihlali | Doğrulama/kimlik adımları | Banka |
| 04 | Kartı alıkoyma türü güvenlik ret | Kart durumu ve banka kaydı | Banka |
| 38 | Deneme sınırı aşıldı | Yanlış doğrulama/çok deneme | Müşteri/Banka |
| 75 | Deneme sınırı aşıldı | Kısa süre bekleme | Müşteri/Banka |
Kart Durumu Kaynaklı Red Kodları: Süre Doldu, Kayıp, Çalıntı
Kart “durum” retleri, çoğu zaman iş yeri tarafında çözülemez; bankanın kart statüsü belirleyicidir. Kart yenilendiyse eski kart kapatılmış olabilir. Kayıp/çalıntı bildirimi varsa banka işlemi güvenlik nedeniyle otomatik reddeder.
| Kod | Ne Anlatır | Kontrol | İşlem Sahibi |
|---|---|---|---|
| 33 | Kart süresi dolmuş | Yeni kart bilgisi | Müşteri |
| 41 | Kayıp kart | Kart statüsü | Banka |
| 43 | Çalıntı kart | Kart statüsü | Banka |
| 78 | Kart aktive değil | Aktivasyon adımı | Müşteri/Banka |
| 07 | Özel durum güvenlik ret | Banka kayıtları | Banka |
Yurt Dışı Kart İşlemlerindeki Kodlar: Döviz, 3D Zorunluluğu, Ülke Kısıtları ve Reddedilme Nedenleri
Yurt dışı kartlarda reddin nedeni sadece bakiye olmayabilir; ülke kısıtı, döviz işlemi limiti veya bankanın ek güvenlik kuralı devreye girebilir. Döviz işlemlerinde kur farkı nedeniyle provizyon tutarı beklenenden bir miktar yüksek oluşabilir. Bu yüzden müşteriye yurt dışı kullanım ve döviz limitlerini kontrol ettirmek çoğu zaman yeterlidir.
- Banka uygulamasından yurt dışı kullanım iznini kontrol etmek
- Döviz işlemi için limit kontrolü yapmak
- 3D doğrulama bildirimi gelmiyorsa bildirim izinlerini açmak
| Kod | Anlamı | Çözüm |
|---|---|---|
| 62 | Kısıtlı kart (ülke/işlem kısıtı görülebilir) | Banka kısıtını kaldırma |
| 57 | İşleme izin yok | Yurt dışı/çevrim içi izinleri açma |
| 13 | Geçersiz tutar (para birimi/yuvarlama etkileyebilir) | Tutar ve para birimi kontrolü |
| 05 | Genel red | Banka güvenliği veya ülke kısıtı, bankayla görüşme |
Para Birimi ve Tutar Uyuşmazlık Kodları: Kur, Kuruş Yuvarlama ve Format Problemleri
Para birimi ve tutar uyuşmazlıkları, çoğu zaman “geçersiz tutar” veya “biçim hatası” kodlarıyla görünür. Kuruş yuvarlama farkı küçük olsa bile banka tarafında tutar doğrulamasını bozabilir. Döviz işlemlerinde, tek bir kur çevrimi kuralı uygulamak önemlidir.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 13 | Geçersiz tutar | Biçim/yuvarlama | Tutar formatını tek kurala bağla |
| 30 | Format hatası | Alanlar eksik/yanlış | Zorunlu alanları ve veri tipini düzelt |
| 64 | Orijinal tutar hatalı | İptal/iade referansında tutar uyumsuz | Orijinal işlem tutarıyla eşleştir |
| 12 | Geçersiz işlem | Para birimi/işlem tipi uyumsuz | Para birimi ve işlem tipini doğrula |
| 05 | Genel ret | Banka kontrolü | Farklı kart / farklı deneme stratejisi |
Taksit ve Kampanya Hata Kodları: Taksit Kapalı, Tutar Sınırı ve Banka Kuralları
Taksit ve kampanya reddi, mağaza ayarı ile bankanın o kart için izin verdiği koşullar uyuşmadığında oluşur. Örneğin taksit kapalıyken taksitli parametre gönderilmesi “geçersiz işlem” benzeri kodlarla dönebilir. Tutar alt-üst sınırları da kampanya kurallarında sık görülür.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 58 | İşlem işyeri için izinli değil | Taksit/işlem türü kapalı | Sağlayıcıdan taksit yetkisi açtır |
| 57 | İşlem kart için izinli değil | Kart taksite kapalı | Tek çekim dene / farklı kart |
| 12 | Geçersiz işlem | Taksit parametresi uyumsuz | Taksit değerini ve kart türünü kontrol et |
| 13 | Geçersiz tutar | Taksit/tutar kuralı | Banka min-maks kurala uy |
| 30 | Format hatası | Alan/biçim sorunu | Parametre biçimlerini düzelt |
| 40 | Fonksiyon desteklenmiyor | Banka/pos kuralı | İşlem türünü değiştir veya bankayla görüş |
Teknik Hata Kodları: Zaman Aşımı, Sistem Arızası ve Geçici Kesinti Senaryoları
Teknik hatalarda en kritik risk, müşterinin “olmadı” sanıp tekrar denemesi ve sonradan çift çekim şüphesi doğmasıdır. Zaman aşımı, banka yanıtının geç gelmesi veya ağ kopması yüzünden olur. Böyle durumlarda önce provizyon var mı kontrol etmek gerekir.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 91 | Banka/anahtar sistem çalışmıyor | Geçici kesinti | Kontrollü tekrar + izleme |
| 96 | Sistem arızası | Banka/sağlayıcı arızası | Destek kaydı + geçici durdurma |
| 68 | Yanıt geç geldi | Zaman aşımı | İkinci çekimden önce sorgula |
| 92 | Yönlendirme bulunamadı | Ağ/yönlendirme sorunu | Sağlayıcı/banka incelemesi |
| 22 | Şüpheli arıza | İç hata | Kayıtları topla, destek aç |
| 31 | Banka desteklenmiyor | Yönlendirme uyumsuz | Üye işyeri/banka uyum kontrolü |
Tekrarlı İşlem ve Çift Çekim Riski: Aynı Siparişin İki Kez Geçmesini Önleme
Tekrarlı işlem riski, çoğu zaman zaman aşımı sonrası tekrar denemeden doğar. Bazı durumlarda sistem “mükerrer gönderim” olarak algılar ve özel bir kod döndürür. Burada hedef, aynı siparişin tekil bir işlem numarasıyla yönetilmesidir.
| Kod | Ne Anlatır | Kontrol | İşlem Sahibi |
|---|---|---|---|
| 94 | Mükerrer gönderim | Aynı isteğin tekrar gönderimi | İş yeri/Yazılım |
| 19 | Yeniden gir/tekrar dene | Yanıt belirsizliği | İş yeri/Altyapı |
| 25 | Kayıt bulunamadı | İptal/iade eşleşmesi | İş yeri/Altyapı |
| 91 | Yanıt yok/yoğun | Zaman aşımı sonrası tekrar | Banka/Altyapı |
| 96 | Sistem arızası | Tekrar deneme stratejisi | Altyapı |
İptal-İade Hata Kodları: Referans Bulunamadı, Kısmi İade ve Gün Kuralı
İptal-iade sorunlarında ana mesele “doğru satış kaydını bulmak” ve “doğru işlem türünü seçmek”tir. Aynı gün iptal, sonraki gün iade gibi kurallar altyapıya göre değişebilir. Referans uyuşmazlığı varsa iade/iptal işlemi reddedilir.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 25 | Kayıt bulunamadı | Yanlış referans/işlem | Doğru orijinal işlemi eşleştir |
| 12 | Geçersiz işlem | İade/iptal tipi uyumsuz | Doğru işlem türünü seç |
| 13 | Geçersiz tutar | Kısmi iade tutarı hatalı | Kalan tutarı doğru hesapla |
| 30 | Format hatası | Referans alanı hatalı | Alan biçimini düzelt |
| 21 | İşlem yapılmadı | Banka kuralı/limit | Banka/sağlayıcı ile incele |
IP, Cihaz ve Konum Bazlı Engeller: Neden Aynı Müşteri Sürekli Reddedilir?
Aynı müşteri sürekli reddediliyorsa sorun bazen karttan değil; cihaz, ağ veya konumdan kaynaklı risk değerlendirmesinden olur. Tarayıcı kısıtları 3D doğrulamayı bozabilir; ağ riski bankanın “şüpheli işlem” kuralını tetikleyebilir. Bu sınıfta “tek değişkenle deneme” yaklaşımı en hızlı sonuç verir.
| Kod | Anlamı | Nedeni | Çözüm |
|---|---|---|---|
| 59 / 34 | Şüpheli işlem | IP/konum/cihaz uyumsuz | Tek cihaz-tek ağ-tek deneme, 3D zorunlu |
| 62 | Kısıtlı kart | Ülke kuralı | Ülke kuralını ve yurt dışı iznini kontrol |
| 63 | Güvenlik ihlali | Doğrulama uyumsuzluğu | Kayıtları ve risk ayarlarını gözden geçir |
| 05 | Genel ret | Banka koruması | Müşteriyi bankaya yönlendir, ısrarı azalt |
| 38 / 75 | Deneme sınırı aşıldı | Çok deneme → bloke | Bekleme + bankayla çözüm |
Ters İbraz (Chargeback) Sürecinde Hata Kodları
Ters ibraz kodları, sanal POS “ret kodu” gibi çalışmaz; işlem geçtikten sonra bankanın itiraz gerekçesini tanımlar. Kodlar kart şemasına göre değişir ve zaman içinde güncellenir; bu yüzden ödeme altyapınızın sunduğu “ters ibraz kodu” ekranı esas alınmalıdır. Aşağıda en sık görülen örnek kodlar yer alır.
| Ağ | Kod | Anlamı | En Sık Sebep |
|---|---|---|---|
| Visa | 10.4 | Yetkisiz işlem (kart yokken) | Kart bilgilerinin kötüye kullanımı iddiası |
| Visa | 12.6.1 | Çift işlem | Aynı işlemin iki kez geçmesi |
| Visa | 12.7 | Geçersiz veri | Yetkilendirme/veri alanı hatası |
| Visa | 13.3 | Ürün/hizmet beklendiği gibi değil | Ürün “ayıplı” iddiası |
| Visa | 13.6 | İade işlenmedi | İade sözü var ama yapılmadı |
| Mastercard | 4837 | Kart hamili onayı yok | Yetkisiz işlem iddiası |
| Mastercard | 4855 | İşlem tamamlanmadı | Hizmet/teslimat gerçekleşmedi |
| Mastercard | 4834 | Çift/uyuşmayan tutar | Mükerrer veya farklı tutar iddiası |
| Mastercard | 4860 | İade işlenmedi | İade gecikmesi/eksikliği |




