Entegrasyon Rehberi

Anahtarı üretin ve kaydedin

Ed25519 anahtar çifti üretin, public anahtarı panelden kaydedin, kid'i alın. Özel anahtar sunucunuzda kalır.

→ Hızlı Başlangıç

Token katmanını yazın

Uygulamanızda tek bir yerde toplansın: kanonik dizeyi kuran, imzalayan, token'ı basıp önbellekte tutan bir modül. Diğer her çağrı bu modülden token ister.

Bunu bir kez doğru yazarsanız tüm ürünlerde çalışır — kimlik doğrulama katmanı ortaktır.

Tarayıcı telemetrisini bağlayın (opsiyonel)

Cihaz ve davranış sinyallerini toplamak istiyorsanız Identity Web SDK'sını sayfanıza ekleyin. Headless'tır — mount edilecek bir widget yoktur.

<script src="https://cdn.lunixi.com/lunixi-identity.min.js"></script>

const client = await Lunixi.identity.init({
  sessionBootstrapUrl: '/lunixi/identity/session',
  subjectId: 'cus_8f2a9c',
  productContext: 'checkout',
});
const snapshot = await client.analyze();

sessionBootstrapUrl sizin sunucunuzdaki bir uçtur; oturum token'ını orada basarsınız. Secret key sayfaya hiç inmez.

→ Identity Web SDK

Kararı doğru anda alın

Fraud kararını parayı çekmeden önce isteyin. Elinizde ne bağlam varsa gönderin — motor yalnız aktif kurallarının başvurduğu alanları okur.

POST /api/v1/fraud/decisions/evaluate

Dönen karara göre davranın:

→ Karar API'si

Geçmişe dayanan kurallar için olay besleyin

Hız (velocity) ve temel çizgi sapması gibi kurallar tek işleme bakarak çalışamaz. "Bu müşteri son 24 saatte 12 işlem yaptı" bilgisi olay omurgasından gelir:

POST /api/v1/fraud/events/transactions      (tekli)
POST /api/v1/fraud/events/transactions/batch (toplu)

İzi saklayın

Her karar yanıtındaki requestId'yi ve kararın gerekçesini (code, reasonCodes, flowPath) kendi kaydınıza yazın. İtiraz, denetim ve destek talebinde bunlar aranır.

Webhook'ları kurun

Endpoint'inizi oluşturun, imza secret'ını kasanıza alın, doğrulamayı yazın. İlk sürümde tek işi: imzayı doğrulayın → kuyruğa yazın → 2xx dönün.

→ Webhook Kurulumu

Akışınızı yayınlayın

→ Akışlar ve Çözümleme