Çoğu kişi ödeme entegrasyonunun "bir kere kendi kartımla 1 TL çekerim, çalışıyorsa tamamdır" işi olduğunu sanır. Gerçekten de çalışır. Mutlu yol neredeyse her zaman çalışır. Sorun, gelirin mutlu yoldan değil, mutsuz yollardan kaybedilmesidir: yarı kalmış 3D Secure ekranı, bankanın reddettiği kart, kullanıcının geri tuşuna basması, aynı bildirimin iki kez düşmesi, iade sonrası stoğun geri gelmemesi. Bunların hiçbiri kendi kartınla yaptığın o tek denemede görünmez.
Sandbox tam olarak bu yüzden var. Amacı "ödeme alabiliyor muyum" sorusuna cevap vermek değil; ödeme bozulduğunda sistemin ne yaptığını güvenli bir ortamda izlemek. E-pin işinde bu fark hayatidir, çünkü sattığın ürün geri alınamaz. Yanlış tetiklenen bir teslimat, iade edilemeyen bir koddur. Kullandığın e-pin satış scripti ne kadar iyi olursa olsun, entegrasyonu sandbox'ta senaryolarla sınamadıysan canlıda test ediyorsun demektir; farkı, faturayı müşterinin değil senin ödemen.
Çoğu kişi canlıda bir kere dener — sandbox neden pazarlık konusu değil
Canlı ortamda test etmenin üç sessiz bedeli var. Birincisi, gerçek para hareket eder ve komisyon ödersin. İkincisi, muhasebe kayıtlarına test siparişleri karışır; ay sonunda hangi işlemin gerçek olduğunu ayıklamaya çalışırsın. Üçüncüsü ve en kötüsü, gerçek stoktan gerçek bir kod düşer. O kodu iade edemezsin, tedarikçin de geri almaz.
Sandbox ise sana kontrollü bir laboratuvar verir: hangi kartın reddedileceğini, hangi işlemin 3D adımında takılacağını, hangi bildirimin gecikeceğini sen seçersin. Yani hataları bilerek üretip sistemin tepkisini ölçersin. Ciddi bir e-pin yazılımı kurulumunda sandbox aşaması atlanmaz; entegrasyonun sözleşmesi orada yazılır.
Sandbox anahtarıyla canlı anahtarı karıştırmak: en sessiz felaket
Sahada en sık gördüğüm hata bu. Tek bir yapılandırma dosyasına iki anahtar yazılır, biri yorum satırına alınır ve bir gün yanlış satır aktif kalır. Sonuç iki yönde de yıkıcı: canlıda sandbox anahtarı çalışıyorsa müşteri para ödediğini sanır, hesabına hiçbir şey geçmez; sandbox testinde canlı anahtar çalışıyorsa gerçek kartlardan gerçek para çekilir.
Doğru kurgu şudur: anahtarlar ortam değişkeninden gelir, kod içinde asla sabit yazılmaz. Sistem hangi ortamda olduğunu tek bir bayraktan öğrenir ve panelin üstünde bunu gözle görülür biçimde gösterir. Test modundayken arayüzde sarı bir şerit duruyorsa, kimse yanlışlıkla canlı sanmaz. Ayrıca test modunda gerçek teslimat kuyruğuna yazma yetkisi kapalı olmalı; böylece yanlış bayrak bile stok yakmaz.
Hangi senaryoları test etmelisin? İşte gerçek liste
Aşağıdaki tablo, ödeme entegrasyonunu yayına almadan önce tek tek geçmen gereken senaryoları ve her birinin doğru davranışını gösteriyor. Bunu bir kontrol listesi gibi değil, kabul testi gibi kullan: hepsi geçmeden canlı anahtarı elleme.
| Senaryo | Nasıl üretilir | Beklenen davranış | Risk |
|---|---|---|---|
| Başarılı ödeme | Sağlayıcının onay veren test kartı | Sipariş ödendi, teslimat tek kez | Düşük |
| Yetersiz bakiye | Red kodu döndüren test kartı | Sipariş beklemede, stok düşmez | Yüksek |
| 3D Secure iptali | Doğrulama ekranını kapat | Sipariş başarısız, kullanıcı bilgilendirilir | Yüksek |
| 3D Secure zaman aşımı | Kod girmeden bekle | Otomatik iptal, kilit bırakmaz | Yüksek |
| Geri tuşu | Yönlendirme sırasında geri bas | Mükerrer sipariş oluşmaz | Orta |
| Çift gönderim | Öde butonuna hızlı iki tık | Tek sipariş, tek tahsilat | Yüksek |
| Gecikmiş bildirim | Bildirimi elle geciktir | Sipariş durumu doğru güncellenir | Orta |
| Tekrarlı bildirim | Aynı bildirimi üç kez gönder | Teslimat tekrarlanmaz | Kritik |
| Tutar uyuşmazlığı | Sepet tutarını değiştir | İşlem reddedilir, kayda alınır | Kritik |
| Kısmi iade | Sağlayıcı panelinden iade | Sipariş ve bakiye tutarlı kalır | Orta |
| Stok tükenmesi | Kataloğu sıfır stoğa çek | Tahsilat yapılmaz veya otomatik iade | Kritik |
| Bakiye ile ödeme | Cüzdandan öde | Sağlayıcı devreye girmez, kayıt düşer | Orta |
3D Secure ve başarısız kart: mutlu yol seni yanıltır
Türkiye'de kart ödemelerinin ezici kısmı 3D adımından geçer ve gerçek kayıplar tam orada oluşur. Kullanıcı SMS kodunu beklerken vazgeçer, sekmeyi kapatır, telefonu çalar. Senin tarafında ne olur? Kötü kurulmuş bir entegrasyonda sipariş "ödeme bekleniyor" durumunda sonsuza kadar asılı kalır, stok rezerve edilmiş olarak durur ve o ürün başka müşteriye satılamaz.
Doğru davranış, her bekleyen siparişe bir yaşam süresi vermektir. Belirlediğin süre sonunda sipariş otomatik iptal olur, rezerv serbest kalır, kullanıcıya "ödemen tamamlanmadı, tekrar dene" bağlantısı gider. Bu tek mekanizma hem stok kaybını hem de destek yükünü belirgin biçimde düşürür. Test ederken 3D ekranını bilerek kapat, bilerek bekle, bilerek yanlış kod gir; üç davranışın üçü de farklı kod dönebilir ve her biri için ayrı bir tepki yazılmış olmalı.
Sandbox testlerinde ortaya çıkan hataların dağılımı
- Başarısız ve yarı kalan ödeme akışı 45%
- Bildirim ve durum güncelleme 25%
- Stok ve teslimat tutarsızlığı 20%
- Yapılandırma ve anahtar 10%
Sandbox'ta stok ve otomatik teslimat nasıl taklit edilir
Sandbox sadece ödeme tarafını taklit eder; teslimat tarafını senin taklit etmen gerekir. Bunun için test kataloğu kur: gerçek tedarikçiye gitmeyen, sahte kod üreten bir ürün grubu. Bu ürünler test modunda görünür, canlıda gizlidir. Böylece uçtan uca akışı gerçek stok yakmadan yüz kere çalıştırabilirsin.
İkinci adım, tedarikçi API'sini taklit etmek. Tedarikçinin test ucu varsa kullan; yoksa kendi sahte servisini yaz ve üç durumu döndürsün: başarı, geçici hata, kalıcı hata. Geçici hatada sistem tekrar denemeli, kalıcı hatada siparişi manuel incelemeye almalı. Bu ayrımı yapmayan bir dijital ürün satış yazılımı kurulumu, tedarikçide bir dakikalık kesinti yaşandığında onlarca siparişi boşa düşürür. Altyapının bu davranışları hazır sunup sunmadığını özellikler listesinden kontrol et.
Panelin ve ödeme sayfasının üstüne sabit bir test şeridi koy. Anahtar karışmasından doğan kazaların neredeyse tamamı, hangi ortamda olduğunu göremeyen bir insandan kaynaklanır.
Canlıya geçiş: tek tuşla devrilmemesi için kontrol listesi
Sandbox'ta on iki senaryoyu geçtin, şimdi canlıya alacaksın. Burada acele etme; geçiş anı, entegrasyonun en kırılgan dakikasıdır. Aşağıdaki listeyi sırayla uygula ve ilk gün küçük tutarlı gerçek bir işlemle doğrula.
| Adım | Kontrol | Durum |
|---|---|---|
| 1 | Canlı anahtarlar ortam değişkenine taşındı, kodda sabit anahtar yok | Zorunlu |
| 2 | Bildirim adresi HTTPS ve dışarıdan erişilebilir | Zorunlu |
| 3 | Test kataloğu canlıda gizlendi | Zorunlu |
| 4 | Bekleyen sipariş yaşam süresi tanımlı | Zorunlu |
| 5 | Tutar ve para birimi sunucu tarafında doğrulanıyor | Zorunlu |
| 6 | Hata kayıtları ayrı dosyada tutuluyor ve okunuyor | Zorunlu |
| 7 | İlk gerçek işlem düşük tutarla doğrulandı | Zorunlu |
| 8 | İade akışı canlıda bir kez denendi | Önerilir |
Entegrasyonu sen değil yazılım güvence altına alsın
Test modu ayrımı, bekleyen sipariş temizliği, tedarikçi hata yönetimi ve sahte katalog desteği hazır geldiğinde sandbox aşaması günler değil saatler sürer.
Sandbox testi olmadan canlıya geçebilir miyim?
Teknik olarak geçebilirsin ama başarısız akışları ilk kez gerçek müşterilerle öğrenirsin. E-pin geri alınamadığı için bu öğrenmenin bedeli hem stok hem itibar olarak ödenir.
Sandbox'ta gerçek kart kullanabilir miyim?
Hayır. Test ortamı yalnızca sağlayıcının verdiği test kartlarını kabul eder. Gerçek kart bilgisini test ortamına hiçbir koşulda girme.
Test siparişleri raporlarımı bozar mı?
Ortam ayrımı doğru kuruluysa bozmaz. Test kayıtları ayrı bayrakla işaretlenir ve ciro raporlarından hariç tutulur. Aynı veritabanında karışık tutuyorsan ay sonu mutabakatın zorlaşır.
Kaç senaryo yeterli sayılır?
Asgari set başarılı ödeme, red, 3D iptali, tekrarlı bildirim, tutar uyuşmazlığı ve stok tükenmesidir. Bu altısı geçmeden yayına alma; kalanlar riski daha da düşürür.
Sandbox aşamasını ciddiye aldığın gün, ödeme entegrasyonu bir korku kaynağı olmaktan çıkıp sıradan bir kurulum adımına dönüşür. Test modunun, bekleyen sipariş temizliğinin ve hata kayıtlarının panelde nasıl yönetildiğini görmek için canlı demo üzerinde bir tur at; ardından paket seçim ekranından kendi ölçeğine uyanı belirle.