跳转到内容
搜索文档

x402 支付协议

最后更新 查看 MarkdownAgent 设置

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

工作原理

  1. 客户端请求资源 — GET /resource
  2. 服务器返回 402 Payment RequiredPAYMENT-REQUIRED 头包含 Base64 编码的支付详情:价格、接受的 token、网络和商户地址。
  3. 客户端构造签名支付 payload,并携带 PAYMENT-SIGNATURE 头重试请求。
  4. 服务器验证支付 payload — 直接验证或调用 facilitator — 并在链上结算交易。
  5. 服务器返回资源,PAYMENT-RESPONSE 头包含结算确认。

关键组件

客户端

客户端是请求付费资源的任何实体:人工操作的应用、AI Agent 或编程服务。客户端只需加密钱包 — 无需管理账户、凭证或会话 token。

服务器

服务器在 402 响应中定义支付要求,验证传入支付 payload,结算交易并提供资源。x402 SDK 和 facilitator 自动处理大部分工作。

Facilitator

Facilitator 是可选但推荐的第三方服务,抽象区块链交互。服务器不直接连接节点,而是委托两个操作:

  • POST /verify — 在服务器 fulfill 请求前确认客户端支付 payload 有效。
  • POST /settle — 将已验证的支付交易提交到区块链。

Facilitator 不持有资金。它代表服务器验证并广播客户端预签名交易。https://x402.org/facilitator 是 Coinbase 运营的公开 facilitator,用于所有 Cloudflare 示例。多个 facilitator 可用于不同网络。

支付 scheme 与网络

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。

对资源收费

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 支持
agents/x402 包含在 agents 带 x402 支付支持的 MCP 客户端

相关

这篇文档对您有帮助吗?