FraudSense SDK

Real-time device intelligence and fraud scoring SDK for React Native. Built for banks and fintechs across the Middle East & Africa.

Features

• 📱 Device Fingerprinting — Persistent SHA-256 device ID across reinstalls
• 🌍 IP Intelligence — Geolocation, proxy/datacenter detection, GPS mismatch
• 🎯 Behavioral Analysis — Touch patterns, typing speed, paste detection
• ⚡ Event-Aware Scoring — Different weights for LOGIN, PAYMENT, WITHDRAWAL
• 🔄 Replay Attack Detection — Session token reuse detection
• 📊 Device History — Risk trend tracking across sessions
• 🚀 Transaction Velocity — Detects card testing and automated bots

Installation

npm install fraudsense-sdk

Install peer dependencies:

npx expo install expo-battery expo-crypto expo-device expo-location expo-network expo-sensors expo-secure-store expo-localization

Quick Start

import FraudSense from 'fraudsense-sdk';

// 1. Initialize at app startup
await FraudSense.init({
  apiKey:   'fs_live_xxxx',
  endpoint: 'https://api.getfraudsense.com',
  debug:    false,
});

// 2. Score a transaction
const report = await FraudSense.getReport({ event: 'PAYMENT' });

// 3. Act on the result
if (report.riskLevel === 'CRITICAL') blockTransaction();
if (report.riskLevel === 'HIGH')     requestManualReview();
if (report.riskLevel === 'MEDIUM')   requestOTP();
if (report.riskLevel === 'LOW')      allowTransaction();

Configuration

| Option | Type | Default | Description | |--------|------|---------|-------------| | apiKey | string | — | Your FraudSense API key. Required. | | endpoint | string | — | API base URL. Required. | | collectGPS | boolean | true | Enable GPS collection. | | debug | boolean | false | Print logs to console. |

Event Types

FraudSense.getReport({ event: 'LOGIN' });
FraudSense.getReport({ event: 'REGISTER' });
FraudSense.getReport({ event: 'PAYMENT' });
FraudSense.getReport({ event: 'WITHDRAWAL' });
FraudSense.getReport({ event: 'PROFILE_UPDATE' });

Risk Levels

| Score | Level | Action | |-------|-------|--------| | 0–20 | LOW | Allow | | 21–45 | MEDIUM | Request OTP | | 46–70 | HIGH | Block and review | | 71–100 | CRITICAL | Block and flag |

Documentation

Full documentation at api.getfraudsense.com/docs

Get API Key

Sign up at api.getfraudsense.com — 1,000 free calls/month.

Support

[email protected]