Geliştirici ortamı

Test Ortamı (Sandbox)

Entegrasyonunuzu canlıya almadan test ortamında doğrulayın: aynı istek ve yanıt yapısı, gerçek para hareketi olmadan başarılı ve başarısız ödeme senaryoları.

Gerçek para hareketi yok
Test ve canlı anahtarlar ayrı
Başarılı ve başarısız senaryolar

Ücretsiz Başvuru → Test senaryolarını görün ↓

Sandbox erişimi, hesabınız açıldıktan sonra tanımlanır.

Test ortamının adresi, anahtarları ve kapsamı çalışılacak ödeme kuruluşunun çözümüne göre belirlenir.

Kısaca

Test ortamında (sandbox) ödeme akışınızı gerçek para hareketi olmadan uçtan uca çalıştırırsınız: test anahtarlarıyla test adresine istek gönderir, ödeme kuruluşunun yayımladığı test kartlarıyla onaylanan ve reddedilen ödemeleri canlandırırsınız. Test ortamı her ödeme kuruluşunun kendisine aittir; bir kuruluşun test kartı ya da anahtarı başka kuruluşun ortamında genellikle çalışmaz.

Test ortamına erişiminiz hangi durumda?

Sandbox ortamı

Kodunuzu canlıya almadan deneyin.

Entegrasyonu test ortamında doğrulayın; ödeme akışını gerçek para hareketi olmadan uçtan uca çalıştırın.

Test anahtarları

Canlı anahtarlardan ayrı
Yalnız test ortamında geçerli
Hesap açılışında tanımlanır

Anahtarları paylaşmayın; canlı anahtarla test etmeyin.

Gerçek API yanıtları

Aynı istek ve yanıt yapısı
Hata kodları ve doğrulama adımları
Webhook bildirimleri

Yanıt alanları ve hata kodları seçilen çözüme göre değişebilir.

Test kartları

Başarılı ödeme senaryosu
Yetersiz bakiye, CVV ve süre hatası
3D Secure doğrulama adımı

Kart listesi ve doğrulama bilgileri kuruma göre değişebilir.

Sandbox erişimi ve anahtarlar, hesabınız açıldıktan sonra tanımlanır.

Ücretsiz Başvuru →Test verilerinde gerçek müşteri bilgisi kullanmayın. Ayrıntı için: KVKK Aydınlatma Metni.

Sık sorulan sorular

Test ortamı hakkında.

Sandbox erişimini nasıl alırım?

Başvurunuz tamamlanıp hesabınız açıldıktan sonra test ortamı erişimi ve anahtarlarınız tanımlanır. Adımların tamamı için başvuru süreci sayfasına bakın.

Test ortamında gerçek para hareketi olur mu?

Hayır. Test ortamındaki işlemler kart ve hesap hareketine dönüşmez; yalnız entegrasyonun doğru çalıştığını görmek içindir.

Hangi test kartlarını kullanabilirim?

Test kartları ödeme kuruluşuna özeldir; numaraları ve 3D test değerini hesabınızın bağlı olduğu kuruluşun test dokümantasyonundan alırsınız. Hangi senaryoları denemeniz gerektiği için test kartları sayfasına bakın.

Canlıya geçerken ne değişir?

Test anahtarları yerine canlı anahtarlar kullanılır ve ödeme akışı gerçek kart işlemlerine açılır. Entegrasyon adımları için entegrasyon kılavuzu ve API dokümantasyonu.

Webhook bildirimlerini test edebilir miyim?

Test ortamında ödeme sonucuna göre bildirim gönderimi denenebilir; kapsam ve alanlar için webhook ve callback sayfasına bakın.

Entegrasyona başlayın

Önce başvurunuzu tamamlayalım.

Test ortamı erişimi hesap açılışıyla tanımlanır. Ön değerlendirme için başvuru formunu doldurun.

Ücretsiz Başvuru →

Başvuru ücretsizdir. Teklifi inceleyip karar verin.

Başvuru nasıl ilerler? →

Teknik sorularınız için:0212 909 00 87ya da WhatsApp’tan yazın

Ayrıntılar

Sanal POS Test Kartları

Test kartları ödeme kuruluşuna özeldir; numaraları ve her kartın hangi sonucu ürettiğini hesabınızın bağlı olduğu kuruluşun test listesinde bulursunuz. Gerçek para hareketi olmadan başarılı ve başarısız akışları görmek için en az şu dört senaryoyu deneyin:

Test senaryoları
Senaryo	Yaygın yanıt kodu	Kodunuzda doğrulayın
Başarılı ödeme	—	siparişi sunucu doğrulamasından sonra kapatma
Yetersiz bakiye	51	sepeti koruma, mesaj
Hatalı CVV	82	mesaj, yeniden deneme
Süresi dolmuş kart	54	mesaj

SKT, CVV ve 3D test değeri kuruluşun test dokümantasyonunda yazar; bazı test ortamları ileri tarihli herhangi bir SKT ve CVV kabul eder, bazıları sabit değer verir.

Tam liste ve kart etiketleri: test kartları → · Özelliklerinize göre test planı: Sandbox test planı →

Kart listesi, doğrulama bilgileri ve desteklenen senaryolar seçilen ödeme kuruluşunun çözümüne göre değişebilir.

Canlıya Geçiş

Canlıya geçmek için test anahtarı ve test uç adresi yerine canlı anahtarı ve canlı adresi koyarsınız; dönüş (callback) ve webhook adreslerinin canlı alan adınızı gösterdiğini de kontrol edin. Geçişten sonraki ilk gerçek ödemeyi panelde ve kendi sipariş kaydınızda karşılaştırarak doğrulayın.

Test ortamında akış doğrulandıktan sonra canlı anahtarlara geçilir. Entegrasyon adımları entegrasyon kılavuzu ve API dokümantasyonu sayfalarında; hazır kod örnekleri için örnek kodlar ve PHP, Node.js, Python SDK sayfalarına bakabilirsiniz.

Ödeme sonucunu kendi sisteminize işlemek için webhook ve callback; dönen hata kodlarının karşılığı için POS hata kodları sayfasını kullanın.