Skip to main content
PATCH
/
v1
/
program
/
fraud-rules
curl -X PATCH "https://api.affonso.io/v1/program/fraud-rules" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "self_referral_mode": "block",
    "duplicate_payout_mode": "block",
    "blocked_country_mode": "block",
    "blocked_country_config": {
      "countries": ["CN", "RU", "NG"]
    }
  }'

{
  "success": true,
  "data": {
    "self_referral_mode": "block",
    "cross_program_ban_mode": "off",
    "duplicate_payout_mode": "block",
    "suspicious_email_mode": "detect",
    "banned_referral_mode": "off",
    "paid_traffic_mode": "off",
    "blocked_country_mode": "block",
    "banned_referral_config": null,
    "blocked_country_config": {
      "countries": ["CN", "RU", "NG"]
    },
    "paid_traffic_config": null
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.affonso.io/llms.txt

Use this file to discover all available pages before exploring further.

Update your program’s fraud detection rules. All fields are optional. If no fraud rules exist yet, they will be created with defaults. Each rule mode accepts one of three values:
  • off — Rule is disabled
  • detect — Flag suspicious activity but allow the action
  • block — Prevent the action entirely

​
Body Parameters

​
self_referral_mode
string
Self-referral detection mode. Valid values: off, detect, block.
​
cross_program_ban_mode
string
Cross-program ban detection mode. Valid values: off, detect, block.
​
duplicate_payout_mode
string
Duplicate payout detection mode. Valid values: off, detect, block.
​
suspicious_email_mode
string
Suspicious email detection mode. Valid values: off, detect, block.
​
banned_referral_mode
string
Banned referral detection mode. Valid values: off, detect, block.
​
paid_traffic_mode
string
Paid traffic detection mode. Valid values: off, detect, block.
​
blocked_country_mode
string
Blocked country detection mode. Valid values: off, detect, block.
​
banned_referral_config
object | null
Configuration for banned referral detection. Set to null to clear.
​
blocked_country_config
object | null
Configuration for blocked country detection (e.g. {"countries": ["CN", "RU"]}). Set to null to clear.
​
paid_traffic_config
object | null
Configuration for paid traffic detection. Set to null to clear.

​
Response

Returns the updated fraud rules object. Same structure as the Get Fraud Rules response. 
curl -X PATCH "https://api.affonso.io/v1/program/fraud-rules" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "self_referral_mode": "block",
    "duplicate_payout_mode": "block",
    "blocked_country_mode": "block",
    "blocked_country_config": {
      "countries": ["CN", "RU", "NG"]
    }
  }'

{
  "success": true,
  "data": {
    "self_referral_mode": "block",
    "cross_program_ban_mode": "off",
    "duplicate_payout_mode": "block",
    "suspicious_email_mode": "detect",
    "banned_referral_mode": "off",
    "paid_traffic_mode": "off",
    "blocked_country_mode": "block",
    "banned_referral_config": null,
    "blocked_country_config": {
      "countries": ["CN", "RU", "NG"]
    },
    "paid_traffic_config": null
  }
}