Updated 2026-07-06
Primary Source Map
This site is intentionally citation-heavy. x402 is moving quickly, so source selection matters: protocol docs and specs first, provider docs second, commentary last.
How to read these sources
Start with the x402 Foundation docs for current protocol behavior, then read the GitHub specs for scheme-level validation requirements. Use Coinbase docs for CDP facilitator details and migration notes. Use IETF and MDN for the underlying HTTP status-code context.
Provider docs such as Stripe, Cloudflare, Solana, and chain-specific guides are useful evidence of adoption and implementation patterns, but they may describe provider-specific facilitators, products, or network support. Do not generalize those details to every x402 integration without checking the protocol docs.
Source categories
For implementation, the most important pages are HTTP 402, Client / Server, Facilitator, Networks & Token Support, and the seller and buyer quickstarts. For migration, use the Coinbase v1-to-v2 matrix. For risk review, read exact, upto, batch settlement, payment identifier, and signed offers/receipts.
For market context, Coinbase and Cloudflare explain why the protocol exists and where it might go. Those pages are useful for framing, but production engineers should still build from the specs and current SDK docs.
Verification policy
Every page on x402docs.com links back to primary sources near the claims they support. When a source changes, the safest update path is to edit the central source registry first, then review every page that cites it.
This site avoids pretending that a provider-specific endpoint, feature, or launch claim is protocol-wide. If a page names a provider, it should say whose docs support that statement.
- Protocol claim: cite x402 Foundation docs or specs.
- HTTP status claim: cite RFC 9110 or MDN.
- Provider feature: cite that provider documentation.
- Ecosystem adoption: cite official provider or chain pages, not anonymous summaries.
Full Source Registry
IETF / RFC Editor
RFC 9110: HTTP Semantics, Section 15.5.3
Defines HTTP 402 as reserved for future use.
MDN Web Docs
402 Payment Required
Explains current browser and status-code compatibility caveats.
x402 Foundation Docs
Welcome to x402
Introduces the request, payment, verification, settlement, and resource flow.
x402 Foundation Docs
HTTP 402
Documents the v2 payment headers and HTTP-native framing.
x402 Foundation Docs
Client / Server
Defines buyer/client and resource-server responsibilities.
x402 Foundation Docs
Facilitator
Covers facilitator responsibilities, verify/settle flow, and Solana duplicate-settlement protection.
x402 Foundation Docs
Networks & Token Support
Lists CAIP-2 identifiers and default assets used by dollar-string pricing.
x402 Foundation Docs
Quickstart for Sellers
Shows seller middleware setup across Express, Next.js, Hono, Fastify, Go, FastAPI, and Flask.
x402 Foundation Docs
Quickstart for Buyers
Shows client packages, signer setup, and retry-with-payment flow.
x402 Foundation Docs
FAQ
Documents agent behavior, wallet requirements, and common 402 retry failures.
x402 Foundation Docs
Payment Schemes
Defines exact, upto, and batch-settlement payment semantics at a high level.
GitHub
x402 Foundation Repository
Reference SDKs, examples, principles, specs, and package map.
Coinbase Developer Documentation
Migration Guide (v1 -> v2)
Authoritative migration matrix for headers, network format, versions, packages, and facilitators.
Coinbase Developer Platform
Introducing x402: a new standard for internet-native payments
Launch context, use cases, and stablecoin-payment framing from Coinbase.
x402.org
x402: The Payment Protocol for Agentic Commerce
Whitepaper describing API access, stablecoin payments, and agentic-commerce motivation.
Cloudflare Blog
Launching the x402 Foundation with Coinbase, and support for x402 transactions
Cloudflare perspective on standardizing machine-readable 402 responses and deferred settlement.
x402.org
Introducing x402 V2
Explains CAIP alignment, modern headers, extension architecture, and multi-facilitator support.
x402 Foundation Specs
Scheme: exact
Specifies exact-amount payment semantics and critical validation requirements.
x402 Foundation Specs
Scheme: upto
Specifies maximum-authorized payment semantics for variable usage costs.
x402 Foundation Docs
Batch Settlement
Documents batched voucher-style payment flows for high-throughput usage.
x402 Foundation Docs
Payment-Identifier (Idempotency)
Defines an extension for retry-safe payment identifiers and response caching.
x402 Foundation Docs
Signed Offers & Receipts
Documents signed offers on 402 responses and signed receipts in settlement responses.
Stripe Documentation
x402 quickstart
Shows a payment endpoint builder and facilitator-based x402 endpoint testing.
Solana Foundation
What is x402?
Solana ecosystem overview with agent-payment use cases and Solana performance claims.
FAQ
Why not cite more blog posts?
Because the niche needs fewer recycled explainers and more verifiable implementation guidance. Commentary is useful only after primary docs are exhausted.
How often should this site be refreshed?
For x402, monthly is reasonable while the ecosystem is moving quickly. Refresh sooner before relying on facilitator coverage, package names, or network support.