# BRAINIAC Promotion Abuse Detection

> BRAINIAC Promotion Abuse Detection is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-11).

Analyzes a batch of e-commerce orders to detect promotion/coupon code abuse patterns such as repeat use by the same customer or household

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/ecommerce-fraud/promotion-abuse-detect?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-promotion-abuse-detection-f497c1c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_67lmakwDgqlJoMTeYlCVU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-promotion-abuse-detection-f497c1c5 -d '<json body>'
```

Example prompt: Can you check these 50 orders from the past week for promo code abuse? I want to know if any customers are repeatedly using the same discount code — here's the order data with customer IDs, promo codes used, amounts, and IPs.

## When to prefer this

Use this endpoint when you need a lightweight, no-account, pay-per-call promotion abuse scan over a batch of orders without integrating a full fraud platform. It is especially well-suited for AI agents that need to flag promo abuse in real time at checkout or in a post-order review pipeline, particularly when the order volume is under 200 and the input data is already structured. Prefer this over building custom rule logic when you need interpretable signal codes and limitation disclosures built in.

## Known failure modes

- Exceeds 200 order limit — reduce batch size
- CSV/JSON parse failure if malformed input is supplied
- Missing required order fields (e.g. customer or promo) causing incomplete signal detection
- Patterns only computed from supplied orders, not historical data — abuse spanning older orders not in payload will be missed
- False negatives when customers use different identifiers across accounts

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with an overall abuse level (e.g. 'indicator'), a status field, an array of signals each describing a detected abuse pattern (code, rule, detail, affected order IDs, confirmed flag), a findings array summarizing each signal per order, a checkedAt timestamp, and a set of limitation notices clarifying the scope of the analysis. Also includes boolean flags: fraudConfirmed, orderBlocked, accountAccessed, paymentProcessed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "rules": {
   "type": "object",
   "properties": {
    "orders": {
     "type": "integer",
     "maximum": 50,
     "minimum": 3
    },
    "quantity": {
     "type": "integer",
     "maximum": 1000000,
     "minimum": 1
    },
    "smallAmount": {
     "type": "number",
     "maximum": 1000000,
     "minimum": 0
    }
   },
   "additionalProperties": false
  },
  "orders": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "ip": {
      "type": "string",
      "maxLength": 80
     },
     "card": {
      "type": "string",
      "maxLength": 40
     },
     "promo": {
      "type": "string",
      "maxLength": 40
     },
     "amount": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "status": {
      "type": "string",
      "maxLength": 40
     },
     "address": {
      "type": "string",
      "maxLength": 200
     },
     "country": {
      "type": "string",
      "maxLength": 40
     },
     "created": {
      "type": "string",
      "maxLength": 40
     },
     "currency": {
      "type": "string",
      "maxLength": 12
     },
     "customer": {
      "type": "string",
      "maxLength": 160
     },
     "quantity": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0
     },
     "billCountry": {
      "type": "string",
      "maxLength": 40
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "window": {
   "type": "integer",
   "maximum": 10080,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "level": "indicator",
  "status": "checked",
  "signals": [
   {
    "code": "promo_repeat",
    "rule": "same_customer_same_promo",
    "detail": "Customer C-1 uses code SAVE10 on 3 supplied orders.",
    "orders": [
     "P-1",
     "P-2",
     "P-3"
    ],
    "confirmed": false
   }
  ],
  "findings": [
   {
    "code": "promo_repeat",
    "kind": "indicator",
    "detail": "Customer C-1 uses code SAVE10 on 3 supplied orders.",
    "subject": "P-1"
   }
  ],
  "checkedAt": "2026-11-04T09:00:00.000Z",
  "limitations": [
   "Patterns are calculated only from the orders supplied in the request.",
   "One signal is an indicator. It does not mean the customer is fraudulent.",
   "No payment is processed, no order is blocked, and no merchant account is accessed.",
   "A full card number is not copied. A statistical outlier is not confirmed fraud."
  ],
  "orderBlocked": false,
  "fraudConfirmed": false,
  "accountAccessed": false,
  "paymentProcessed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-promotion-abuse-detection-f497c1c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
