Genel Bakış

Lunixi fraud motoru kural ve akış tabanlı, deterministik bir karar altyapısıdır. Bir işlemi gönderirsiniz; motor sizin yayınladığınız akışı koşturur ve allow / force_3d / review / block kararını, kararı üreten düğümlerin listesiyle birlikte döndürür.

İki cümlelik özet:

Kararı siz tasarlarsınız. Motor, sizin yayınladığınız kuralları koşturur — kapalı bir skor kutusu değildir.
Her karar açıklanabilir. Hangi akış, hangi düğüm, hangi kural, hangi neden kodu — hepsi yanıtta döner.

Entegrasyon yüzeyi tek bir çağrıdır: Karar API'si. Ödeme orkestratörümüzü kullanmanız gerekmez — kendi gateway'iniz, POS'unuz veya ödeme kuruluşunuz aynı uca bağlanır.

Bir karar nasıl üretilir

⚠️

Yapılandırılmamış işyeri sessizce allow ALMAZ. Yetenek paketi, kural grubu ve akış üçü de yoksa motor fraud.decision.unconfigured koduyla yapılandırılmış varsayılan kararı döndürür (varsayılan: review). "Kural yazmadım" durumu, "risk yok" anlamına gelmez.

Çözümleme — istek, yayınlanmış akışlar arasında merchantId · flowType · subjectType · integrationMode · productContext eksenlerinde eşleştirilir. Ayrıntı ve kapsam önceliği: Akışlar ve Çözümleme.
Yürütme — akış, start düğümünden başlayarak düğüm düğüm koşar. Dallanma if / switch düğümleriyle yapılır.
Karar — düğümler karar önerir; motor en şiddetli olanı alır. Kanonik şiddet sırası:
```
allow  <  force_3d  <  review  <  block
```
Bir düğüm block demişse, sonraki bir düğüm bunu allowa çekemez. Akış hata verirse duruş fail-closed'dır: karar en az reviewe yükselir, mevcut block aşağı çekilmez.

Akışta kullanabileceğiniz düğümler

Motorun gücü buradadır. Bugün 39 düğüm tipi koşuyor:

Kategori	Düğümler	Ne işe yarar
Akış kontrolü	`start` · `stop` · `subflow` · `parallel` · `merge`	Başlangıç/bitiş, alt akış çağırma, dalları eşzamanlı koşturup birleştirme
Kural ve mantık	`rule` · `if` · `switch` · `set-var` · `transform` · `safe-transform`	Koşul değerlendirme, dallanma, ara değişken üretme
Hız ve örüntü	`velocity-check` · `inter-arrival-check` · `event-count-check` · `distinct-count-check` · `history-aggregate-check`	Zaman penceresinde sayım, işlemler arası süre, benzersiz sayım, geçmiş toplamı
Liste ve tarama	`blacklist-lookup` · `sanction-lookup` · `sanction-account-screen` · `sanction-transaction-screen` · `sanction-wallet-screen` · `sanction-indirect-exposure`	Kara liste ve yaptırım taraması (dolaylı maruziyet dahil)
Bağlam getirme	`profile-lookup` · `payment-lookup` · `database-lookup` · `redis-get` · `redis-set` · `identity-snapshot-guard`	Müşteri profili, geçmiş ödeme, kendi veritabanınız, sayaç durumu
Dış çağrı	`http-request` · `grpc-call` · `webhook` · `connector-event-source`	Kendi servisinize veya üçüncü tarafa senkron/asenkron çağrı
Kendi kodunuz	`script`	Kendi JavaScript'inizi yayınlayıp akış içinde koşturursunuz — izole V8 ortamında, süre ve bellek tavanıyla
Kontrol ve operasyon	`idempotency-guard` · `rollout-gate` · `case-open` · `inline-limit-check` · `inline-limit-status` · `action`	Çift-çağrı koruması, kademeli açılım, vaka açma, satır-içi limit

database-lookup kendi veritabanınıza bakar. Bize bir bağlantı tanımlarsınız, akış içinde sorgu çalıştırırsınız — kendi müşteri geçmişinizi fraud kararına katmak için veri taşımanıza gerek kalmaz.

Yanıt: karar + gerekçe

Karar çağrısı yalnız bir etiket değil, kararın izini döndürür:

Alan	İçerik
`decision`	`allow` · `force_3d` · `review` · `block`
`score`	Sayısal risk skoru (düğümlerin biriktirdiği)
`code`	Karar kodu (ör. yapılandırılmamış merchant için `fraud.decision.unconfigured`)
`flowPath`	Kararı üretirken geçilen düğümlerin sırası
`matchedRules` · `matchedRuleGroups`	Eşleşen kural ve grup adları
`reasonCodes`	Makine-okunur neden kodları
`tags`	Akışın iliştirdiği etiketler
`actions`	Motorun önerdiği çalışma-zamanı eylemleri
`explainability`	`summary`, grup sonuçları, akış açıklaması

Alan alan sözleşme ve örnek istek/yanıt: Karar API'si.

Ne yapmadığımızı da söyleyelim

⚠️

Karar ucu deterministiktir. POST /api/v1/fraud/decisions/evaluate çağrısının sonucu, sizin yazdığınız kurallardan ve akış düğümlerinden üretilir — bir modelin olasılık çıktısından değil. Bu bilinçli bir tercihtir: düzenlemeye tabi bir karar yolunda, her kararın hangi kuraldan doğduğunun gösterilebilmesi gerekir.

score, bir modelin olasılık çıktısı değil, düğümlerin biriktirdiği sayısal ağırlıktır.
Ayrı bir makine öğrenmesi platformu vardır (model kayıt defteri, yönetişim, çağrı gözlemlenebilirliği ve işlem skorlama). Bugün panel yüzeyinden kullanılır — model davranışını incelemek ve senaryo denemek için. Karar ucunun akışına otomatik karışmaz; karar yolunda koşan şey yayınladığınız akıştır.
Yapay zekâ destekli akış taslağı: bir politikayı metin olarak yazarsınız, sistem size başlangıç akışı çıkarır. Taslağı siz gözden geçirip yayınlarsınız.
Davranışsal telemetriyi biz toplamayız; siz ölçer, karar çağrısında gönderirsiniz. Bkz. Davranışsal Risk Sinyalleri.

Nereden başlamalı

Karar API'si — tek uç, alan sözleşmesi, kimlik doğrulama.
Akışlar ve Çözümleme — akış yayınlama, kapsam önceliği, hangi isteğin hangi akışa düştüğü.
Davranışsal Risk Sinyalleri — telemetry alanı ve sessiz eleme kuralı.

Ödeme Fraud Önleme