Sandbox ortamı
Sandbox nedir?
Sandbox, canlı veri ve ücretlendirme riski olmadan entegrasyon testi yapmanız için ayrılmış ortamdır. Sınırsızdır, kredi tüketmez ve yalnızca sentetik senaryolar döner. API sözleşmesi production ile aynıdır; gerçek TCKN kullanmayın.
Ücretsiz production kredileri sandbox ile karıştırılmamalıdır: live_ anahtarları gerçek eşleşme kontrolü yapar ve kredi kullanır. Base URL canlı ortamla aynı host olabilir; ortam ayrımı uygulama tipi ve anahtar öneki (test_ / live_) ile yapılır.
API anahtarı öneki
Sandbox uygulamalarının anahtarı test_ ile başlar.
Sentetik test T.C. kimlik numaraları
Aşağıdaki numaralar checksum kurallarına uygundur ve belirli sonuçları deterministik üretir.
| T.C. kimlik no | Sonuç özeti | Açıklama |
|---|---|---|
| 10000000146 | true | Başarılı doğrulama (verified: true) |
| 20000000282 | true | Başarılı doğrulama (verified: true) |
| 30000000328 | false | Eşleşme yok (verified: false) |
| 40000000464 | false | Eşleşme yok (verified: false) |
| 50000000500 | true (async) | Async gecikme simülasyonu (kuyrukta işlenir) |
| 60000000646 | — | Hata / başarısızlık simülasyonu (verified: null) |
Production’a geçiş
- Aktif abonelik ve yeterli kredi ile production tipinde yeni bir uygulama oluşturun veya mevcut planınızı doğrulayın.
live_ile başlayan API anahtarını ve yenisecretdeğerini güvenli şekilde dağıtın.- Ortam değişkenlerinde
BASE_URLve anahtarları production değerleriyle güncelleyin; webhook URL ve imza doğrulamasını tekrar test edin. - İlk canlı isteklerde düşük hacimle başlayıp log ve kredi kullanımını panelden izleyin.