{"uid":"cap_-cSesRlWU8YdDNwX-DCDe","slug":"agent-budget-guard-record-payment-c685fb39","name":"Agent Budget Guard – Record Payment","description":"Pay-per-request governance APIs for AI agents using x402. Check budgets, log payments, classify invoices, and generate audit-ready spending records. Built for autonomous agents, USDC/Base payments, and JPY/JPYC reporting workflows.","url":"https://agent-budget-guard.onrender.com/api/record-payment","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount"},"network":{"type":"string","description":"Blockchain network"},"purpose":{"type":"string","description":"Payment purpose"},"tx_hash":{"type":"string","description":"Transaction hash"},"agent_id":{"type":"string","description":"AI agent identifier"},"currency":{"type":"string","description":"Currency used"},"tax_included_amount_jpy":{"type":"string","description":"Tax-included amount in JPY"}}},"responseSchema":{},"example":{"request":{"amount":"10.50","network":"base","purpose":"api-request-processing","tx_hash":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","agent_id":"agent-qa-test-001","currency":"USDC","tax_included_amount_jpy":"1155.00"},"response":{"reason":"small-amount exception candidate","audit_id":"audit_1781240488","recorded":true,"invoice_required":false,"bookkeeping_required":true,"monthly_summary_required":true}},"exampleRequest":{"amount":"10.50","network":"base","purpose":"api-request-processing","tx_hash":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","agent_id":"agent-qa-test-001","currency":"USDC","tax_included_amount_jpy":"1155.00"},"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qhWoRYcMKS7Kr_UnY0Fha","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Records a blockchain payment transaction for an AI agent, classifying it for audit, bookkeeping, and JPY tax reporting purposes.","exampleAgentPrompt":"Record a payment of 10.50 USDC on the Base network for agent-qa-test-001 — the transaction hash is 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef, the purpose was api-request-processing, and the tax-included JPY amount is 1155.00.","exampleUseCases":null,"resultDescription":"Returns a JSON object with an audit_id, a recorded boolean, a reason string classifying the payment (e.g. 'small-amount exception candidate'), and boolean flags indicating whether an invoice, bookkeeping entry, or monthly summary is required for this transaction.","failureModes":["Missing required fields (amount, tx_hash, agent_id) return validation errors","Invalid or malformed transaction hash may cause recording failure","Network value not matching supported chains may be rejected","Duplicate tx_hash submissions may create redundant audit records","Service unavailability on Render.com free tier may cause timeouts"],"whenToPreferThis":"Use this endpoint when an AI agent has completed a USDC payment on Base and needs to log the transaction for governance, compliance, or JPY tax reporting. Ideal for autonomous agent workflows that require per-payment audit trails, bookkeeping classification, and monthly expense summaries rather than just checking balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:38:32.656Z","isFirstParty":false}