Kural Motoru

Payantis Platform, Yetkilendirme Kontrolleri (Authorization Controls), Harcama Limitleri (Velocity Controls) ve Ücret (Fee) tanımlarının belirli koşullara göre çalışmasını sağlamak için esnek bir kural tabanlı karar mekanizması sunar. Bu mekanizma, popüler NCalc kütüphanesini temel alır ve tanımlanan kuralların işlem anındaki veya kart/müşteri bilgilerine göre dinamik olarak değerlendirilmesine olanak tanır.

Kurallar, ilgili kontrol veya tanımının rule alanına veya bu tanımları varlıklarla (kart, ürün, grup, segment) ilişkilendiren Link API çağrılarının rule alanına metin olarak yazılır.

Kural Yazımında Kullanılabilen Alanlar

Kural ifadeleri yazılırken, işlemin veya kart/müşterinin özelliklerine erişmek için aşağıdaki alanlar kullanılabilir. Bu alanlar iki ana kategoride gruplanmıştır:

1. İşlem Bazlı Kural Alanları

Bu alanlar, değerlendirme anındaki tek bir işleme ait bilgileri içerir. Yetkilendirme Kontrolleri, Harcama Limitleri ve İşlem Ücretleri tanımlarında kullanılabilirler.

Alan Adı	Veri Tipi	Açıklama	Örnek / Kısıt
`TransactionCode`	Enum	İşlemin tipi kodu.	Örn: `Purchase`, `CashWithdrawal`
`TransactionAmount`	Sayı (Decimal)	İşlemin orijinal tutarı (işlemin yapıldığı para biriminde).	Değer Aralığı: 0 - 999...99. Null olabilir.
`TransactionCurrency`	Sayı (Integer)	İşlem para birimi kodu (ISO 4217 numeric).	Değer Aralığı: 1-999. Null olabilir. Örn: 949 (TRY)
`BillingCurrency`	Sayı (Integer)	Hesap özeti/ekstre para birimi kodu (ISO 4217 numeric).	Değer Aralığı: 1-999.
`BillingAmount`	Sayı (Decimal)	Hesap özeti/ekstre tutarı (hesap para biriminde).	Değer Aralığı: 0 - 999...99. Null olabilir.
`Mcc`	Sayı (Integer)	İşyeri Kategori Kodu (Merchant Category Code).	Değer Aralığı: 1-9999. Null olabilir. Örn: 5411
`MccGroup`	Sayı (Integer)	İşyeri Kategori Kodu Grubu (Platform tarafından ilgili MCC'ye göre atanır).	Değer Aralığı: 1-9999. Null olabilir.
`TerminalType`	Enum	İşlemin yapıldığı terminalin tipi.	Örn: `Atm`, `Pos`, `Vpos`
`PosEntryMode`	Enum	İşlemin POS (Point of Sale) cihazına giriş yöntemi.	Örn: `Chip`, `ECommerce`, `ManualEntry`
`SecurityLevelIndicator`	Enum	Güvenlik Seviyesi Göstergesi (genellikle 3D Secure durumunu belirtir).
`PinUsed`	Mantıksal (Bool)	İşlem sırasında PIN kullanılıp kullanılmadığı bilgisi.	`true`, `false`.
`CardholderPresence`	Enum	Kart sahibinin işlem anında fiziksel olarak bulunup bulunmadığı durumu.
`TransactionDomain`	Enum	İşlemin yapıldığı coğrafi bölge.	Örn: `Domestic`, `International`
`TransactionCountry`	Metin (String)	İşlemin yapıldığı ülke kodu (ISO 3166-1 alpha-3 formatında).	Uzunluk: 1-3 karakter (örn. "TUR", "USA")
`TransactionCity`	Metin (String)	İşlemin yapıldığı şehir bilgisi (terminalden gelen).	Uzunluk: 1-13 karakter
`TransactionMerchant`	Metin (String)	İşlem mesajından gelen işyeri adı.	Uzunluk: 1-26 karakter
`MerchantNo`	Metin (String)	İşlem mesajından gelen işyeri numarası.	Uzunluk: 1-15 karakter
`BkmId`	Metin (String)	BKM (Bankalararası Kart Merkezi) tarafından atanan üye işyeri ID'si (Türkiye işlemleri için geçerlidir).	Uzunluk: 1-8 karakter
`AcquirerId`	Metin (String)	İşlemi başlatan üye işyeri bankasının (Acquirer) kimlik numarası.	Uzunluk: 1-11 karakter
`TransactionNetwork`	Enum	İşlemin geçtiği ödeme ağı veya şema.	Örn: `Onus`, `Domestic`, `Visa`

Not: Enum tipleri için geçerli değerler, ilgili API'lerin açıklamalarında veya Payantis Platformu'nun sağladığı veri sözlüğünde bulunabilir.

2. Kart ve Müşteri Bazlı Kural Alanları

Bu alanlar, işlemin yapıldığı kartın kendisine veya kartın ilişkili olduğu müşteriye ait statik veya yarı statik bilgileri içerir. Yetkilendirme Kontrolleri, Harcama Limitleri ve her türlü Ücret (İşlem, Basım, Yıllık) tanımlarında kullanılabilirler.

Alan Adı	Veri Tipi	Açıklama	Örnek / Kısıt
`TokenId`	Sayı (Long)	Kartın benzersiz Token ID'si.	Değer Aralığı: > 0. Null olabilir.
`CustomerNo`	Metin (String)	Müşterinin Kurum tarafından verilen benzersiz numarası.	Uzunluk: 1-50 karakter
`CardProductCode`	Metin (String)	Kartın ait olduğu ürünün kodu.	Uzunluk: 1-12 karakter
`CardProductGroup`	Sayı (Integer)	Kartın ait olduğu ürün grubunun ID'si.	Değer Aralığı: > 0.
`CardBin`	Metin (String)	Kart numarasının ilk 6 veya 8 hanesi (Bank Identification Number).	Uzunluk: 6-8 karakter
`CardBrand`	Enum	Kartın markası/şeması.	Null olabilir. Örn: `Visa`, `MasterCard`, `Troy`
`CustomerType`	Enum	Müşterinin tipi.	Null olabilir. Örn: `Individual`, `Company`
`CustomerSegment`	Sayı (Integer)	Müşterinin ait olduğu segmentin ID'si.	Değer Aralığı: > 0.
`Gender`	Enum	Müşterinin cinsiyeti.	Örn: `Male`, `Female`
`DisabledType`	Enum	Müşterinin engel durumu.	Örn: `Normal`, `Visual`
`CustomerResidencyCity`	Metin (String)	Müşterinin kayıtlı ikametgah (residency) şehri.	`CardStatus`
`CardUsageType`	Enum	Kartın kullanım tipi (ürün tanımından gelir).	Null olabilir. Örn: `Prepaid`, `Debit`
`IsChildCard`	Mantıksal (Bool)	Kartın bir ek kart (child card) olup olmadığı.	`true`, `false`.
Uzunluk: 1-100 karakter

NCalc ile Kural Yazımı

NCalc, standart matematiksel ve mantıksal operatörleri destekler. Alanları kullanarak karmaşık kurallar oluşturabilirsiniz:

Eşitlik/Karşılaştırma: ==, !=, >, <, >=, <=

Mantıksal Operatörler: and, or, not

Metin İşlemleri: like , not like (benzerlik kontrolü, örn. TransactionMerchant like '%Market%')

Liste Kontrolü: in, not in(bir değerin listede olup olmadığını kontrol etme, örn. Mcc in (5812, 5813))

Fonksiyonlar: if(koşul, doğruysa_değer, yanlışsa_değer), IsNullOrEmpty(AlanAdi) vb. NCalc'ın desteklediği diğer fonksiyonlar kullanılabilir.

Örnek Kurallar:

Sadece nakit çekme işlemlerini hedefle:
TransactionCode == 'CashWithdrawal'

100 TRY üzerindeki uluslararası işlemleri hedefle:
TransactionDomain == 'International' and TransactionAmount > 100 and TransactionCurrency == 949

E-ticaret olmayan ve PIN kullanılmayan işlemleri hedefle:
PosEntryMode != 'ECommerce' and PinUsed == false

Belirli MCC gruplarındaki (örneğin Giyim=10, Market=15) veya belirli bir işyerindeki işlemleri hedefle:
MccGroup in (10, 15) or MerchantNo == '1234567890'

Bireysel müşterilerin Ön Ödemeli kartları ile yapılan işlemleri hedefle:
CustomerType == 'Individual' and CardUsageType == 'Prepaid'

Hem yurtiçi hem de 5411 MCC'li işlemleri hedefle:
TransactionDomain == 'Domestic' and Mcc == 5411

Bu alanları ve operatörleri kullanarak, platformun davranışını kendi iş kurallarınıza göre hassas bir şekilde ayarlayabilirsiniz.

Kural Yazımında Kullanılabilen Alanlar#

1. İşlem Bazlı Kural Alanları#

2. Kart ve Müşteri Bazlı Kural Alanları#

NCalc ile Kural Yazımı#

Kural Yazımında Kullanılabilen Alanlar

1. İşlem Bazlı Kural Alanları

2. Kart ve Müşteri Bazlı Kural Alanları

NCalc ile Kural Yazımı