{"uid":"cap_67lmakwDgqlJoMTeYlCVU","slug":"brainiac-promotion-abuse-detection-f497c1c5","name":"BRAINIAC Promotion Abuse Detection","description":"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.","url":"https://www.brainiac.software/api/v1/ecommerce-fraud/promotion-abuse-detect?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FuGdx813BNrVBSLln6KeI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a batch of e-commerce orders to detect promotion/coupon code abuse patterns such as repeat use by the same customer or household","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Coupon repeat-use fraud sweep","prompt":"I've got a CSV of 150 orders from this week — can you scan them for customers who used the same promo code more than 3 times? Flag any patterns that look like promo abuse."},{"title":"New campaign abuse monitoring","prompt":"We just launched a SAVE20 promo code and I think some customers are creating multiple accounts to abuse it. Here's the order JSON for the last 48 hours — check for repeat use of SAVE20 by the same customer or from the same IP address."},{"title":"Referral program abuse detection","prompt":"Before I fulfill these orders, can you run a promo abuse check on them? I want to see if the same billing address or card is being used across multiple accounts to redeem our referral discount codes — here's the order list."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T12:36:03.611Z","isFirstParty":false,"canonicalSlug":"brainiac-promotion-abuse-detection-f497c1c5"}