# BRAINIAC Merchant Identity Resolve

> BRAINIAC Merchant Identity Resolve 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-14).

Resolves and enriches raw transaction merchant names against a directory, returning clean merchant identities and categories without requiring bank credentials

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/payment-intelligence/merchant-identity-resolve?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-merchant-identity-resolve-4efea368
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g_Bds1_i1lnIXPWg7SGMg

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-merchant-identity-resolve-4efea368 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

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

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.

## Request schema (JSON Schema)

```json
{
 "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": "n
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-merchant-identity-resolve-4efea368/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)
