FAQ
Last updated
Last updated
x402 is an open‑source protocol that turns the dormant HTTP 402 Payment Required status code into a fully‑featured, on‑chain payment layer for APIs, websites, and autonomous agents.
Traditional rails require credit‑card networks, user accounts, and multi‑step UI flows. x402 removes those dependencies, enabling programmatic, HTTP-native payments (perfect for AI agents) while dropping fees to near‑zero and settling in ~1 second.
No. Any web API or content provider—crypto or web2—can integrate x402 if it wants a lower‑cost, friction‑free payment path for small or usage‑based transactions.
TypeScript and Python are the reference implementations, but x402 is an open protocol.
Nothing prevents you from implementing the spec in Go, Rust, etc. If you're interested in building support for your favorite language, please and let us know, we'd be happy to help!
Coinbase Developer Platform operates the first production facilitator. The protocol, however, is permissionless—anyone can run a facilitator. Expect:
Community‑run facilitators for other networks or assets.
Private facilitators for enterprises that need custom KYT / KYC flows.
Every x402PaymentPayload is signed by the buyer and settles directly on‑chain.
A facilitator that tampers with the transaction will fail signature checks.
There is no single answer, but common patterns are:
Flat per‑call (e.g., $0.001 per request)
Tiered (/basic vs /pro endpoints with different prices)
Up‑to (work in progress): "pay‑up‑to" where the final cost equals usage (tokens, MB, etc.)
Yes. x402 handles the payment execution. You can still meter usage, aggregate calls, or issue prepaid credits in Metronome and only charge when limits are exceeded. Example glue code is coming soon.
Base
USDC
fee-free
Mainnet
Base Sepolia
USDC
fee-free
Testnet
Gas paid on chain; Coinbase's x402 facilitator adds zero facilitator fee.
Support for additional chains and assets is on the roadmap and community‑driven.
Not natively. However, facilitators or third‑party gateways can wrap x402 flows with on‑ and off‑ramps.
No. The recommended pattern is:
Buyers (clients/agents) sign locally in their runtime (browser, serverless, agent VM). You can use CDP Wallet API to create a programmatic wallet.
Sellers never hold the buyer's key; they only verify signatures.
The current exact scheme is a push payment—irreversible once executed. Two options:
Business‑logic refunds: Seller sends a new USDC transfer back to the buyer.
Escrow schemes: Future spec could add conditional transfers (e.g., HTLCs or hold invoices).
Agents follow the same flow as humans:
Make a request.
Parse the 402 JSON (accepts array).
Choose a suitable requirement and sign a payload via the x402 client SDKs.
Retry with X‑PAYMENT.
Yes. Programmatic wallets (e.g., CDP Wallet API, viem, ethers‑v6 HD wallets) let agents sign EIP‑712 payloads without exposing seed phrases.
Tracked in public GitHub issues + community RFCs. Major themes:
Multi‑asset support
Additional schemes (upto, stream, permit2)
Discovery layer for service search & reputation
Why is x402 hosted in the Coinbase GitHub?
We acknowledge that the repo is primarily under Coinbase ownership today. This is primarily to leverage our best-in-house security and auditing team to ensure the spec is safe and nobody accidentally creates legally ambiguous payment flows. We intend to eventually transfer ownership of the repo to a steering group or open-source committee.
402 Payment Required, even after attaching X‑PAYMENT. Why?Signature is invalid (wrong chain ID or payload fields).
Payment amount < maxAmountRequired.
Address has insufficient USDC or was flagged by KYT.
Check the error field in the server's JSON response for details.
Ensure you set network: "base" (not "base‑sepolia").
Confirm your wallet has mainnet USDC.
Gas fees are higher on mainnet; fund the wallet with a small amount of ETH for gas.
Spec:
• Reach out in the • Open a GitHub Discussion or Issue in the