Fraud Detection

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

// 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',
})

flags = client.flags.list(
    program_id="prg_abc123",
    status="open",
)

stats = client.flags.stats(program_id="prg_abc123")

# List flags
curl "https://www.agentref.co/api/v1/flags?programId=prg_abc123&status=open" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"

# Flag stats
curl "https://www.agentref.co/api/v1/flags/stats?programId=prg_abc123" \
  -H "Authorization: Bearer ak_live_YOUR_KEY"

Resolving Flags

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

// 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',
})

curl -X POST "https://www.agentref.co/api/v1/flags/flag_abc123/resolve" \
  -H "Authorization: Bearer ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resolution": "dismissed"}'

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.

Getting Started

Merchant Guide

Agent Integration

Tracking

Integration Guides

Webhooks

For Affiliates

Resources

How It Works

Flag Types

Trust Tiers

Viewing Flags

In the Dashboard

Via API

Resolving Flags

Resolution Options

Webhook Integration

​How It Works

​Flag Types

​Trust Tiers

​Viewing Flags

​In the Dashboard

​Via API

​Resolving Flags

​Resolution Options

​Webhook Integration

How It Works

Flag Types

Trust Tiers

Viewing Flags

In the Dashboard

Via API

Resolving Flags

Resolution Options

Webhook Integration