跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

x402

最后更新 查看 MarkdownAgent 设置

x402 ↗ 是围绕 HTTP 402(Payment Required)构建的支付标准。服务返回带支付说明的 402 响应,客户端无需账户、会话或 API 密钥即可以编程方式支付。

工作原理

  1. 客户端请求资源 — GET /resource。
  2. 服务器返回 402 Payment Required,PAYMENT-REQUIRED 头包含 Base64 编码的支付详情:价格、接受的 token、网络和商户地址。
  3. 客户端构造签名支付 payload,并携带 PAYMENT-SIGNATURE 头重试请求。
  4. 服务器会验证支付载荷(直接验证或调用服务商验证),然后在链上结算交易。
  5. 服务器返回资源,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 ↗ 可用于不同网络。

支付 scheme 与网络

x402 使用支付 scheme 定义在给定网络上如何构造和结算支付。

方案 网络 描述
exact ↗ EVM、Solana、Aptos、Stellar、Hedera、Sui、Algorand 转移固定 token 数量 — 通常是 EVM 上的 ERC-20 ↗ USDC — 到商户地址。
upto ↗ EVM 授权最大金额;实际收费在结算时根据资源消耗确定。

支持的网络包括 Base、Ethereum、Polygon、Optimism、Arbitrum、Avalanche、Solana、Aptos、Stellar、Sui 和 Algorand。测试时,请使用 base-sepolia,并从 Circle Faucet ↗ 获取免费的测试 USDC。

对资源收费

HTTP 内容

使用 Worker 代理对 API、网页和文件进行门控

支付资源

Agents SDK

使用 withX402Client 包装 MCP 客户端

SDK

包 安装 用途
x402-hono npm install x402-hono Worker 服务器的 Hono 中间件
@x402/fetch npm install @x402/fetch 带自动支付处理的 Fetch 包装器
@x402/evm npm install @x402/evm EVM 支付 scheme 支持
@x402/avm npm install @x402/avm 支持 Algorand 支付方案
agents/x402 包含在 agents 中 带 x402 支付支持的 MCP 客户端

相关

这篇文档对您有帮助吗?