Geliştirici Sandbox Ortamı

Test Ortamı Ne İşe Yarar?

Test ortamı, yazdığınız kodun ödeme akışını doğru kurduğunu göstermek içindir. Gerçek bir kart çekilmeden, ödeme başlatma isteğinin kabul edildiğini, doğrulama adımının çalıştığını ve sonucun kendi kaydınıza işlendiğini uçtan uca izlersiniz.

• Gerçek para hareketi olmaz. Test ortamındaki işlemler kart ve hesap hareketine dönüşmez; yalnızca entegrasyonun doğru çalıştığını görmek içindir.
• Anahtarlar ayrıdır. Test ve canlı anahtarlar birbirinden bağımsız tanımlanır. Böylece deneme sırasında canlı hesabınıza yanlışlıkla istek gönderme ihtimali ortadan kalkar.
• Yanıt yapısı aynı mantıkla çalışır. İstek alanları, durum kodları ve hata karşılıkları canlı ortamdakiyle aynı çerçevede döner; kodunuzu ikinci kez yazmanız gerekmez.
• Hazır test kartları vardır. Başarılı ödeme, yetersiz bakiye ya da süresi dolmuş kart gibi sonuçları üreten kart numaraları önceden tanımlıdır.

Test ortamının adresi, anahtarları, kapsamı ve varsa sınırları çalışılacak ödeme kuruluşunun çözümüne göre belirlenir; kesin bilgi hesabınız açıldığında iletilen dokümantasyonda yer alır. Ayrıntılı anlatım ve senaryo listesi için test ortamı (sandbox) ve test kartları sayfalarına bakabilirsiniz.

Test Araçları ve Özellikleri

Aşağıdaki başlıklar test ortamında en sık çalıştırılan akışlardır. Hangilerinin hesabınıza tanımlı olduğu seçilen ödeme kuruluşunun çözümüne göre değişir.

• Test kartları. Visa, Mastercard ve Troy için hazır kart numaralarıyla ödeme simülasyonu yapılır. Kart listesi ve doğrulama bilgileri kuruma göre değişebilir.
• Başarılı ödeme testi. Ödemenin kabul edildiği akışı çalıştırıp dönen yanıt alanlarını ve durum kodlarını doğrularsınız.
• Başarısız ödeme testi. Yetersiz bakiye, geçersiz kart ve limit aşımı gibi durumların kendi arayüzünüzde nasıl göründüğünü denersiniz.
• 3D Secure testi. Doğrulama akışındaki yönlendirmeyi ve geri dönüş adımını simüle edersiniz. Akışın işleyişi için API dokümantasyonu sayfasına bakın.
• İade testi. Tam ve kısmi iade çağrılarını gönderip dönen yanıtları doğrularsınız. İade kuralları ve süre sınırları sözleşmenizde yazar.
• Webhook testi. Ödeme sonucuna göre gönderilen bildirimleri deneyip callback adresinizin isteği doğru karşıladığını görürsünüz. Alan yapısı ve imza doğrulaması için webhook ve callback sayfasını kullanın.
• Tekrarlayan ödeme testi. Abonelik planı oluşturma, yenileme denemesi ve iptal akışlarını test ortamında çalıştırırsınız.
• Kart saklama testi. Kart numarası yerine tokenization ile üretilen anahtarın saklandığı akışı ve sonraki alışverişte kart bilgisi girilmeden ilerleyen adımı denersiniz.

Hazır kod örnekleriyle başlamak isterseniz örnek kodlar sayfasındaki parçaları kendi projenize uyarlayabilirsiniz.

Kapsamlı Test Senaryoları

Canlıya geçmeden önce yalnızca başarılı akışı değil, hata ve sınır durumlarını da çalıştırmak entegrasyonun sağlamlığını gösterir.

• Farklı kart tipleri. Visa, Mastercard, Troy ve farklı bankaların kartlarıyla aynı akışı tekrarlayın; sonuçlar kartı veren kuruluşun tanımına göre değişebilir.
• Hata kodları. Yetersiz bakiye, geçersiz CVV ve süresi dolmuş kart gibi durumlarda dönen kodları yakalayın. Karşılıkları için POS hata kodları sayfasını kullanın.
• Taksit senaryoları. Farklı taksit seçeneklerinin ve tutar hesaplamasının kendi sepetinizde nasıl göründüğünü deneyin. Hangi seçeneklerin açık olacağı işletmenizin değerlendirmesine bağlıdır.
• Dövizli ödeme. Farklı para birimleriyle ödeme akışını çalıştırın; desteklenen para birimleri seçilen çözüme göre değişir.
• Ödeme linki. Bağlantı üretme ve bağlantı üzerinden ödeme akışını uçtan uca deneyin. Ayrıntı için link ile ödeme sayfasına bakabilirsiniz.

Sandbox'tan Canlıya Geçiş

Test ortamında akış doğrulandıktan sonra canlı anahtarlara geçilir. Aşağıdaki adımlar geçişte tipik olarak yapılan işlerdir; kesin sıra hesabınız açıldığında iletilen dokümantasyonda belirtilir.

• Anahtarları değiştirin. Sandbox anahtarı yerine canlı anahtarı tanımlayın. Anahtarları kod deposunda değil sunucu ortam değişkeninde tutun.
• Adresleri güncelleyin. İsteklerin gönderildiği adresleri canlı ortama çevirin. Kullandığınız kütüphaneye göre bu genellikle tek bir ortam ayarıdır.
• Bildirim adresini yapılandırın. Canlı ortam için webhook adresinizi tanımlayın ve imza doğrulamasını açık bırakın. Ödeme sonucunu tarayıcıdan dönen yanıtla değil, bu bildirimle kesinleştirin.
• Son kontrolü yapın. Canlı ortamda küçük tutarlı bir işlem yaparak akışın uçtan uca çalıştığını doğrulayın ve sonucu iade ederek kapatın.

Entegrasyonun tümüne bakmak isterseniz API ve SDK entegrasyonu sayfası REST çağrılarını ve hazır kütüphaneleri birlikte anlatır.