HTTP 402 Payment Required — how AI agents handle it automatically [42504]

HTTP 402 Payment Required: How AI Agents Handle It Automatically

The Future of API Monetization

HTTP 402 Payment Required is the forgotten HTTP status code—until now. As AI agents become autonomous economic actors, they need to handle paid APIs automatically, without human intervention.

What Is HTTP 402?

Originally designed for digital cash systems, 402 signals that payment is required before access is granted. AI agents can now:

1. Detect the 402 response from the API
2. Extract payment details from response headers
3. Process payment automatically using on-chain wallets
4. Retry the request with proof of payment

Practical Implementation

The code above demonstrates an AgentExchange that:

• Reads a machine-readable .well-known/agent-beacon.json file to discover available bots and pricing
• Attempts requests without payment first (free tier)
• Catches 402 responses and extracts X-Payment-Amount and X-Payment-Wallet headers
• Automatically pays using USDC on Base network
• Retries with the X-Payment header containing payment proof

Why It Matters

This pattern eliminates friction for AI agents accessing premium services. Instead of failing, agents negotiate payment autonomously—enabling micropayments, metered APIs, and true API marketplaces.

The result? Agents complete tasks end-to-end while developers focus on business logic, not payment plumbing.