AINativeainative.axAX AUDIT
← All guides
AR-COMM · AGENT COMMERCE

x402 Agent Payment Discovery

HTTP 402 Payment Required has sat unused in the spec since 1997. x402 revives it as the handshake an AI agent uses to pay for API access without a human typing in a credit card number.

What is x402?

x402 is an open protocol built around the HTTP 402 Payment Requiredstatus code — defined in the original HTTP spec, reserved for future use, and essentially never implemented by anyone until agentic payment made it useful. The idea: instead of a human filling out a checkout form, a server tells a requesting client exactly what payment it needs, in a machine-readable format, directly in the HTTP response.

An AI agent calling a paid API hits this flow directly: request the resource, receive a 402 with payment instructions, settle payment (often via a stablecoin or an agent-held payment credential), and retry the same request with proof of payment attached. No redirect to a hosted checkout page, no human in the loop.

The Two Ways Agents Discover x402 Support

The AX Audit checks for x402 support two different ways, because a site can expose either or both:

Static discovery — /.well-known/x402

A well-known document declaring supported payment methods, pricing, and accepted currencies ahead of time, so an agent can evaluate cost before ever making a request.

Live 402 challenge

An agent sends a real, unauthenticated GET to a paid endpoint. A conformant server responds with HTTP 402 and a payment-required body describing how to pay right there in the response — no prior discovery document needed.

Either is enough to start the flow, but the live challenge is the one that actually proves the integration works end-to-end — a static document can describe intentions that were never wired up to a real paywall.

A Minimal 402 Response

A conformant 402 response carries enough structure for an agent to act on it without human interpretation:

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "x402Version": 1,
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "100000",
      "asset": "USDC",
      "payTo": "0x...",
      "resource": "/api/v1/premium-endpoint",
      "description": "One premium API call"
    }
  ]
}

The agent reads accepts, picks a scheme and network it supports, constructs and submits the payment, then retries the original request with an X-PAYMENT header (or equivalent) carrying proof of settlement.

Where This Fits in AR-* and the AX Score

x402 lives under AR-COMM, the AgentReady category covering agent-initiated commerce — the step where an agent, already authenticated and provisioned, actually pays for something. It sits alongside other emerging agent-payment schemes (ACP, UCP, MPP) as one of several mechanisms AR-COMM recognizes.

In the live AX Audit, x402 Agent Payment Discovery is its own named check worth up to 6 of the 100 points, split across the static-discovery and live-challenge signals above. Running this exact check against ainative.ax’s own API today returns a 0 of 6 — no /.well-known/x402is published, and no live 402 challenge fires on an unauthenticated request. The AX Audit’s own API is free, so this hasn’t been a priority, but it’s a real, disclosed gap rather than a claimed capability.

Frequently Asked Questions

Does this require cryptocurrency?▼
Most live x402 implementations today settle in stablecoins (commonly USDC) on a low-fee chain, because that’s what makes sub-cent, per-request micropayments economically viable. The protocol itself is payment-method agnostic — the "scheme" and "network" fields in the 402 body are how a server declares what it actually accepts.
Is x402 the same as a paywall redirect?▼
No. A traditional paywall redirects a human browser to a hosted checkout page. x402 keeps the entire exchange inside the original HTTP request/response cycle, with no redirect and no human-oriented UI — that’s what makes it usable by an agent with no browser at all.
What if my API is free — should I still implement x402?▼
Only if you plan to monetize agent traffic specifically, or want to signal pricing intent to agents evaluating your API before they call it. A free API gets no points for this check and loses nothing — it’s one of several checks weighted toward sites that actually sell agent-facing access.

Check Your x402 Discovery Score

The AX Audit checks for a /.well-known/x402 document and attempts a live, unauthenticated request to see if your API issues a real 402 challenge.

Check your x402 score→

Free audit. No signup required.