Fraud Buster Client

A modern client library for integrating Hive Forensics A.I. Inc.'s Fraud Buster API into your Node.js or React projects. This package provides a simple and efficient way to connect to the API, submit transaction details, and receive real-time risk assessments.

Features

• Lightweight and optimized for both Node.js and browser environments (React compatible).
• Supports fraud detection for transactions.
• Simple integration using async/await.
• Built-in error handling for robust production deployments.

Installation

Install the package via npm:

npm install fraud-buster-client

Configuration

Set the API URL and API key in your environment variables.

Example .env file for Node.js or React projects:

FRAUD_BUSTER_URL="http://localhost:8000/api/transaction"
API_KEY="your-api-key-here"

Alternatively, you can pass the API URL and API key directly when creating the client instance.

Usage

React Frontend Example

1. Import and initialize the client:

import FraudBusterClient from 'fraud-buster-client';

const fraudClient = new FraudBusterClient({
  apiKey: process.env.API_KEY, // Environment variable
});

2. Evaluate a transaction:

(async () => {
  try {
    const transactionData = {
      product: "Rolex Watch",
      amount: 9500,
      location: "Florida",
      time: "2024-03-04T10:30:00Z",
      customerProfile: "Tech Enthusiast",
      onlinePurchase: true,
      paymentMethod: "Amex",
      shippingAddress: "PO BOX 8877 Los Angeles CA 90210",
      billingAddress: "2125 SW 955 Ave Miami Florida 33156",
      customerEmail: "sam@protonmail.com",
      customerName: "Steven Smith",
      isVPN: false,
      clientBrowser: "Chrome",
      deviceType: "Desktop",
      ipAddress: "192.168.1.186",
      deviceFingerprint: "abcd1234efgh5678",
      transactionFrequency: 2,
      accountAge: 365,
      emailDomain: "protonmail.com",
      addressMismatch: true,
      twoFactorAuth: false,
      referralSource: "Google Search",
      proxyOrVPN: true,
      orderQuantity: 1,
      strictness: 50
    };

    const response = await fraudClient.evaluateTransaction(transactionData);
    console.log("Fraud Assessment Result:", response);
  } catch (error) {
    console.error("Error:", error.message);
  }
})();

Node.js Backend Example

const FraudBusterClient = require('fraud-buster-client');

const fraudClient = new FraudBusterClient({
  apiKey: process.env.API_KEY,
  apiUrl: process.env.FRAUD_BUSTER_URL,
});

(async () => {
  try {
    const transactionData = { 
      product: "MacBook Pro",
      amount: 2500,
      paymentMethod: "Visa",
      ipAddress: "192.168.1.100",
      onlinePurchase: true
    };

    const response = await fraudClient.evaluateTransaction(transactionData);
    console.log("Fraud Assessment Result:", response);
  } catch (error) {
    console.error("Error:", error.message);
  }
})();

Response Format

A typical API response includes:

{
  "transactionId": "821c09c1-fdaa-4199-b3ea-c4b715f8a150",
  "ConfidenceLevel": "Medium",
  "Result": "Failed"
}

Risk Level Definitions

| Risk Level | Description | |----------------|-------------------------------------------| | 0 | Critical Risk - Immediate Failure | | 1 | High Risk - Manual Verification Required | | 2 | Failed | | 3 | Monitor Closely - Review Logs | | 4 | Low Risk - Auto Approved | | 5 | Safe Zone - Pass | | 6 | Caution - Review Recommended | | 7 | Additional Verification Needed (Fallback) |

License

This package is licensed under the MIT License. See the LICENSE file for details.

About

Developed by Hive Forensics A.I. Inc.
Visit us at hiveforensics.com

Key Updates

1. Standardized Environment Variables

   • Replaced REACT_APP_FRAUD_BUSTER_URL → FRAUD_BUSTER_URL for consistency in Node.js and React.

2. Enhanced Error Handling

   • The API client now logs errors before rethrowing them for better debugging.

3. Updated Example Code

   • Made frontend and backend examples clearer.