KodexakodéxaShieldAPI Reference
https://shield.kodexa.systems/apiPortal →
Transaction Layer

Fraud-AI

Coming soon

Real-time fraud detection at the transaction level. Card fraud, account takeover, synthetic identity and first-party fraud detection using behavioral signals.

This plugin is in development. The API schema below is planned and subject to change. You can design your integration now using this reference.

Endpoint

POST/api/fraud/detect

Request parameters

ParameterTypeRequiredDescription
transaction_idstringYesYour unique transaction reference.
customer_idstringYesYour internal customer reference.
jurisdictionstringYesOne of: CA, AE, SA.
amountnumberYesTransaction amount.
currencystringYesISO 4217 currency code.
device_fingerprintstringNoDevice fingerprint from Device-AI plugin.
ip_addressstringNoCustomer IP address.

Response fields

ParameterTypeRequiredDescription
data.fraud_scoreintegerYesFraud risk score 0–1000.
data.fraud_typestringNoDetected fraud type if applicable.
data.statusstringYesapproved, rejected, or review_required.
data.block_transactionbooleanYesWhether to block the transaction immediately.

cURL

# Coming soon
curl -X POST \
  https://shield.kodexa.systems/api/fraud/detect \
  -H "Content-Type: application/json" \
  -d '{...}'

Code examples available when plugin launches