Back

Blog details

How x402 Payments Weight AI Agent Reputation on ERC-8004

AIOZ Network
5 min readAugust 18, 2026
aioz-pinai-agents-2explainer
Holographic hexagon tiles representing AIOZ Pin's IPFS storage network

x402 payments give ERC-8004's Reputation Registry something it didn't have on its own: a way to tell the difference between feedback from someone who actually paid for an agent's work and feedback from someone who didn't. A $10,000 engagement and a free test run can both end in a 5-star rating, but they shouldn't necessarily count the same. This covers what x402 actually does and exactly how it plugs into the reputation-weighting mechanism already covered on this blog.

TL;DR:
  • x402 is an open payment protocol from Coinbase that turns the old, unused HTTP 402 status code into instant stablecoin payments over plain HTTP, no accounts, no cards
  • A server responds 402 Payment Required with a PAYMENT-REQUIRED header, the client retries with a PAYMENT-SIGNATURE header proving payment, and a facilitator verifies and settles it
  • ERC-8004's Reputation Registry can weight feedback by proof of x402 payment, so a paid engagement counts differently than free or trivial work
  • That payment proof is exactly the kind of evidence that belongs referenced through IPFS, the same pattern already covered for reputation data generally

What x402 Actually Does

HTTP has had a 402 Payment Required status code since the earliest web standards, reserved but never actually implemented. x402 is what finally uses it: Coinbase describes it as "a new open payment protocol... that enables instant, automatic stablecoin payments directly over HTTP." When a client requests something that costs money, the server responds with 402 instead of the content, the client pays, and retries. As of March 2026, the protocol has processed over 119 million transactions on Base and 35 million on Solana, with Google, Visa, AWS, Circle, Anthropic, and Vercel among the x402 Foundation's core members alongside Coinbase and Cloudflare.

The Actual Payment Flow

  1. A client (often an AI agent, not a human clicking through a checkout page) requests a paid resource
  2. The server responds 402 Payment Required with a PAYMENT-REQUIRED header containing payment instructions
  3. The client signs a stablecoin payment and retries the request with a PAYMENT-SIGNATURE header containing the payment proof
  4. A facilitator verifies and settles the payment on-chain, "so sellers do not need to maintain blockchain infrastructure" themselves, and the server returns the resource

Settlement runs in USDC or EURC (via EIP-3009) or any ERC-20 token (via Permit2), across Base, Polygon, Arbitrum, World, and Solana. The whole cycle is designed to complete in seconds, without a login step or a stored payment method.

Why This Matters Specifically for Agents, Not Just Payments

x402 could, in principle, work for a human clicking through a paywall, but that's not the gap it actually closes. A human already has a dozen ways to pay for something online: a saved card, a wallet app, a subscription already in place. An autonomous AI agent calling another agent's API mid-task has none of that, no browser session to redirect through a checkout page, no human present to approve a card charge. x402's whole design, a payment completed inside the same HTTP request-response cycle that failed with 402 in the first place, is built for exactly that machine-to-machine case: an agent can pay for a resource and retry programmatically, in the same execution, without pausing to hand control back to a person. That's also precisely why a payment happening at all becomes meaningful reputation evidence, covered next, a completed x402 payment is closer to proof that a real transaction occurred than a human-submitted rating ever is, since it required an actual on-chain settlement rather than just clicking a star rating.

Where This Connects to ERC-8004

The Reputation Registry stores a 0-100 score per interaction, and the specification supports weighting that score by proof of payment through x402 integration. Concretely, this means an agent that gets paid $10,000 for a piece of work and receives a rating can have that rating carry more weight in aggregate reputation than a free or trivial interaction that received the same numeric score. Without a payment layer, a reputation system has no way to distinguish "someone paid real money and was satisfied" from "someone tried it for free and left a rating," which matters a lot if reputation is meant to signal something about an agent worth paying for.

Why This Enables Pricing Traditional Rails Can't

One detail worth understanding about why x402 gets reached for specifically in agent-to-agent contexts: the payment settles as a direct stablecoin transfer through a facilitator, not a card network charging a per-transaction processing fee that typically runs to tens of cents regardless of the purchase amount. That fee structure makes sub-cent pricing, an API charging $0.001 per call, impractical over traditional rails, the processing fee alone would dwarf the actual price. A settlement model built around direct on-chain transfer doesn't have that same fixed floor, which is a real part of why an autonomous agent economy built around frequent, small, machine-initiated payments needs something shaped like x402 rather than routing every micro-transaction through infrastructure built for human-scale purchases.

Where the Payment Proof Should Actually Live

An x402 payment produces real evidence, the signed payment payload, the settlement transaction. That's exactly the category of reputation evidence that belongs referenced through IPFS rather than a private database: the on-chain reputation score can carry a feedbackHash pointing at the payment evidence, and if that evidence is pinned to IPFS and referenced by CID, anyone can verify the hash matches without trusting whoever's hosting it. Pinning that evidence follows the same workflow already covered for ERC-8004 registration files, the payment record is just another JSON document to pin and reference.

Frequently Asked Questions

What is x402? An open payment protocol from Coinbase that implements the long-unused HTTP 402 Payment Required status code for instant stablecoin payments over HTTP, without accounts or credit cards.

How does the x402 payment flow work? A server responds 402 with a PAYMENT-REQUIRED header, the client retries with a PAYMENT-SIGNATURE header proving payment, and a facilitator verifies and settles the transaction on-chain before the server returns the resource.

How does x402 connect to ERC-8004? ERC-8004's Reputation Registry can weight feedback by proof of x402 payment, so a paid interaction can count differently in aggregate reputation than free or trivial work.

What tokens and chains does x402 support? USDC and EURC via EIP-3009, or any ERC-20 token via Permit2, across Base, Polygon, Arbitrum, World, and Solana.

Where should x402 payment proof be stored for reputation purposes? Pinned to IPFS and referenced by CID through the Reputation Registry's feedbackHash field, the same verifiable-evidence pattern already used for other reputation data.

References

We only send updates when meaningful changes ship, and you can unsubscribe anytime

Related Content

blog thumbnail

How AIOZ Pin's Wallet Billing Actually Works

AIOZ Pin has no credit card option. You fund an account with AIOZ tokens instead. Here is exactly how the wallet, deposits, and conversion actually work.

5 min readSeptember 13, 2026
blog thumbnail

Content Moderation on IPFS: What Actually Happens

Pinning services can remove their own copy of a file. They cannot remove it from IPFS. Here is exactly what a takedown does and does not accomplish.

5 min readSeptember 12, 2026
blog thumbnail

IPFS Transports: TCP vs. QUIC Explained

libp2p connections can run over more than one transport. Here is exactly what changes with QUIC instead of TCP, and why IPFS dials both at once.

5 min readSeptember 11, 2026
blog thumbnail

GossipSub: How IPFS's PubSub Layer Actually Works

The DHT answers who has a CID. GossipSub answers a different question: how do peers push real-time updates to everyone listening, without a lookup at all.

5 min readSeptember 10, 2026
blog thumbnail

Helia: IPFS's Modern JavaScript Implementation

js-ipfs is deprecated. Helia is what replaced it: a modular, TypeScript-first IPFS implementation built for the browser and Node.js. Here is how it fits.

5 min readSeptember 09, 2026
blog thumbnail

IPLD Selectors: Fetching Part of a DAG, Not All of It

Not every retrieval needs the whole DAG. IPLD Selectors describe exactly which nodes to traverse and match, so a client can fetch a slice, not everything.

5 min readSeptember 08, 2026