Sıkça sorulan sorular

Merak ettikleriniz, kısa ve net.

Hizmet, süreler, entegrasyon, veri güvenliği ve abonelik hakkında en çok sorulan sorular.

Hizmet

Kimlik API tam olarak ne yapar?
TC kimlik doğrulama talebinizi API ile alır, sizin adınıza kontrol eder ve sonucu yazılımınıza iletir. Doğrulamayı ekibinizin günlük işi olmaktan çıkarır; manuel kontrole kişi ayırmadan süreçlerinizi hızlandırırsınız. Nasıl çalışır
Doğrulamayı kim, nasıl yapıyor?
Kontroller, sözleşme ve gizlilik taahhüdüyle bağlı doğrulama ekibimiz tarafından, ekip üyesinin kendi oturumunda ve denetiminde yürütülen manuel doğrulama işlemiyle yapılır; resmî olmayan bir veri kaynağı kullanılmaz. Kimlik bilgileri ekip üyesinin ekranında maskeli gösterilir.
Bu hizmet resmî bir kurum mu?
Hayır. Kimlik API, Antandros Teknoloji A.Ş. tarafından işletilen ticari bir hizmettir. NVİ/KPS ile resmî ortaklığı veya yetkilendirmesi yoktur ve resmî T.C. / KPS API’si değildir. Tek başına KYC / AML çözümü değildir; kendi hukuki ve uyum değerlendirmenizi yapmanız gerekir.
Kendi KPS erişimimizi almak istiyoruz. Yardımcı olur musunuz?
Evet. Başvurunun teknik ve hukuki hazırlığında, altyapı kurulumunda ve takibinde yanınızdayız; süreç boyunca doğrulamalarınız API'mizle kesintisiz sürer. Ayrıntılar KPS danışmanlığı sayfasında.

Süre ve entegrasyon

Sonuç ne kadar sürede gelir?
Talep anında kabul edilir ve size bir request_id döner. Sonuç çoğunlukla 1–2 dakika içinde gelir; yoğun anlarda bu süre uzayabilir. Bu bir hizmet seviyesi taahhüdü değil, beklenen süredir. Daha önce doğrulanmış bilgiler önbellekten anında döner. Ayrıntılar doğrulama endpoint ve polling bölümlerinde.
Neden async çalışmalıyım?
Çünkü sonuç birkaç dakika sürebilir. Talebi mode: async ile gönderin, sonucu webhook ile alın. sync istekler hâlâ kabul edilir ama önerilmez: en fazla 90 saniye bekler, sonuç gelmezse istek async olarak sürer ve 202 döner.
Doğrulamayı kayıt formuma nasıl yerleştirmeliyim?
Doğrulamayı kaydı tamamlamanın şartı yapmayın. Kullanıcınızı içeri alın, talebi arka planda gönderin ve doğrulamanın sürdüğünü söyleyin. Yalnızca doğrulanmış kimlik gerektiren işlemleri sonuç gelene kadar "doğrulama bekleniyor" durumunda tutun. Örnekler: Entegrasyon rehberi.
Webhook zorunlu mu?
Zorunlu değil ama önerilir. Sonucu polling ile de sorgulayabilirsiniz; webhook sonuç hazır olduğunda size kendiliğinden haber verir. Kurulum ve imza doğrulaması Webhooks bölümünde.
Sandbox nedir?
Sandbox sınırsız ve ücretsizdir: sabit test numaralarıyla eşleşme, eşleşmeme, gecikme ve hata senaryolarını gerçek veri kullanmadan denersiniz. Kredi tüketmez ve canlı veriye karışmaz. Ayrıntılar Sandbox dokümantasyonunda.
Önbellek nasıl çalışır?
Aynı bilgilerle tekrarlanan istekler, belirli bir süre içinde önbellekten anında yanıtlanabilir; bu hem maliyeti hem bekleme süresini düşürür. Önbelleği atlama seçenekleri Önbellek bölümünde.

Veri ve güvenlik

Kimlik verileri saklanıyor mu?
Ham kimlik bilgileri (TCKN, ad, soyad, doğum tarihi) yalnızca talep sonuçlanana kadar şifreli tutulur ve sonuç iletilince silinir; kaçan kayıt kalmaması için her gün ayrıca bir temizlik kontrolü çalışır. Kalıcı kayıtlarda yalnızca maskeli değerler ve geri döndürülemeyen bir özet bulunur. Yeniden deneme ve denetim için request_id değerini kendi tarafınızda saklayın. Teknik model: Veri saklama modeli.
Doğrulamayı yapan kişi kimlik bilgilerimi görüyor mu?
Bilgiler ekip üyesinin ekranında maskeli gösterilir; resmî formu yardımcı uygulama doldurur. Maskelemeyi kapatmış bir cihaza hiçbir iş atanmaz. Bu bir ekran maskelemesidir; ekip üyeleri ayrıca sözleşme ve gizlilik taahhüdüyle bağlıdır. Ayrıntılar Güvenlik sayfasında.

Abonelik ve kredi

Kredi ne zaman düşer?
Kredi yalnızca eşleşme veya eşleşmeme sonucu üreten sorgularda düşer. Sonuç üretilemeyen (failed) talepler ücretsizdir; talep işlenirken kredi rezerve edilir.
Abonelik nasıl çalışır?
Paketler aylık bir kullanım hakkıdır. Her ay plan tutarı tahsil edilir; kayıtlı kartınız varsa tutar kartınızdan çekilir. Tahsilatla birlikte o aya ait doğrulama hakkınız yüklenir: 5.000’lik pakette o ay 5.000 doğrulama yapabilirsiniz.
Aboneliği iptal edebilir miyim?
Evet, kontrol panelinden. Ödemesi alınmış ayın kalan hakkını dönem bitene kadar kullanırsınız; sonraki ay yeni tutar çekilmez ve yeni hak yüklenmez.
Ay içinde bitmeyen hak sonraki aya devreder mi?
Hayır. Yeni dönem başladığında kalanın üzerine eklenmez; yeniden planınızdaki kadar hak yüklenir. 5.000’lik pakette 1.200 doğrulama yaptıysanız, yeni ayda bakiyeniz yine 5.000 olur.
Aylık hakkım biterse ne olur?
Sonradan faturalanan aşım olmaz: yeni canlı talepler 402 insufficient_credits ile reddedilir. Faturalama sayfasından otomatik ek krediyi açtıysanız, bakiye bitince kayıtlı kartınızdan seçtiğiniz paket (100, 500 veya 1.000 kredi) planınızın ek kredi fiyatıyla alınır ve kullanım sürer. Ek krediler de dönem sonunda sıfırlanır. Kredi ve hesap uçları API dokümantasyonunda.

Cevabını bulamadınız mı?

Sorunuzu iletişim formundan yazın; ekibimiz en kısa sürede dönüş yapar.

İletişim formu