Free guides

Guides

How does an AI agent pay an x402 endpoint? (Client side, tested)

The 402 and PAYMENT-SIGNATURE retry, a tested @x402/fetch client, wallet funding, and the failures we hit, including a $1 default spending cap.

How does an x402 endpoint get listed in the Bazaar? (And are your first payers real?)

A valid 402 is not enough: the CDP Bazaar indexes a route only after a paid call settles through the CDP Facilitator. We validated three live endpoints, then checked what listing gets you.

Where can an AI agent earn USDC today? We checked the bounty boards

An aggregator counted $660 of open USDC bounties for AI agents on 18 Oct 2026. We checked payouts, treasury balances and claim rules: far less is payable.

Do I need a Coinbase account or KYC to receive x402 payments?

No x402 doc we found asks sellers for ID to receive to a wallet you control. What each facilitator does ask: x402.org, PayAI, CDP, Cloudflare. Sourced table.

How much do x402 sellers actually earn?

Very little from agents so far. TRM Labs puts agent-driven x402 volume at about $5,000 to $11,000 a month across all sellers; Crawl Census estimates about $26 a month per seller. Sourced numbers, our own $0 result, and what to do about it.

How to sell a digital file for USDC with x402 on Cloudflare Workers

Step-by-step: return an x402 402, verify a USDC transfer on Base from the receipt, make claims one-time in D1, stop front-running with a wallet signature (or order codes for exchanges), get listed.

How to test an x402 endpoint with curl

Seven curl checks for an x402 v2 paywall: the 402 status, the base64 PAYMENT-REQUIRED header, CORS exposure, amount units, network and asset, HEAD probes and discovery metadata.

Which x402 facilitator can I use on Base mainnet?

Why x402 payments stop working when you switch to Base mainnet with the x402.org facilitator, and the three ways to settle real USDC: CDP, a third-party facilitator, or verifying the transfer yourself.

Why can’t my browser x402 client read the PAYMENT-REQUIRED header?

Browsers hide custom response headers across origins. The CORS headers an x402 v2 server needs: expose PAYMENT-REQUIRED and PAYMENT-RESPONSE, and allow PAYMENT-SIGNATURE in preflight.

How do I test x402 payments on Base Sepolia before mainnet?

Run your x402 endpoint on Base Sepolia (eip155:84532) with the free x402.org facilitator and faucet USDC, then change the three values that differ on Base mainnet.

How do I charge for an MCP tool with x402?

A paid MCP tool answers with an isError tool result, not HTTP 402. Tested: the Cloudflare paidTool setup, why its mainnet example fails with the x402.org facilitator, and the wire-format gap with the x402 MCP spec.

How do I add x402 payments to an Express / Next.js API?

Express uses paymentMiddleware from @x402/express; Next.js uses paymentProxy (pages / multi-route) or withX402 (API routes — settles only after status < 400). Grounded in the official quickstart and a local Express 402 smoke test.

Which x402 facilitator should I use, and what does it cost?

CDP, PayAI, thirdweb, the x402.org test facilitator or self-hosted: fees, free tiers and Base support from each official pricing page, checked 14 Oct 2026. Pairs with the free facilitator cost calculator.

Free tool: x402 endpoint checker

Paste a paid URL and get every check below graded in your browser, plus a JSON API and an MCP endpoint.

Writing a newsletter? See the Solo Newsletter OS guides.