Welcome to x402
Overview
x402 is a new open payment protocol developed by Coinbase that enables instant, automatic stablecoin payments directly over HTTP.
By reviving the HTTP 402 Payment Required status code, x402 lets services monetize APIs and digital content onchain, allowing clients, both human and machine, to programmatically pay for access without accounts, sessions, or complex authentication.
Who is x402 for?
- Sellers: Service providers who want to monetize their APIs or content. x402 enables direct, programmatic payments from clients with minimal setup.
- Buyers: Human developers and AI agents seeking to access paid services without accounts or manual payment flows.
Both sellers and buyers interact directly through HTTP requests, with payment handled transparently through the protocol.
Use cases
x402 enables a range of use cases, including:
- API services paid per request
- AI agents that autonomously pay for API access
- Paywalls for digital content
- Microservices and tooling monetized via microtransactions
- Proxy services that aggregate and resell API capabilities
How it works
- The buyer requests a resource from the server (see Client/Server documentation)
- If payment is required, the server responds with a 402 Payment Required, including payment instructions.
- The buyer constructs and sends a payment payload.
- The server verifies and settles the payment via the x402 facilitator’s
/verify
and/settle
endpoints. If the payment is valid, the server returns the requested resource.
Beyond legacy limitations
x402 is designed for a modern internet economy, solving key limitations of legacy systems:
- Reduce fees and friction: Direct onchain payments without intermediaries, high fees, or manual setup.
- Micropayments & usage-based billing: Charge per call or feature with simple, programmable pay-as-you-go flows.
- Machine-to-machine transactions: Let AI agents pay and access services autonomously with no keys or human input needed.
Offload your infra
The x402 Facilitator handles payment verification and settlement so that sellers don’t need to maintain their own blockchain infrastructure.
The Coinbase Developer Platform (CDP) offers a Coinbase-hosted facilitator service that processes fee-free USDC payments on the Base network, offering a streamlined and predictable experience for both buyers and sellers.
Facilitators handle verification and settlement, so sellers do not need to maintain blockchain infrastructure.
CDP’s x402 facilitator provides:
- Fee-free USDC payments on the Base network
- Fast, onchain settlement of transactions
- Simplified setup for sellers to start accepting payments
Facilitator roadmap
CDP’s x402 facilitator is designed as a facilitator on top of an open standard, which is not tied to any single provider. Over time, the facilitator will include:
- A discovery layer for buyers (human and agents) to find available services
- Support for additional payment flows (e.g., pay for work done, credit based billing, etc.)
- Optional attestations for sellers to enforce KYC or geographic restrictions
- Support for additional assets and networks
The goal is to make programmatic commerce accessible, permissionless, and developer-friendly.
What to read next
- Quickstart for Sellers: Get started with x402 by accepting payments from clients.
- Quickstart for Buyers: Get started with x402 by paying for services.
- Explore Core Concepts: Learn about the core concepts of the x402 protocol.
- Join our community on Discord: Get help and stay up to date with the latest developments.