SDK — Genel Bakış
Lunixi iki SDK ailesi yayınlar. İkisi de aynı platform sözleşmesine dayanır; farkları çalıştıkları ortamdan gelir.
| Aile | Nerede çalışır | Sayfası |
|---|---|---|
| Web | Tarayıcı — 7 ayrı bundle | Web SDK |
| Mobil | iOS · Android — Flutter ve React Native köprüleri | Mobil SDK |
İkisinde de geçerli olan
🚫
Karar istemcide verilmez. SDK kanıt üretir ve taşır; nihai kararı sunucu verir. Tamamen ele geçirilmiş bir istemci bile olumlu bir sonucu taklit edemez — çünkü sonucu üreten taraf o değildir.
- Fail-open değil — başarısız bir çağrı sessizce "geçti" dönmez, hata fırlatır. Yedek davranışı siz kurgularsınız.
- Ortam ayrımı anahtarla — anahtarınız hangi ortamda üretildiyse SDK o ortama konuşur. Ayrı bir yapılandırma bayrağı yoktur.
- Secret asla istemcide bulunmaz — ne tarayıcıda ne mobil pakette.
- Aynı hata zarfı ve aynı
requestIdkorelasyonu. → Hata Yönetimi
Kimlik doğrulama neden farklı
Tek gerçek fark burada:
| Web | Mobil | |
|---|---|---|
| Güven çapası | Origin başlığı — tarayıcı koyar, sayfa sahteleyemez | Cihaz attestation'ı ve token bağları |
| Anahtar | Publishable key (mk_{ortam}_pk_…) | Oturum bağlamı + native toplayıcı |
Tarayıcıda Origin vardır ve sahtelenemez, o yüzden publishable key + izinli origin listesi yeterli bir çapadır. Mobilde Origin diye bir şey yoktur — bu yüzden güven, cihazın kendisini kanıtlamasından ve işlem token'ının cihaza/oturuma/challenge'a bağlanmasından gelir.
Hangisini seçmeli
| İhtiyaç | Aile |
|---|---|
| Ödeme formu, müşteri portalı, fiyat tablosu | Web |
| Kart verisine hiç dokunmadan kart alanı | Web — Kart Alanı |
| Tarayıcıda kimlik doğrulama | Web — KYC SDK |
| Mobil uygulamada işlem anı risk ölçümü | Mobil — Mobile Threat |
| Mobil uygulamada kimlik doğrulama | Mobil — Native KYC (NFC + attestation) |
Nereden başlamalı
- Web SDK Genel Bakış — loader, dört entegrasyon modu, kimlik doğrulama tablosu
- Mobil SDK Genel Bakış — köprü/native ayrımı ve paketler