Yaptırım sorguları

Yaptırım sorguları kaynağı iki yönlüdür: tam kapsamlı sorgu tetikleme (yazma) ve birleşik sorgu geçmişi (okuma). Panelde yapılan aramalar ve API’den tetiklenen sorgular aynı geçmişe düşer.

`POST /v1/compliance/sanction-checks` — sorgu tetikleme

Verilen kriterlere göre MASAK, wanted ve PEP listelerinde sorgu çalıştırır; ayrıca şirketinizin müşteri kaydı ve müşteri sicil olaylarıyla eşleştirir. Sonuç log kaydı olarak yazılır.

İstek gövdesi

{
  "data": {
    "idNo": "1976926558",
    "fullName": "ÖRNEK KİŞİ",
    "surname": "ÖRNEK",
    "options": { "wantedQuery": true, "pepQuery": true }
  }
}

Alan	Tür	Kural
`data.idNo`	string	`idNo`, `fullName` veya `surname`’den en az biri zorunlu
`data.fullName`	string	Ad bazlı sorgular (masak/wanted/pep)
`data.surname`	string	Soyad bazlı daraltma (wanted/pep)
`data.options.wantedQuery`	boolean	Varsayılan `true`
`data.options.pepQuery`	boolean	Varsayılan `true`

Cevap — `201`

{
  "success": true,
  "data": {
    "id": "6a9c930093ea09f8ee9d115c",
    "query": { "idNo": "1976926558", "fullName": "ÖRNEK KİŞİ", "surname": null, "options": { "wantedQuery": true, "pepQuery": true } },
    "summary": { "masakCount": 0, "wantedCount": 0, "pepCount": 0, "hasCustomer": true, "customerEventCount": 0 },
    "matches": { "masak": [], "wanted": [], "pep": [] },
    "checkedAt": "2026-09-05T23:59:00.000Z"
  },
  "meta": { "requestId": "...", "timestamp": "..." }
}

Alan	Anlam
`summary.masakCount` / `wantedCount` / `pepCount`	Liste eşleşme sayıları
`summary.hasCustomer`	Şirket müşteri kaydında eşleşme var mı
`summary.customerEventCount`	Müşterinin sicil olayı sayısı
`matches`	Liste eşleşme içerikleri (tam kayıtlar)

Sorgu kaydına userId olarak tetikleyen API kullanıcısının kimliği yazılır; IP ve user-agent denetim amacıyla saklanır.

`GET /v1/compliance/sanction-checks` — birleşik sorgu geçmişi

Panel aramaları ve API sorgularının birleşik geçmişi. Varsayılan sıralama en yeni önce (createdAt:desc).

Sorgu parametreleri

Parametre	Tür	Açıklama
`filter[idNo]`	string	Sorgulanan TCKN/VKN
`filter[fullName]`	string	Sorgulanan ad soyad
`filter[startDate]` / `filter[endDate]`	date-time	`createdAt` aralığı
`filter[updatedSince]`	date-time	Artımlı senkronizasyon

Cevap alanları (liste öğesi)

id, idNo, fullName, surname, summary (eşleşme sayıları), createdAt, updatedAt

`GET /v1/compliance/sanction-checks/{id}` — sorgu detayı

Liste alanlarına ek olarak: query (tam kriter), matches (tam liste içerikleri), customer (eşleşen müşteri kaydı), customerEvents (müşteri sicil olayları), checkedAt.

Banka hareketleri için gömülü masak bölümü, müşteri bazlı sicil için Müşteri sicil olayları kaynağını da kullanabilirsiniz.

Başlangıç

API'ye Giriş

Müşteriler

Banka Entegrasyonu

Faturalar

Uyum (Compliance)

`POST /v1/compliance/sanction-checks` — sorgu tetikleme

İstek gövdesi

Cevap — `201`

`GET /v1/compliance/sanction-checks` — birleşik sorgu geçmişi

Sorgu parametreleri

Cevap alanları (liste öğesi)

`GET /v1/compliance/sanction-checks/{id}` — sorgu detayı

​POST /v1/compliance/sanction-checks — sorgu tetikleme

​İstek gövdesi

​Cevap — 201

​GET /v1/compliance/sanction-checks — birleşik sorgu geçmişi

​Sorgu parametreleri

​Cevap alanları (liste öğesi)

​GET /v1/compliance/sanction-checks/{id} — sorgu detayı

`POST /v1/compliance/sanction-checks` — sorgu tetikleme

İstek gövdesi

Cevap — `201`

`GET /v1/compliance/sanction-checks` — birleşik sorgu geçmişi

Sorgu parametreleri

Cevap alanları (liste öğesi)

`GET /v1/compliance/sanction-checks/{id}` — sorgu detayı