sourcesverificationdocs

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

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.

Coinbase Developer Documentation

Migration Guide (v1 -> v2)

Authoritative migration matrix for headers, network format, versions, packages, and facilitators.

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

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.