Cloudflare Wallets

Cloudflare Wallets provides a system of programmable AI wallets designed to facilitate agentic commerce. These tools allow AI agents to interact with the web as economic actors, enabling them to purchase resources without the friction of traditional login pages or manual payment approvals. By providing a programmable wallet for the agentic Internet, the platform addresses technical barriers that previously prevented autonomous agents from accessing paid APIs, data, and content.

Programmable Virtual Wallets for Agents

The architecture of Cloudflare Wallets is divided into Account Wallets and Virtual Wallets. Account Wallets are managed by human owners of Cloudflare accounts. These serve as the primary repository where users can add funds, delegate spending authority, and remove funds. This structure ensures that a human administrator remains the authority over the financial resources.

Virtual Wallets for agents are the operational units that execute transactions. These are operated via API keys and allow AI agents to spend funds according to specific permissions. By using these virtual wallets, agents can autonomously navigate the web to find and pay for the services they require. This delegation allows for machine-native identity and commerce where the agent acts as a representative of the account owner, performing tasks such as evaluating software providers or purchasing inference cycles.

Micropayments via x402 Protocol

A core component of the system is the integration of x402 micropayments. The x402 protocol for micropayments allows financial transactions to be attached directly to HTTP requests. This mechanism is designed for headless interactions, meaning an AI agent can pay for a service at the same time it makes a request for data or an API call.

This protocol supports a variety of use cases, including paying for AI inference, accessing premium content, or retrieving specific datasets. Because the payments are handled at the protocol level, agents do not need to navigate traditional sign-up forms. This machine-native approach to commerce allows for a fluid exchange of value between autonomous buyers and merchants using the Monetization Gateway or other x402-compatible endpoints.

Spending Guardrails and Allowances

To manage the risks associated with autonomous spending, the platform includes spending guardrails like allowances. Human administrators can define specific policies for each Virtual Wallet to control how much an agent can spend without further intervention. These controls include:

• Allowances: Setting a recurring budget.
• Maximum Transaction Size: Capping the amount an agent can spend on a single request.
• Allow Lists: Restricting the agent to transacting only with approved merchants or services.

In addition to financial controls, the system provides cloudflare. pay identity handles. These handles offer a human-readable identifier for agents. This links the agent to a stable Cloudflare account, allowing merchants to recognize the organization behind the agent. While declaring an identity is optional, it provides a way for agents to maintain a persistent presence and for merchants to apply specific policies to known entities.

Frequently Asked Questions

What is the difference between an Account Wallet and a Virtual Wallet?

Account Wallets are managed by humans to control overall funds and delegate spending, while Virtual Wallets are used by AI agents to perform autonomous transactions via API keys within specific limits set by the account owner.

How can I limit how much an AI agent spends?

You can set guardrails for Virtual Wallets, including a maximum transaction size, an allowance (such as a weekly budget), and an allow list of approved services. If an agent exceeds these limits, a human administrator can manually override the restriction.

How do Cloudflare Wallets process payments for APIs?

Cloudflare Wallets use the x402 protocol to attach micropayments directly to HTTP requests. This allows agents to pay for services like AI inference or content headlessly without needing to navigate traditional human-centric login or payment pages.

How are AI agents identified when using Cloudflare Wallets?

Agents can use cloudflare. pay to claim human-readable identifiers linked to their Cloudflare account. This provides a stable identity (e. g., research. example. cloudflare. pay) that allows merchants to recognize the agent's originating organization.

What does Cloudflare Wallets do?

Account Wallets: Wallets designed for human owners of Cloudflare accounts to add funds, delegate spending to virtual wallets, and manage fund removal. Virtual Wallets: API key-operated wallets designed for AI agents to spend funds according to permissions and spending caps set by the Account Wallet owner. x402 Protocol Support: Integration with the x402 protocol to enable micropayments attached directly to HTTP requests for AI inference, data, and content. Spending Guardrails: Configurable policies for Virtual Wallets including allowances, allow lists, and maximum transaction sizes to manage agent spending risk. cloudflare. pay Identity: A system linking wallets to Cloudflare accounts to provide agents with stable, human-readable identifiers for persistent identity during transactions.