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 跟踪的继任者，它增加了支付意图（会话、订阅）、多轨道支持（卡片、闪电网络）和生产功能（主体摘要绑定、幂等性）。MPP 客户端向后兼容：它们可以在不更改的情况下调用 x402 服务器。

目前在 Stable 上，最直接的路径是通过 Semantic Pay 或 Heurist 的 x402。要使用 MPP 的 USDT0 轨道线格式，请参阅在 Stable 上构建 MPP 端点。

它解决了什么问题？

如今在互联网上支付服务需要用户在每个步骤都进行干预：注册账户、登录、注册支付方式。这种模式不适用于：

  • 服务规模过小，不足以支持基础设施成本
  • 交易费用过低，无法支付卡网络费用
  • 无法执行注册流程的自主代理（AI、机器人、物联网设备）

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

方面传统计费使用 x402
需要账户是否
需要 API 密钥是否
最低可行价格～$0.30 (卡处理底价)～$0.001 (链上)
结算时间几天 (卡网络)亚秒级 (在 Stable 上)
需要 PCI 合规性是否

工作原理

三种角色

客户端是需要资源的一方：Web 应用、后端服务、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 代理或物联网设备可能快速连续执行许多小额支付的高频自动化交互至关重要。

单一资产结算

在 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 授权，并重新提交请求。
另请参阅：