{"uid":"cap_ZEVrUO3lEzJpJMKQsc9zG","slug":"brainiac-stablecoin-payment-reconciliation-api-33952a90","name":"BRAINIAC Stablecoin Payment Reconciliation API","description":"Reconcile caller-supplied stablecoin payment records against invoices. Compares amounts, token, recipient, and chain ID, and reports underpayments, overpayments, duplicate transaction hashes, and payments that are not linked to an invoice. reconciliation_status is matched, underpaid, overpaid, duplicate, mismatched, or incomplete. Amounts are integers in smallest units. No chain is queried, and a transaction hash is not treated as confirmation that funds arrived.","url":"https://www.brainiac.software/api/v1/crypto-payments/stablecoin-payment-reconcile?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rules":{"type":"object","properties":{"tolerance":{"type":"string"},"allowPartial":{"type":"boolean"},"associateUnlabeledPayments":{"enum":["none","single_invoice"],"type":"string"}},"additionalProperties":false},"invoices":{"type":"array","items":{"type":"object","required":["id","amount","decimals","token","chainId","recipient"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"amount":{"type":"string"},"chainId":{"type":"integer","maximum":2147483647,"exclusiveMinimum":0},"decimals":{"type":"integer","maximum":36,"minimum":0},"recipient":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"tolerance":{"type":"string"}},"additionalProperties":false},"maxItems":40,"minItems":1},"payments":{"type":"array","items":{"type":"object","required":["amount","decimals","token","chainId","recipient"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"amount":{"type":"string"},"chainId":{"type":"integer","maximum":2147483647,"exclusiveMinimum":0},"decimals":{"type":"integer","maximum":36,"minimum":0},"invoiceId":{"type":"string","maxLength":80,"minLength":1},"recipient":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$"},"transactionHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"additionalProperties":false},"maxItems":100}}},"responseSchema":{"type":"json","example":{"findings":[{"code":"not_associated","detail":"A payment has no invoice id, so it was not applied.","severity":"medium"},{"code":"underpaid","detail":"Invoice INV-100 received 900000 of 1000000 in its smallest units.","severity":"medium","invoice_id":"INV-100"}],"invoices":[{"invoice_id":"INV-100","expected_amount":"1000000","received_amount":"900000","outstanding_amount":"100000","reconciliation_status":"underpaid"}],"limitations":["Only the invoice and payment records in this request were compared. No balance or transaction was read from a chain.","A transaction hash is not confirmation that funds arrived or that the transfer is final.","Amounts are integers in each record's smallest unit. They are scaled by the supplied decimals with integer arithmetic.","A payment is applied to an invoice only when invoiceId matches, or when associateUnlabeledPayments is single_invoice and the request contains one invoice.","Partial payments are added together unless rules.allowPartial is false.","Timestamps were not checked against a block time."],"expected_amount":"1000000","received_amount":"900000","matched_payments":[{"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","amount":"600000","chain_id":8453,"decimals":6,"recipient":"0x1111111111111111111111111111111111111111","timestamp":"2026-11-05T12:00:00.000Z","invoice_id":"INV-100","payment_id":"p1","applied_amount":"600000","transaction_hash":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},{"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","amount":"300000","chain_id":8453,"decimals":6,"recipient":"0x1111111111111111111111111111111111111111","invoice_id":"INV-100","payment_id":"p2","applied_amount":"300000","transaction_hash":"0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"}],"outstanding_amount":"100000","unmatched_payments":[{"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","amount":"1000000","reason":"not_associated","chain_id":8453,"decimals":6,"recipient":"0x2222222222222222222222222222222222222222","payment_id":"p3","transaction_hash":"0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"}],"reconciliation_status":"underpaid"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SHtHznnRoCAFueZ5O2QG3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reconciles a list of on-chain stablecoin payments against invoices, reporting matched, unmatched, overpaid, underpaid, and outstanding amounts.","exampleAgentPrompt":"Reconcile these invoices against the payments I have: invoice INV-100 expects 1,000,000 USDC units from recipient 0x1111...1111 on Base (chain 8453, 6 decimals), and I received two payments of 600,000 and 300,000 units — allow partial payments and use a tolerance of 1%.","exampleUseCases":[{"title":"Audit partial stablecoin invoice payments","prompt":"I have three USDC invoices on Base and a batch of on-chain payments, some of which are partial. Can you reconcile them and tell me which invoices are still outstanding and by how much?"},{"title":"Identify unlabeled incoming crypto payments","prompt":"I got some USDC transfers with no invoice ID attached. I only have one open invoice right now — can you match those unlabeled payments to it and tell me if it's been fully settled?"},{"title":"Verify full payment before releasing goods","prompt":"Before I ship this order, check whether invoice ORD-2024-77 for 500,000 USDC units on Base chain has been fully paid — here are the transaction hashes and amounts I received so far."}],"resultDescription":"Returns a reconciliation report with per-invoice status (matched, underpaid, overpaid, outstanding), matched and unmatched payment lists with applied amounts, aggregate received and outstanding totals, finding codes with severity levels (e.g. 'underpaid', 'not_associated'), and a limitations section clarifying the off-chain nature of the computation.","failureModes":["Invoice or payment missing required fields (id, amount, decimals, token, chainId, recipient) returns validation error","Mismatched token addresses or chain IDs between invoice and payment cause payments to go unmatched","invoiceId not set on payment and associateUnlabeledPayments is 'none' leaves payments unmatched","More than 40 invoices or 100 payments exceeds array limits and returns schema error","Invalid Ethereum address format (not 0x + 40 hex chars) causes input rejection","Amount precision or decimals mismatch leads to incorrect outstanding calculations"],"whenToPreferThis":"Use this endpoint when you need to reconcile a known set of on-chain stablecoin payments against structured invoices without reading from the chain directly — ideal when you already have payment records (from blockchain indexers, wallets, or logs) and want to compute settlement status, partial payment aggregation, and outstanding balances in a single call. Prefer this over manual arithmetic or general-purpose code execution when dealing with multi-payment, multi-invoice scenarios requiring tolerance rules and partial payment handling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T18:43:34.354Z","isFirstParty":false,"canonicalSlug":"brainiac-stablecoin-payment-reconciliation-api-33952a90"}