Fraud Detection

How AgentRef detects and flags suspicious affiliate activity automatically.

AgentRef automatically monitors affiliate activity and flags suspicious patterns. You decide what to do with each flag.

How It Works

AgentRef analyzes clicks, conversions, and affiliate behavior in real-time. When something looks suspicious, a fraud flag is created for your review.

Flag Types

Flag Type	What It Detects
Suspicious click patterns	Unusual click volume or timing from a single affiliate
Self-referrals	Affiliate referring their own purchases
Geographic anomalies	Clicks from unexpected regions
Conversion velocity	Too many conversions in a short time window
Cookie stuffing indicators	Signs of forced cookie injection

Trust Tiers

Affiliates are assigned trust tiers based on their history:

Tier	Behavior
New	All conversions require manual review
Trusted	Conversions auto-approved, flags still generated
Verified	Full auto-approval, reduced monitoring

Affiliates move between tiers automatically based on their track record. You can also manually adjust tiers.

Viewing Flags

In the Dashboard

Go to your program dashboard → Fraud Flags to see all open flags with details about why they were raised.

Via API

Node.js

// List open flags
const flags = await client.flags.list({
  programId: 'prg_abc123',
  status: 'open',
})

// Get flag statistics
const stats = await client.flags.stats({
  programId: 'prg_abc123',
})

Resolving Flags

Review each flag and decide whether to dismiss it or take action:

Node.js

// Dismiss a flag (false positive)
await client.flags.resolve('flag_abc123', {
  resolution: 'dismissed',
})

// Confirm fraud and block the affiliate
await client.flags.resolve('flag_abc123', {
  resolution: 'confirmed',
})

Resolution Options

Resolution	Effect
dismissed	Flag closed, no action taken (false positive)
confirmed	Flag confirmed as fraud – associated conversions can be reversed

Webhook Integration

Subscribe to flag.resolved webhook events to keep your systems in sync:

{
  "type": "flag.resolved",
  "data": {
    "id": "flag_abc123",
    "affiliateId": "aff_def456",
    "type": "suspicious_click_pattern",
    "resolution": "dismissed",
    "resolvedAt": "2026-03-23T14:00:00.000Z"
  }
}

Combine fraud detection with the Webhooks integration to automatically update your CRM or alert your team when flags are raised.