Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

将 HTTP 端点货币化

x402 是一个基于 HTTP 构建的支付协议。服务器返回 402 Payment Required 以及付款详情，客户端签署一份 ERC-3009 授权，促成方在链上结算。整个交换过程通过标准的 HTTP 标头完成。客户端只需要一个钱包：无需注册、无需 API 密钥、无需信用卡登记。

这适用于任何客户端为资源或服务向服务器付款的场景：API 访问、数字内容、商户结账或代理之间的付款。

x402 与 MPP

x402 是最初的 HTTP-402 支付协议。机器支付协议 (MPP) 是一个更广泛的、IETF 标准轨道的后继协议，它增加了支付意图（会话、订阅）、多轨支持（卡、Lightning）以及生产特性（正文摘要绑定、幂等性）。MPP 客户端向后兼容：它们无需更改即可调用 x402 服务器。

如今在 Stable 上，最直接的途径是通过 Semantic Pay 或 Heurist 使用 x402。要在同一 USDT0 轨道上使用 MPP 的传输格式，请参阅在 Stable 上构建 MPP 端点。

它解决了什么问题？

如今在互联网上为服务付款需要在每一步都进行用户干预：注册账户、登录、登记付款方式。这种模式无法扩展到：

  • 太小而不足以证明基础设施成本合理的服务
  • 太便宜而无法承担卡网络费用的交易
  • 无法执行注册流程的自主代理（AI、机器人、IoT 设备）

有了 x402，客户端只需要一个钱包即可付款。

方面传统计费使用 x402
需要账户是否
需要 API 密钥是否
最低可行价格~$0.30（卡处理下限）~$0.001（链上）
结算时间数天（卡网络）亚秒级（在 Stable 上）
需要 PCI 合规是否

工作原理

三种角色

客户端是任何需要资源的一方：网页应用、后端服务、CLI 工具或 AI 代理。客户端只需要一个钱包（一个可以签署 ERC-3009 授权的私钥）。

服务器是任何提供资源的一方。服务器通过将 x402 中间件附加到其端点来定义什么收费多少。

促成方是结算服务。它接收来自服务器的已签名付款，对其进行验证，提交链上交易，并返回结果。促成方从不持有客户端的资金。转账直接在代币合约内从客户端转移到服务器。

在 Stable 上，Semantic Pay 运营着一个公共促成方。

付款流程

  1. 客户端请求资源。 客户端向服务器发送正常的 HTTP 请求（GET、POST 等）。
  2. 服务器返回 402。 服务器返回 HTTP 402 Payment Required 以及一个包含客户端所需全部信息的 PAYMENT-REQUIRED 标头：需要付多少款、哪种代币、哪个网络以及将资金发送到哪里。
  3. 客户端签名并重新提交。 客户端读取付款要求，为指定金额签署一份 ERC-3009 授权，并使用包含已签名授权的 PAYMENT-SIGNATURE 标头重新提交原始请求。
  4. 促成方验证并结算。 服务器将已签名的付款转发给其促成方。促成方验证签名，在链上提交 transferWithAuthorization 调用，确认后，服务器返回所请求的资源以及一个包含结算收据的 PAYMENT-RESPONSE 标头。

三个标头

所有付款信息都通过标准的 HTTP 标头传输，以 Base64 编码：

标头方向内容
PAYMENT-REQUIRED服务器到客户端付款方案、代币地址、金额、收款人地址、网络标识符
PAYMENT-SIGNATURE客户端到服务器证明客户端已授权转账的已签名 ERC-3009 授权
PAYMENT-RESPONSE服务器到客户端包括交易哈希和确认状态的结算结果

这种设计适用于任何 HTTP 客户端、任何编程语言以及任何支持自定义标头的基础设施。

Stable 上的 x402

x402 协议定义了付款如何通过 HTTP 工作。Stable 提供使其在生产环境中实用的结算环境。

亚秒级最终性

Stable 的共识提供亚秒级的区块最终性（约 700 毫秒），使 x402 促成方能够实时验证和结算交易。这对于 AI 代理或 IoT 设备可能快速连续执行许多小额付款的高频自动化交互至关重要。

单一资产结算

在 Stable 上，USDT0 既是原生 gas 代币，也是付款代币。整个 x402 付款生命周期仅在 USDT0 上运行。客户端仅持有 USDT0，促成方使用其结算的同一代币提交交易。对于使用 x402 的 AI 代理而言，这意味着代理钱包只需管理一种资产。

微定价

价格以 USDT0 原子单位（6 位小数）计价：成本参数 "1000" 恰好转换为 $0.001。这种精度使 x402 服务器能够将价格设置为一美分的几分之一。

Gas 豁免集成

Gas 豁免完全消除了交易成本。x402 促成方可以使用 Gas 豁免基础设施提交 transferWithAuthorization 调用，而无需向买方或卖方收取 gas 费用。这意味着 Stable 上的 x402 微支付除了付款金额本身之外不产生任何额外开销。

基础设施

Semantic Pay

Semantic Pay 为 Stable 提供了一个公共的 x402 促成方。它处理签名验证、链上提交和确认跟踪。在 Stable 上集成 x402 的开发者可以将其中间件指向此端点，而无需运行自己的结算基础设施。

促成方端点： https://x402.semanticpay.io

WDK（钱包开发工具包）

为了让 AI 代理自主参与 x402，它们需要能够以编程方式控制的钱包。Tether 的开源 WDK 提供了这一点：

  • 自我托管：WDK 使 AI 代理能够在本地生成和存储私钥，而无需依赖中心化的 API 基础设施。
  • x402 兼容性：WDK 的 WalletAccountEvm 实例原生满足 x402 SDK 所需的客户端签名者接口，使代理能够自动拦截 402 HTTP 响应、签署 ERC-3009 授权并重新提交请求。
另请参阅：