x402 ↗ 是围绕 HTTP 402(Payment Required)构建的支付标准。服务返回带支付说明的 402 响应,客户端无需账户、会话或 API 密钥即可以编程方式支付。
- 客户端请求资源 —
GET /resource。 - 服务器返回
402 Payment Required,PAYMENT-REQUIRED头包含 Base64 编码的支付详情:价格、接受的 token、网络和商户地址。 - 客户端构造签名支付 payload,并携带
PAYMENT-SIGNATURE头重试请求。 - 服务器验证支付 payload — 直接验证或调用 facilitator — 并在链上结算交易。
- 服务器返回资源,
PAYMENT-RESPONSE头包含结算确认。
客户端是请求付费资源的任何实体:人工操作的应用、AI Agent 或编程服务。客户端只需加密钱包 — 无需管理账户、凭证或会话 token。
服务器在 402 响应中定义支付要求,验证传入支付 payload,结算交易并提供资源。x402 SDK 和 facilitator 自动处理大部分工作。
Facilitator 是可选但推荐的第三方服务,抽象区块链交互。服务器不直接连接节点,而是委托两个操作:
POST /verify— 在服务器 fulfill 请求前确认客户端支付 payload 有效。POST /settle— 将已验证的支付交易提交到区块链。
Facilitator 不持有资金。它代表服务器验证并广播客户端预签名交易。https://x402.org/facilitator 是 Coinbase 运营的公开 facilitator,用于所有 Cloudflare 示例。多个 facilitator ↗ 可用于不同网络。
x402 使用支付 scheme 定义在给定网络上如何构造和结算支付。
| Scheme | 网络 | 描述 |
|---|---|---|
exact ↗ |
EVM, Solana, Aptos, Stellar, Hedera, Sui | 转移固定 token 数量 — 通常是 EVM 上的 ERC-20 ↗ USDC — 到商户地址。 |
upto ↗ |
EVM | 授权最大金额;实际收费在结算时根据资源消耗确定。 |
支持的网络包括 Base、Ethereum、Polygon、Optimism、Arbitrum、Avalanche、Solana、Aptos、Stellar 和 Sui。测试时使用 base-sepolia,从 Circle Faucet ↗ 获取免费测试 USDC。
Agents SDK
使用 withX402Client 包装 MCP 客户端
编码工具
OpenCode 插件和 Claude Code 钩子
| 包 | 安装 | 用途 |
|---|---|---|
x402-hono |
npm install x402-hono |
Worker 服务器的 Hono 中间件 |
@x402/fetch |
npm install @x402/fetch |
带自动支付处理的 Fetch 包装器 |
@x402/evm |
npm install @x402/evm |
EVM 支付 scheme 支持 |
agents/x402 |
包含在 agents 中 |
带 x402 支付支持的 MCP 客户端 |
- x402.org ↗ — 协议规范
- x402 GitHub ↗ — 开源 SDK
- x402 示例 ↗ — 完整工作代码
- Pay Per Crawl — Cloudflare 原生变现