Score invoice payment match API
Match caller-supplied payments to invoice amounts, due dates, and fee rates in basis points. Accuracy gives 60 points to the amount, 20 to paying on time, and 20 to the fee. The discrepancy is the invoice total minus the linked payments. No chain is queried.
The Score invoice payment match operation is part of the Stablecoin Payment Reconciliation API on BRAINIAC.software. Match caller-supplied payments to invoice amounts, due dates, and fee rates in basis points. Accuracy gives 60 points to the amount, 20 to paying on time, and 20 to the fee. The discrepancy is the invoice total minus the linked payments. No chain is queried. It is exposed as POST /api/v1/crypto-payments/invoice-match-score and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied invoices and payment records processed locally Limitations: Only the invoices and payments in the request are compared. Balances and transaction confirmation are not read from a chain. A transaction hash is not confirmation that funds arrived. A payment is applied only when invoiceId matches, or when associateUnlabeledPayments is single_invoice and the request contains one invoice. Amounts are integers in smallest units. No exchange rate is fetched. invoice-match-score uses the amounts, due dates, and fee rates in the request. A payment is not proof that funds arrived. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Reconcile stablecoin payment. Open the group documentation for the full request schema, field notes, and response examples before integrating.
/api/v1/crypto-payments/invoice-match-scoreExample request
curl -i -X POST "https://www.brainiac.software/api/v1/crypto-payments/invoice-match-score" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"invoices": [
{
"id": "INV-100",
"amount": 1000000,
"due_on": "2026-04-01",
"fee_bps": 100
}
],
"payments": [
{
"invoice_id": "INV-100",
"amount": 970000,
"paid_on": "2026-04-03",
"fee": 20000
}
]
}
JSONAn unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.
FAQ
- Do I need an API key? No. Pay the listed USDC amount with x402.
- What network? Base (eip155:8453), USDC.
- Is this an official determination? No. Results are for human review against the cited sources.
Related operations
- Reconcile stablecoin payment — $0.05 USDC