Skip to main content
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 TypeWhat It Detects
Suspicious click patternsUnusual click volume or timing from a single affiliate
Self-referralsAffiliate referring their own purchases
Geographic anomaliesClicks from unexpected regions
Conversion velocityToo many conversions in a short time window
Cookie stuffing indicatorsSigns of forced cookie injection

​
Trust Tiers

Affiliates are assigned trust tiers based on their history:
TierBehavior
NewAll conversions require manual review
TrustedConversions auto-approved, flags still generated
VerifiedFull 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',
})

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

​
Resolution Options

ResolutionEffect
dismissedFlag closed, no action taken (false positive)
confirmedFlag 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.