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
  }
}
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
  }
}