# Agent Budget Guard – Record Payment

> Agent Budget Guard – Record Payment is a paid API for AI agents from agent-budget-guard.onrender.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Records a blockchain payment transaction for an AI agent, classifying it for audit, bookkeeping, and JPY tax reporting purposes.

## Facts

- Endpoint: POST https://agent-budget-guard.onrender.com/api/record-payment
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-budget-guard-record-payment-c685fb39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-cSesRlWU8YdDNwX-DCDe

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 agent-budget-guard-record-payment-c685fb39 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

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

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-budget-guard-record-payment-c685fb39/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-budget-guard.onrender.com](https://www.zero.xyz/host/agent-budget-guard.onrender.com/llms.txt)
