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 IPFS Splits Files: Fixed vs. Content-Defined Chunking

IPFS defaults to 256 KiB fixed-size chunks, but also ships Rabin and Buzhash content-defined chunkers. Here is why the choice affects deduplication.

5 min readAugust 23, 2026
blog thumbnail

Anatomy of a CID: Decoding an IPFS Identifier

An IPFS CID is not a random string. It encodes a version, a codec, and a hash algorithm plus digest. Here is how to decode a real CID piece by piece.

5 min readAugust 22, 2026
blog thumbnail

How IPFS Shards Large Directories: The HAMT, Not a B-Tree

IPFS does not use a B-tree for large directories. It uses a HAMT, a Hash Array Mapped Trie. Here is exactly how it shards a folder once it outgrows one block.

5 min readAugust 21, 2026
blog thumbnail

How to Resize Images on AIOZ Pin Using URL Parameters

AIOZ Pin image resizing happens straight in the gateway URL, no upload step or separate service. Here is every img- parameter, with real srcset examples.

5 min readAugust 19, 2026
blog thumbnail

How x402 Payments Weight AI Agent Reputation on ERC-8004

x402 payments let ERC-8004 weight a paid AI agent interaction more heavily than free work in its reputation score. Here is exactly how that link works.

5 min readAugust 18, 2026
blog thumbnail

How to Automate NFT Pinning with the AIOZ Pin NFT API

AIOZ Pin NFT API calls pin an asset and its metadata as two tracked pins under one record. Here is how to automate it directly over REST, no SDK needed.

5 min readAugust 17, 2026