Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Agent payments

Make agents discoverable, callable, payable, and auditable
View as Markdown

Agent payments let autonomous software pay for tools, APIs, content, and work without a human checkout step. Radius provides the settlement layer for those transactions: fast finality, stablecoin-native fees, and EVM-compatible wallets.

The goal is not only to move tokens. A useful agent payment flow lets another agent discover what is available, verify who provides it, understand the price, submit payment, receive the result, and keep a receipt.

Why agent payments need more than settlement

Agents act through web infrastructure. They read metadata, call APIs, retry requests, hold budget, route through proxies, and delegate work. That makes the edge part of the control plane for commerce.

For paid agent traffic, the edge decides whether to block, allow, challenge, route, cache, settle, redact, and observe a request. Radius makes the resulting payment final and auditable.

Agent-readable web surfaces

The agentic web is pushing sites to publish more machine-readable content. Useful surfaces include:

  • sitemap.xml for canonical crawl paths
  • robots.txt for crawler and agent policy
  • .well-known/* URIs for payment, identity, agent cards, OAuth metadata, and MCP metadata
  • llms.txt and generated markdown for low-noise model context
  • API catalogs, OpenAPI, OpenRPC, and JSON schemas
  • agent skill manifests and A2A agent cards

Use isitagentready.com to test whether a site is ready for agents to discover, understand, and operate against it.

Payment flow

A Radius-backed agent payment flow usually has five parts:

  1. Discovery — Agent A finds Agent B's web endpoint, agent card, skills, wallet, and payment requirements.
  2. Identity — Agent A verifies Agent B's DID, wallet binding, A2A endpoint, or registration metadata.
  3. Quote — Agent B returns a machine-readable price for a skill, task, API call, or content resource.
  4. Settlement — Agent A pays with Radius, either directly, through x402, or through a contract primitive.
  5. Receipt — Agent B returns the result with a receipt that binds task, agent identity, wallet, amount, tx hash, and timestamp.

The receipt is the bridge between the web request and on-chain settlement. It gives agents and operators an audit trail they can reason about after the work completes.

Protocols to understand

Agent payments are not one protocol. Radius can settle value beneath multiple agent-commerce patterns:

ProtocolHow it applies
x402HTTP-native payments for APIs, content, tools, and other resources. A server returns 402 Payment Required, the agent pays, and the request retries with proof of payment.
MPPMachine-to-machine payments for API requests, tool calls, and content in the same HTTP call. It is useful for paid tools and agent services that need request-level billing.
UCPUniversal Commerce Protocol for agentic commerce flows such as discovery, checkout, identity linking, order management, and post-purchase experiences. It applies when agents buy products or services from businesses.
ACPAgentic Commerce Protocol for programmatic checkout between buyers, AI agents, and businesses. It applies when a business wants existing commerce infrastructure to be callable by compatible agents.

Workshop repos to study

RepoWhat it demonstrates
radius-hermes-railway-templateRadius-ready Hermes agent with wallet state, discovery endpoints, A2A communication, ERC-8004 tools, and published skills.
radius-agent-templateMinimal NEST payment agent that can hold a wallet, check balances, request faucet funds, and send SBC.
radius-agent-contractsAgent escrow, bounty board, pay-per-query, and payment-splitting contracts for paid work.
radius-keychainDelegated sub-keys with spending limits and call scopes for controlled agent wallets.
radius-openclaw-railway-templateOpenClaw deployment template with Radius skills and wallet tooling.
radius-cloudflare-agentsCloudflare Agents fork for durable edge-agent patterns.
rad-router-proxyLocal AI IDE proxy that pays a model router with x402 on Radius.

See the Workshop playground for the full public repo catalog.

Choosing a payment pattern

PatternUse when
Direct wallet transferOne agent already knows the payee and amount.
x402An agent pays for an HTTP resource, API response, or content item.
EscrowA buyer agent needs work completed before funds release.
BountyAn orchestrator wants multiple agents to discover and claim paid tasks.
Payment channelThe service bills continuously or in frequent increments.
Delegated keyAn operator wants an agent wallet with scoped permissions and spending limits.

Use x402 integration for HTTP-native paid APIs and content. Use radius-cli when an agent or terminal workflow needs a local wallet surface.

Next steps