API v1

Lunixi API'sinin sürümü URL yolunda taşınır:

https://api-gateway.lunixi.com/api/v1/...

Bu sayfa v1'in ne kapsadığını tutar. Bundan sonraki değişiklikler burada tarihli olarak yayınlanır.

Panel, portal ve partner yüzeylerinin kendi kökleri vardır (/api/panel/v1, /api/portal/v1, /api/partner/v1). Bu dokümantasyon yalnız /api/v1 müşteri yüzeyini anlatır — bir uç burada yoksa entegrasyona açık değildir.

v1'in kapsadığı ürünler

Ürün	Kapsam
Payment Orchestrator	Ödeme alma, 3DS, taksit ve vade farkı, kart saklama, iade ve itiraz
Cüzdan	Yükleme, transfer, çekim, harcama politikası, QR tahsilat, webhook
Fraud & Fraud AI	Gerçek zamanlı karar ucu, akış yayınlama, kural motoru
Identity	Cihaz ve oturum sinyalleri, kimlik zekâsı
Sanction	İsim / hesap / işlem / cüzdan taraması, olumsuz medya, dolaylı maruziyet
Automation	İş akışı otomasyonu ve dış sağlayıcı bağlantıları

Fraud tarafında v1 ile gelen yüzey

Tek karar ucu — POST /api/v1/fraud/decisions/evaluate, allow / force_3d / review / block
39 akış düğümü — akış kontrolü, hız/örüntü sayımı, liste ve yaptırım taraması, bağlam getirme, dış çağrı, kendi JavaScript'iniz, operasyon düğümleri
53 hazır kural şablonu — TCMB Risk Yönetimi Rehberi 3.1.1–3.1.4 (37), havale / remittance (5), hesap ele geçirme (5) ve UK APP / PSR (6) paketleri; her biri kendi neden-kodu önekiyle → İşlem İzleme
Olay omurgası — POST /api/v1/fraud/events/transactions ve /batch; geçmişe dayanan kurallar (hız, temel çizgi sapması) bu besleme olmadan çalışmaz → Olay Alımı API'si
Karar kayıtları — GET /api/v1/fraud/decision-logs ve /{traceId}; imleçli sayfalama → Karar Kayıtları

Yaptırım tarafında v1 ile gelen kaynaklar

On kaynak çekiliyor: OFAC · OFAC_NONSDN · CSL · UN · EU · UKSL · CA_SEMA · MASAK · SPK_BAN · TR_TERROR_WANTED

Son üçü Türkiye kaynaklıdır ve canlı çekilir — Türkiye'de faaliyet gösteren bir kuruluş için yalnız uluslararası listelere bakmak yeterli değildir.

Entegrasyondan önce bilinmesi gereken üç davranış

Bunlar v1'in bilinçli tasarım kararlarıdır ve doğal varsayımın tersini yapar. Üçü de aynı ilkeden gelir: belirsizlik, güvenli tarafa yazılır.

🚫

1 — Eksik alan kuralı susturmaz, tetikleyebilir. Kural değerlendirici üç durumludur (true · false · indeterminate). İşlenenler eksikse ya da tipleri uyuşmuyorsa sonuç indeterminate olur ve eşleşmiş sayılır. Bir kuralı susturmak için alanı boş bırakmayın; kuralın kapsamını daraltın. → Karar API'si

🚫

2 — 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ı döndürür (varsayılan review). "Kural yazmadım" ≠ "risk yok". → Akışlar ve Çözümleme

🚫

3 — Akış hatası fail-closed'dır. Akış çalışırken hata alırsa karar en az reviewe yükselir; mevcut bir block asla aşağı çekilmez.

Tutarlar

Tüm tutarlar minör-birim tam sayıdır — 250000 = ₺2.500,00. Ondalık gönderilmez.

Kimlik doğrulama

Kayıtlı Ed25519 anahtarınızla POST /api/v1/auth/token'a imzalı istek atıp kısa ömürlü Bearer token alırsınız. Kimliği doğrulanan taraf (merchantId) token'dan okunur, istek gövdesinden asla — gövde başka bir kiracıyı taklit edemez. → Kimlik Doğrulama

Değişiklikler

2026-10-05

Olay Alımı API'si ayrı bir referans sayfası oldu: zorunlu alanlar, olay türü sözlüğü, istek başına imza sözleşmesi, tekrar bastırma ve parti sınırı. → Olay Alımı API'si
Karar Kayıtları ayrı bir referans sayfası oldu: süzgeçler, imleçli sayfalama ve kayıt alanları. → Karar Kayıtları
Fraud hata kodları, kota başlıkları ve yeniden deneme kuralları tek sayfada toplandı. → Hatalar ve Yeniden Deneme
Karar API'si sayfasına kanal taksonomisi alanları (channel, surface, stage, operationKind, authModeRequested, authModeApplied, transactionRef, subjectId, subMerchantRef, identityAssertion) ve session objesi eklendi.
Yanıt zarfı düzeltildi: fraud yanıt örneklerinde success alanı gösteriliyordu; gerçek zarf üst seviyede status taşır.
Şablon sayısı düzeltildi: bu sayfa 49 hazır kural şablonu yazıyordu; şablon galerisinde 53 şablon vardır.

Yapay Zekâ Okuryazarlığı Model Denetim Kayıtları