2026 Rehberi

API Sandbox nasıl kullanılır? Başarıdan önce hata senaryolarını test edin

Hazır istek, yanıt, idempotency ve bakiye kontrolüyle bir cüzdan entegrasyonunun davranışını değerlendirin.

OOnexa Teknoloji Editör EkibiYayın: 2 Kasım 2026 · Güncelleme: 2 Kasım 2026

Sandbox, bir uç noktanın yanıt verdiğini görmekten fazlasıdır. Aynı isteğin iki kez gönderilmesi, bağlantının kopması veya kullanıcının bakiyesinin yetersiz olması gibi durumları güvenli test verileriyle anlamaya yarar. Entegrasyonun ürün deneyimini nasıl etkilediği bu aşamada görünür olur.

3 dk okuma2026 RehberiKaynak ve yayın ilkeleri ↗
01

İlk isteğiniz bir okuma işlemi olsun

Önce oturum bakiyesini görüntüleyin ve başlangıç değerini kaydedin. Ardından tek bir yükleme yapın; yanıtı, işlem kaydını ve bakiyeyi karşılaştırın. Böylece değişikliğin gerçekten hangi istekten kaynaklandığını anlayabilirsiniz. Müşteri demosu ile API Sandbox’ın ayrı test bakiyeleri kullandığını unutmayın.

02

Idempotency neden gerekir?

Stripe’ın geliştirici belgeleri, aynı anahtarla istek tekrarında sonuçların nasıl ele alındığına örnek sunar. Onexa Teknoloji test motorunda da desteklenen para hareketlerinde benzersiz istek kimliği kullanılır. Aynı işlemin aynı kimlikle tekrarı yeni bakiye yaratmamalıdır. Aynı kimlikle farklı tutar göndermek ise anlaşılır bir çakışma hatası üretmelidir.

03

Başarısızlığı bilinçli üretin

Alıcı bulunamadığında, yanlış PIN girildiğinde ve bakiye yetmediğinde ne olduğunu ayrı test edin. Yanıtın HTTP durumu kadar açıklayıcı hata kodu da önemlidir. Arayüz, teknik hata metnini olduğu gibi kullanıcıya göstermek yerine ne yapabileceğini anlatmalıdır. Bazı hatalarda yeniden deneme uygundur; bazıları veri düzeltme veya kullanıcı onayı gerektirir.

04

API sözleşmesini ürün diliyle okuyun

Bekleyen havale tamamlanmış yükleme değildir. Dönüşüm teklifi alınması da dönüşümün gerçekleştiği anlamına gelmez. İstek ve sonuçlar bu ayrımları korumalıdır. Geliştirici, tasarım ve operasyon ekipleri örnek yanıtları birlikte inceleyerek aynı durum adlarını kullanmalıdır.

05

Bir test oturumunda deneyin

Hazır isteğin gövdesini değiştirin, sonucu inceleyin ve işlem geçmişiyle karşılaştırın. Gerçek kart veya kimlik bilgisi kullanmayın.

  • Bakiye sorgula → örnek yükleme → bakiyeyi yeniden sorgula
  • Aynı anahtarla tekrar et → tutarın iki kez artmadığını doğrula
  • Farklı tutarla aynı anahtarı dene → çakışma yanıtını incele
  • Yetersiz bakiye oluştur → başarısız işlemde bakiyenin değişmediğini kontrol et
06

Uygulamalı örnek: aynı yüklemeyi iki kez gönderin

Önce TRY bakiyesini sorgulayın; örneğin 2.500 TL olduğunu kaydedin. 1.000 TL yüklemeyi bir idempotency anahtarıyla çalıştırın ve 3.500 TL sonucunu görün. Aynı gövdeyi aynı anahtarla yeniden gönderdiğinizde tutarın 4.500 TL’ye çıkmaması gerekir. Ardından anahtarı değiştirmeden tutarı farklı bir değer yapın; motorun çakışma davranışını inceleyin. Yeni, bağımsız bir yükleme yapmak istediğinizde ise yeni bir anahtar kullanın. Bu test API’nin iş kuralını gösterir; gerçek kart veya banka işlemi oluşturmaz. Yanıt kadar işlem geçmişini de kontrol ederek birden fazla kayıt oluşmadığını doğrulayın.

  • İşlem öncesi ve sonrası bakiyeyi kaydedin.
  • Yanıttaki tekrar bilgisiyle işlem kaydını karşılaştırın.
  • Farklı işleme aynı anahtarı yanlışlıkla vermeyin.
07

Test alanının sınırı

Bu site yüklenen kaynak ürünün yollarından uyarlanmış bir test motoru sunar. Üretim bankasına veya gerçek .NET servisine canlı bağlantı değildir. Oturum süresi ve istek sınırı vardır. Reset yalnızca ilgili test oturumunun örnek verilerini sıfırlar; gerçek bir finansal işlem geri alınmaz.

KAYNAKLAR VE KAPSAM

Başvurduğumuz kaynaklar.

Kaynaklar 2 Kasım 2026 tarihinde incelenmiştir. Sektör örnekleri Onexa Teknoloji’nin çözüm tasarımlarıdır; araştırma pazarları ve tarihler ilgili bölümde belirtilir.

SIK SORULANLAR

Aklınızdaki sorular.

Bu yazıdaki çözümü kendi işime nasıl uyarlayabilirim?+

İlk adım mevcut müşteri yolculuğunu ve işlem kayıtlarını birlikte incelemektir. İlgili yetenek sayfasından örnek akışı deneyebilir, ardından entegrasyon ve pilot kapsamını Onexa Teknoloji ile değerlendirebilirsiniz.

Fikrinizden başlayalım.

İşinizin bir sonraki adımını birlikte tasarlayalım.

Birlikte konuşalım
ONEXA TEKNOLOJİ

Çerez tercihlerinizi yönetin.

Analitik ve pazarlama izinleri birbirinden bağımsızdır. Seçiminizi dilediğiniz zaman değiştirebilir veya geri çekebilirsiniz. Çerez izni, e-posta/SMS aboneliği oluşturmaz.

Zorunlu

Tercih kaydı, güvenlik ve kullanıcı tarafından başlatılan test oturumu.

Her zaman etkin