POS / Terminal Tehdit

POS / Terminal Tehdit, Identity Intelligence'ın mağaza-içi, kart-mevcut (card-present) ortamlar için ayrı bir B2B yüzeyidir. Bir tarayıcı ya da mobil uygulama yerine, bir POS işlemini arkasındaki terminal ve kasiyere karşı skorlar — terminal kurcalaması, anormal kasiyer örüntüleri ve kayıtlı-filo sapmasını (drift) yüzeye çıkarır.

Identity Intelligence'ın geri kalanı gibi bu da bir kanıt sağlayıcıdır — terminal işlemi başına bir risk verdict'i döndürür ve kendi başına bloklamaz. Bu tarayıcı cihaz snapshot'ı DEĞİLDİR; iki yüzey birbirinden bağımsızdır.

⚠️

Yapılandırılabilir — enrollment gerektirir. POS tehdidi, kayıtlı terminaller ve kasiyerlere karşı değerlendirir. Değerlendirmelerin anlamlı olması için terminal filonuzu kaydetmeli ve yüzeyi yapılandırmalısınız (bir admin adımı). Kayıtlı olmayan bir terminalin karşı skorlanacağı bir referansı yoktur.

Bir işlemi değerlendirin

POST /identity/pos-threat/evaluate — sunucu tarafı, Authorization: Bearer <secret key>. Terminal, kasiyer ve işlem bağlamını gönderin; bir risk verdict'i alın.

curl https://api-gateway.lunixi.com/api/v1/identity/pos-threat/evaluate \
  -H "Authorization: Bearer at_live_5f3e2b1a..." \
  -H "Content-Type: application/json" \
  -d '{
    "subjectType": "pos_transaction",
    "subjectId": "sale_123",
    "paymentId": "pay_123",
    "terminal": {
      "globalTerminalId": "term_glob_123",
      "merchantTerminalId": "mterm_55",
      "terminalSerial": "device-serial-001",
      "terminalPlatform": "android_smartpos",
      "keyInjectionState": "valid",
      "tamperState": "clear",
      "secureBootVerified": true
    },
    "transaction": {
      "actionType": "sale",
      "amount": 1250.50,
      "currency": "TRY",
      "entryMode": "chip",
      "cvmMethod": "pin"
    }
  }'

Yanıt standart gateway zarfıdır; data, terminal işlemine kapsamlanmış reasonCodes ve findings ile birlikte kanonik identityRiskLevel verdict'ini taşır.

Filo & kararlar

Method	Path	Ne yapar
`GET`	`/identity/pos-threat/terminals`	Kayıtlı terminallerinizi listeleyin
`GET`	`/identity/pos-threat/cashiers`	Filo genelinde görülen kasiyerleri listeleyin
`GET`	`/identity/pos-threat/decisions`	Son terminal değerlendirmeleri
`GET`	`/identity/pos-threat/decisions/:id`	Tek bir değerlendirmenin tamamı
`GET`	`/identity/pos-threat/trace/:traceId/decisions`	Belirli bir trace'e bağlı POS kararları
`PATCH`	`/identity/pos-threat/terminals/:key/control-state`	Bir terminalin control-state'ini değiştirin (ör. kayıtlı bir terminali karantinaya alın ya da geri getirin)

Notlar

Ayrı yüzey. POS alanlarını tarayıcı cihaz snapshot'ıyla karıştırmayın — farklı hatlar tarafından değerlendirilirler.
Önce enrollment. Değerlendirmelerin sinyal taşıması için terminaller ve kasiyerler kaydedilmeli, yüzey yapılandırılmalıdır.

Sonraki adımlar

Mobil Tehdit — native uygulama yüzeyi
Risk Snapshot — paylaşılan verdict alanları
Sunucu API & Sorgular — analizleri okuma ve sorgulama

Mobil Tehdit Sunucu API