1. Timeout (Zaman Aşımı) Hatası Nedir?
Bir e-ticaret sitesinde ödeme başlatıldığında; veriler sırasıyla Payment Gateway'e, oradan tahsilatçı bankaya (Acquirer) ve son olarak müşterinin kart bankasına (Issuer) iletilir. Banka bu talebi inceler, onaylar veya reddeder ve bu yanıt aynı yoldan siteye geri döner.
Timeout (Zaman Aşımı) Hatası, bu uzun iletişim zincirinde bir kopukluk yaşandığı ve belirlenen maksimum bekleme süresi (genellikle 30 ile 60 saniye arası) içinde bankadan veya ödeme geçidinden herhangi bir yanıt (response) alınamadığı durumlarda sistemin işlemi otomatik olarak iptal etmesidir. En yaygın Sanal POS hata kodu karşılığı Hata Kodu 91'dir.
2. Timeout Hatalarının 4 Temel Nedeni
Zaman aşımı hataları genellikle işletmenin e-ticaret sitesinden kaynaklanmaz; sorun arka plandaki finansal devlerin altyapılarındadır:
1
Banka (Issuer/Acquirer) Altyapı Kesintileri
Türkiye'deki bankaların sistemleri ay sonlarında, kampanya dönemlerinde (Efsane Cuma vb.) veya gece yarısı yapılan planlı bakım çalışmalarında aşırı yüklenmeden dolayı kilitlenebilir ve gelen ödeme taleplerine yanıt veremez.
2
Ağ (Network) Bağlantı Sorunları
Verinin internet üzerinde seyahat ettiği sunucular (DNS sağlayıcıları, Firewall'lar, Switch'ler) arasında anlık paket kayıpları (packet loss) veya yüksek gecikme (latency) süreleri oluşabilir.
3
Payment Gateway (Ödeme Ağ Geçidi) Yavaşlamaları
Çalıştığınız ödeme kuruluşu veya Gateway'in kendi sunucu kapasitesi yetersiz kaldığında, işlem bankaya dahi ulaşmadan havuzda bekletilebilir ve zaman aşımına uğrayabilir.
4
3D Secure Yönlendirme Gecikmeleri
Müşteri 3D Secure şifresini SMS ile aldıktan sonra girmekte çok gecikirse veya bankanın 3D onay sayfası yoğunluktan açılamazsa session (oturum) düşer ve Timeout hatası üretilir.
Timeout hataları en tehlikeli başarısız işlem türüdür. Çünkü sistem size "işlem reddedildi" demez, "işlemin sonucunu bilmiyorum" der.
3. Timeout Hataları İşletmeleri Nasıl Etkiler?
Zaman aşımı hataları, basit bir "Yetersiz Bakiye" hatasından çok daha zarar vericidir:
- Doğrudan Ciro Kaybı: Müşteri hatayı aldığında genellikle "Sistemleri bozuk, güvenilmez" diyerek sepeti terk eder ve rakibe yönelir.
- Destek Maliyetleri: Müşteri panikleyerek çağrı merkezini arar, bu da müşteri hizmetleri (Call Center) maliyetlerinizi şişirir.
- Müşteri Güveninin Kaybı: Kredi kartı bilgileri gibi hassas bir konuda yaşanan donmalar ve hatalar, markanın dijital itibarını derinden zedeler.
4. En Büyük Kabus: Mükerrer Çekim (Double Charge)
Timeout hatalarının e-ticaret siteleri için en korkutucu yanı Mükerrer Çekim riskidir. Senaryo genellikle şu şekilde gelişir:
Hayalet Çekim Problemi
Siz (e-ticaret sitesi) bankaya "Parayı çek" komutunu yollarsınız. Banka bu parayı müşterinin kartından başarıyla çeker. Ancak banka size "Parayı Çektim (Onay)" mesajını geri yollarken tam o milisaniyede internet kopar veya zaman aşımı yaşanır.
Sizin sisteminiz yanıt alamadığı için siparişi "Başarısız" veya "İptal" statüsüne alır. Müşteriye "Hata oluştu" der. Ancak müşterinin telefonuna bankadan "Sitemizden X TL harcama yapılmıştır" SMS'i gelir.
Sonuç: Müşteri ürünü alamamıştır ama parası çekilmiştir. Panikle müşteriniz sizi arar, siz siparişi sistemde göremediğiniz için "Biz para çekmedik" dersiniz. Bu durum müşteri ile işletme arasında ciddi krizler ve sosyal medya şikayetleri doğurur.
5. Timeout Hatalarını Önleme ve Çözüm Stratejileri
Altyapısal zaman aşımlarını tamamen yok edemezsiniz (çünkü bankalar elbet bir gün çöker), ancak etkilerini gelişmiş yazılım mimarileriyle %99 oranında silebilirsiniz:
A. Idempotency Key (Benzersiz İşlem Anahtarı) Kullanımı
Mükerrer çekimleri engellemenin en teknik yoludur. Her ödeme denemesinde sisteme benzersiz bir kod (Idempotency Key) atanır. Müşteri timeout alıp tekrar "Öde" tuşuna basarsa, banka aynı anahtarı görür ve "Bu işlemi zaten yapmıştım" diyerek müşterinin kartından ikinci kez para çekilmesini bloklar.
B. Dynamic Failover (Hata Toleransı)
Eğer X bankasından yanıt gelmiyorsa (Timeout oluyorsa), sistemin işlemi iptal etmek yerine milisaniyeler içinde alternatif Y bankasının Sanal POS'una kaydırması işlemidir. Sadece Multi Acquiring ve Ödeme Orkestrasyonu yapılarıyla mümkündür.
C. Asenkron İşlem Yönetimi ve Mutabakat (Reconciliation)
Timeout olan şüpheli işlemleri sistem otomatik olarak belirli aralıklarla bankanın API'sine "Bu işlem gerçekten başarılı oldu mu?" diye sorar (Query/Status Check). Eğer banka "Evet başarılı" derse, sipariş iptal edilmez ve otomatik olarak "Onaylandı" statüsüne güncellenir.
6. Dijigate Failover ile Timeout'lara Son Verin
Banka kesintilerini veya ağ kilitlenmelerini işletmenizin bir problemi olmaktan çıkarmak için Dijigate Ödeme Orkestrasyonu kusursuz bir mimari sunar.
Dijigate'in eşsiz Failover (Geçiş/Yedekleme) Sistemi, entegre olduğunuz ana bankada bir zaman aşımı veya Hata Kodu 91 yaşandığında bunu anında fark eder. Müşterinize hiçbir hata mesajı göstermeden, arka planda işlemi yedeğinizdeki diğer banka POS'larına gönderir. Müşteriniz kesintiyi hissetmez, siz ise satışı kaybetmezsiniz. Ayrıca Dijigate'in otomatik işlem sorgulama algoritmaları, mükerrer çekim (double charge) risklerini tamamen ortadan kaldırır.
Banka Kesintileri Cironuzu Vurmasın!
Dijigate'in Failover ve Akıllı Yönlendirme teknolojisi sayesinde Timeout hatalarını geride bırakın. Kesintisiz tahsilatın gücüyle tanışmak için hemen bizimle iletişime geçin.
7. Sık Sorulan Sorular (S.S.S)
Müşteri Timeout hatası aldığında tekrar "Öde" tuşuna basmalı mı?
Eğer altyapınızda "Idempotency Key" veya gelişmiş bir ödeme orkestrasyonu yoksa, müşterinin tekrar butona basması çift çekim (mükerrer ödeme) riskini doğurur. Müşterilerinize sayfayı yenilememelerini ve banka hesaplarını kontrol etmelerini belirten açık bir uyarı göstermelisiniz.
Hata kodu 91 (Issuer Inoperative) kalıcı bir hata mıdır?
Hayır, 91 kodu geçici (Soft Decline) bir hatadır. Sistem kaynaklı bir anlık iletişim kopukluğunu ifade eder. Bu işlemi saniyeler sonra veya başka bir banka POS'u (Dijigate aracılığıyla) üzerinden tekrar denediğinizde büyük ihtimalle başarılı olacaktır.
Timeout yüzünden müşteriden para çekildiyse ancak sipariş oluşmadıysa ne olur?
Bu duruma "Askıda kalan işlem" denir. Genellikle bankaların "Gün Sonu" işlemlerinde (Gece 00:00 - 02:00 arası) sistemler senkronize olur ve başarılı olmayan siparişlerin parası ertesi gün müşterinin kartına otomatik (Void/İptal) olarak yansıtılır. İşletme manuel iade yapmak zorunda kalmaz.

