WikiForDomainsThe Free Domain Encyclopedia

x402

Article Talk

x402 is an open payment protocol that uses the HTTP status code 402 Payment Required so a client—human software or an AI agent—can pay for a web resource inside the same request flow, typically with a stablecoin such as USDC. Coinbase published the protocol in May 2025; as of April 2026 the Linux Foundation hosts the x402 Foundation as a vendor-neutral home for the standard.[1][2]

Related: AI agent economy, Buy a domain with USDC, Buy domain with crypto, AI agent domain registration.

Six-step diagram of the x402 flow: client request, HTTP 402 with payment requirements, wallet signature, retry with payment signature, facilitator verify and settle, 200 OK with resource
Figure 1. Typical x402 HTTP payment handshake. Diagram: WikiForDomains (CC0).

HTTP 402 before x402

HTTP 402 Payment Required has existed since early HTTP/1.1 drafts and remains listed in current HTTP Semantics (RFC 9110) as reserved for future use. MDN describes it as a nonstandard reserved code originally intended for digital cash or micropayment systems, with no single browser-supported convention.[3] Until the mid-2020s it saw only ad-hoc use. x402 proposes a concrete, machine-readable payment handshake on top of that status code.

History

How it works

Coinbase Developer Platform (CDP) documentation describes a request–quote–pay–settle loop:[5]

  1. The client requests a paid resource.
  2. The server answers with HTTP 402 and payment requirements (price, payee, accepted networks/assets/schemes), commonly carried in a PAYMENT-REQUIRED header.
  3. The client constructs a signed payment payload with its wallet (often an EIP-3009 transferWithAuthorization for USDC so the facilitator can submit gaslessly).
  4. The client retries the same request with a PAYMENT-SIGNATURE header.
  5. The server verifies the payload locally or via a facilitator /verify endpoint, fulfills the work if valid, then settles via the facilitator /settle (or on-chain itself).
  6. The server returns HTTP 200 with the resource and a PAYMENT-RESPONSE confirming settlement.

Coinbase’s May 2025 launch post named the client payment header X-PAYMENT and the confirmation X-PAYMENT-RESPONSE. Later CDP and open-spec documentation use the unprefixed PAYMENT-* names above; implementations should follow the live spec and the seller’s 402 response.[1][5][6]

Facilitators, networks and SDKs

A facilitator is an optional service that verifies signatures and broadcasts settlement without taking custody of the buyer’s funds. Cloudflare’s Agents docs point examples at the public facilitator at https://x402.org/facilitator (operated by Coinbase) and note that multiple facilitators exist across networks.[7] CDP documents a Coinbase-hosted facilitator with support spanning several chains (documentation as of late 2026 includes Base and Solana among production paths) and states that CDP has processed more than 100 million x402 payments across Base and Solana.[8]

The protocol is designed to be network- and asset-flexible; USDC on Base is the most commonly cited starter path. Official and community SDKs include TypeScript, Go and Python clients/servers listed in Coinbase/x402 Foundation documentation.[8][6]

Adoption (verified examples)

Relevance to domains

Agents that register or renew DNS names need a way to pay without a human completing a card form. x402 lets a registrar return HTTP 402 with an exact USDC quote; a wallet-equipped agent pays and retries. That pattern appears in Porkbun’s API guide and StableDomains’ x402 documentation as of November 2026.[9][10] It complements, rather than replaces, account credit, Stripe checkout, or plain on-chain transfers. See also AI agent domain registration.

Limitations and criticisms

See also

References

  1. "Introducing x402: a new standard for internet-native payments". Coinbase. 6 May 2025. Retrieved 9 November 2026.
  2. "Linux Foundation is Launching the x402 Foundation and Welcoming the Contribution of the x402 Protocol". The Linux Foundation. 2 April 2026. Retrieved 9 November 2026.
  3. "402 Payment Required". MDN Web Docs. Retrieved 9 November 2026.
  4. "Launching the x402 Foundation with Coinbase, and support for x402 transactions". The Cloudflare Blog. 23 September 2025. Retrieved 9 November 2026.
  5. "How x402 works". Coinbase Developer Platform. Retrieved 9 November 2026.
  6. "coinbase/x402" (development fork; points to x402 Foundation repo). GitHub. Retrieved 9 November 2026.
  7. "x402". Cloudflare Agents docs. Retrieved 9 November 2026.
  8. "Overview" (x402). Coinbase Developer Platform. Retrieved 9 November 2026.
  9. "Pay with USDC (x402): buy directly, or add credit". Porkbun. Retrieved 9 November 2026.
  10. "x402 on StableDomains". StableDomains. Retrieved 9 November 2026.