{"uid":"cap_g_Bds1_i1lnIXPWg7SGMg","slug":"brainiac-merchant-identity-resolve-4efea368","name":"BRAINIAC Merchant Identity Resolve","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/payment-intelligence/merchant-identity-resolve?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"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},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"type":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12}},"additionalProperties":false},"maxItems":100},"merchants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":20},"category":{"type":"string","maxLength":120}},"additionalProperties":false},"maxItems":400},"corrections":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string","maxLength":120},"from":{"type":"string","maxLength":120},"merchant":{"type":"string","maxLength":200},"transactionId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":400},"transactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"mcc":{"type":"string","maxLength":20},"date":{"type":"string","maxLength":40},"amount":{"type":"number","maximum":1000000000,"minimum":-1000000000},"status":{"type":"string","maxLength":80},"category":{"type":"string","maxLength":120},"currency":{"type":"string","maxLength":12},"merchant":{"type":"string","maxLength":200},"accountId":{"type":"string","maxLength":80},"direction":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":500}},"additionalProperties":false},"maxItems":2000}}},"responseSchema":{"type":"json","example":{"items":[{"date":"2026-10-03","matched":true,"accountId":"","merchantId":"MER-1","matchSource":"directory","rawMerchant":"NFLX","merchantName":"Netflix","bankConnected":false,"transactionId":"TX-1","rawDescription":"NFLX 1234","directoryCategory":"subscription","openBankingConnected":false},{"date":"2026-10-04","matched":false,"accountId":"","merchantId":"","matchSource":"transaction_text","rawMerchant":"","merchantName":"LOCAL CAFE LTD","bankConnected":false,"transactionId":"TX-2","rawDescription":"LOCAL CAFE LTD","directoryCategory":"","openBankingConnected":false}],"status":"resolved","findings":[{"code":"merchant_unmatched","kind":"observation","detail":"No supplied merchant directory entry matched. The transaction text was copied as the display name.","subject":"TX-2"}],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Transactions, accounts, merchants, and category corrections are copied only from labeled fields supplied by the caller.","No bank account is connected and no Open Banking credentials are required or used.","Income, affordability, and merchant identity are derived only from supplied rows. Missing values are not invented.","Recurring and subscription detection use date spacing and description/merchant similarity from the supplied set only.","An affordability or credit decision is never produced."],"matchedCount":1,"bankConnected":false,"incomeInvented":false,"credentialsRequired":false,"openBankingConnected":false,"affordabilityDecision":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_K5CZO6N4aGzYS-Us_DKqU","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":"Resolves and enriches raw transaction merchant names against a directory, returning clean merchant identities and categories without requiring bank credentials","exampleAgentPrompt":"I have a list of raw bank transactions with messy merchant names like 'NFLX 1234' and 'SQ *COFFEE' — can you resolve them to clean merchant names and categories using my merchant directory, and flag any that couldn't be matched?","exampleUseCases":[{"title":"Personal finance app transaction cleanup","prompt":"I've got 50 transactions from my bank export with raw descriptions like 'AMZN MKTP US*2F3K9', 'NFLX', and 'WHOLEFDS #1234' — can you match them to real merchant names and categories so I can display them nicely in my budgeting dashboard?"},{"title":"Subscription detection from statement data","prompt":"Here are the last three months of my credit card transactions as a CSV — can you identify which ones are recurring subscriptions by resolving the merchant names and grouping anything that looks like a subscription service?"},{"title":"Expense report merchant categorization","prompt":"I need to categorize these 30 corporate card transactions for our finance team — the raw merchant strings are messy. Can you resolve them to proper merchant names and tag each one with a spending category like 'travel', 'software', or 'meals'?"}],"resultDescription":"A JSON object containing an array of resolved transaction items, each with the original raw description, matched merchant name, merchant ID, match source (directory or transaction text), directory category, match status (true/false), and transaction ID. Also includes aggregate counts (matchedCount), a status field, findings array noting any unmatched or notable transactions, a checkedAt timestamp, and explicit limitation statements clarifying no bank connection, no invented data, and no affordability decisions were made.","failureModes":["Merchant cannot be matched to directory — returns matched:false with merchantName copied from raw text and matchSource set to transaction_text","Input transactions array empty or missing — likely returns empty items array with zero matchedCount","CSV or JSON too large — rejected due to maxLength constraints on input fields","Malformed transaction object missing required fields — may return partial results or findings flagging invalid rows","Payment failure via x402 — endpoint returns 402 Payment Required before processing"],"whenToPreferThis":"Use this endpoint when you have raw bank or card transaction data with cryptic merchant strings and need to resolve them to clean, human-readable merchant names and spending categories — without connecting to a live bank or providing Open Banking credentials. Prefer this over open banking enrichment APIs when you already have the transaction data and just need merchant identity resolution, or when privacy constraints prevent sharing credentials. Best for personal finance apps, expense management tools, compliance workflows, and any scenario where merchant name normalization from a local or supplied directory is sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T06:35:23.826Z","isFirstParty":false,"canonicalSlug":"brainiac-merchant-identity-resolve-4efea368"}