# x402

> x402是由Coinbase开发的开源支付协议，基于HTTP 402标准。它实现了互联网原生的API和数字资源微支付。

- Canonical URL: https://iq.wiki/zh/wiki/x402
- Categories: Projects & Protocols
- Tags: DeFi, AI Token
- Created: 2025-09-15T01:37:20.733Z
- Last updated: 2025-09-15T01:58:05.701Z
- Source: IQ.wiki — the world's largest blockchain and crypto encyclopedia (https://iq.wiki)

---

**x402** 是由 [Coinbase](https://iq.wiki/wiki/coinbase) 开发的基于 HTTP 标准的开源支付协议。它利用历史上处于休眠状态的 *402 Payment Required* 状态码，使用链上资产（如 [稳定币](https://iq.wiki/wiki/stablecoin)）实现互联网原生的机器对机器微支付。



## 概述

x402 协议旨在解决传统在线支付系统（如信用卡和银行转账）中存在的效率低下问题，这些系统通常具有高摩擦、结算时间慢以及不适合程序化或自动化交易的特点。 [\[8\]](#cite-id-ERDG4Xiy3m) 该项目的核心理念是互联网上的支付应该像信息的 [流动](https://iq.wiki/wiki/flow) 一样无缝和原生。它旨在创建一个支付轨道，人类用户和自主 [AI 代理](https://iq.wiki/wiki/ai-agents) 都可以同样访问，从而促进 API 调用、数据访问和云计算等数字资源的按次付费经济。 [\[6\]](#cite-id-event-project-inception-on-github-link) [\[1\]](#cite-id-z9RPQ1pYeJ)

[Coinbase](https://iq.wiki/wiki/coinbase) 将该协议定位为“修复互联网的第一个错误”的一种方式，认为传统的支付轨道是为“互联网前时代”构建的，速度慢、成本高且地域限制。 [\[8\]](#cite-id-ERDG4Xiy3m) 该协议复活了实验性的 HTTP 402 状态代码，以创建一个互联网原生的支付系统，将 [稳定币](https://iq.wiki/wiki/stablecoin) 支付直接嵌入到 Web 交互中。随着机器对机器交互和 AI 驱动服务的兴起，该协议旨在提供一个即时、可编程、可互操作且信任最小化的支付层。 [\[9\]](#cite-id-A8GjY5qXBF)

该协议被设计为一个开放标准，以防止依赖任何一方。它是链
- 和代币无关的，允许扩展到新的 [区块链](https://iq.wiki/wiki/blockchain) 网络和数字资产。通过直接集成到标准的客户端-服务器 HTTP 请求 [流程](https://iq.wiki/wiki/flow) 中，它避免了对单独支付接口或复杂的用户身份验证过程（如 OAuth）的需求。x402 的灵感来自 [Balaji Srinivasan](https://iq.wiki/wiki/balaji-srinivasan) 在 21.co 早期对加密微支付的研究，而最近低成本的 Layer 2 区块链（如 [Base](https://iq.wiki/wiki/base)）的出现使这一概念在经济上更可行。 [\[7\]](#cite-id-event-x402-protocol-officially-launched-link)

在协议的公告中，[Coinbase](https://iq.wiki/wiki/coinbase) 开发者平台工程主管 Erik Reppel 表示：“就像 HTTPS 保护了 Web 一样，x402 可以定义互联网的下一个时代；一个价值像信息一样自由和即时流动的时代。我们正在为不仅由人，而且由软件运行的经济奠定基础——自主、智能且始终在线。” [\[7\]](#cite-id-event-x402-protocol-officially-launched-link) [\[8\]](#cite-id-ERDG4Xiy3m) 该协议强调信任最小化，支付方案旨在防止中介机构滥用客户的资金。它还优先考虑开发人员的易用性，旨在实现“一行代码”集成，以 [抽象](https://iq.wiki/wiki/abstract) 出与加密相关的复杂性，如 [gas](https://iq.wiki/wiki/gas) 费用和 RPC [节点](https://iq.wiki/wiki/node) 管理。 [\[6\]](#cite-id-event-project-inception-on-github-link)


## 历史

x402的开发由[Coinbase](https://iq.wiki/wiki/coinbase)开发者平台主导，项目[白皮书](https://iq.wiki/wiki/white-paper)由Erik Reppel、Ronnie Caspers、Kevin Leffew、Danny Organ、Dan Kim和Nemil Dalal撰写。 [\[2\]](#cite-id-UwTVIQe8nV)

其早期历史的关键里程碑包括：

* **2025年2月27日：** 项目的Apache-2.0许可文件在其官方存储库中创建，标志着早期的基础性步骤。
* **2025年4月25日：** 一项重要的提交建立了核心TypeScript生态系统，包括用于Express、Next.js和Hono等框架的多个npm模块。
* **2025年5月6日：** [Coinbase](https://iq.wiki/wiki/coinbase)公开宣布推出x402开放标准并发布其官方[白皮书](https://iq.wiki/wiki/white-paper)。该公告包括协议的详细信息、其配套工具以及启动合作者的列表。 [\[8\]](#cite-id-ERDG4Xiy3m)
* **2025年6月13日：** `ROADMAP.md`和`PROJECT-IDEAS.md`文件被添加到存储库中，概述了协议的未来方向和潜在应用。
* **2025年8月30日：** 添加了对[Solana](https://iq.wiki/wiki/solana) [区块链](https://iq.wiki/wiki/blockchain) (SVM) 的支持，展示了该协议超越其最初EVM重点的多链能力。

这些事件说明了该项目从概念到公开发布的多链协议的演变。 [\[6\]](#cite-id-event-project-inception-on-github-link) [\[7\]](#cite-id-event-x402-protocol-officially-launched-link)


## 技术

x402协议直接构建于现有的HTTP框架中，利用标准状态码和标头来促进支付，而无需新的通信层。

#

## 核心机制

该协议的功能主要围绕 HTTP `402 Payment Required` 状态码展开，该状态码在早期的 Web 标准中定义，但在 25 年多的时间里基本上未被使用。当客户端从启用 x402 的服务器请求受保护的资源时，服务器可以返回 402 状态。此响应包含一个 JSON 正文，其中包含支付详细信息，例如所需金额、接收者地址以及接受的代币和[区块链](https://iq.wiki/wiki/blockchain)网络。然后，客户端使用此信息来构建、签名支付负载，并将其附加到后续的同一资源请求中。服务器在授予访问权限之前会验证此负载。整个过程发生在标准的请求-响应周期中。 [\[2\]](#cite-id-UwTVIQe8nV) [\[3\]](#cite-id-Pc5qhkqf56) [\[9\]](#cite-id-A8GjY5qXBF)

#

## 架构

x402 架构涉及三个主要参与者：

* **客户端：** 为资源付费的实体。这可以是 Web 浏览器、命令行应用程序或自主 AI 代理。客户端负责创建和签署支付负载。
* **资源服务器：** 提供付费资源的 HTTP 服务器，例如 API 端点或数字文件。此服务器负责发出 402 质询并在满足请求之前验证付款。
* **协调服务器：** 一个可选但推荐的第三方服务，用于处理链上支付验证和结算。通过卸载这些任务，资源服务器无需维护直接的 [区块链](https://iq.wiki/wiki/blockchain) 连接、管理钱包或处理私钥，从而简化其运营要求。

这种架构允许关注点分离，资源服务器专注于提供其核心服务，而协调器处理 [区块链](https://iq.wiki/wiki/blockchain) 交互的复杂性。 [\[6\]](#cite-id-event-project-inception-on-github-link)

#

## 协议流程

支付和资源访问过程遵循一系列明确的步骤：

1. **初始请求：** `客户端`向`资源服务器`发出标准的HTTP请求，请求受保护的资源。
2. **支付质询：** 服务器返回HTTP `402 Payment Required`状态。响应正文包含一个JSON对象，详细说明了接受的支付方式，包括价格、货币和网络。
3. **支付载荷创建：** `客户端`选择一种支付方式，并使用其钱包创建并以加密方式签署支付载荷。这通常使用EIP-712等标准来确保签名消息是人类可读的。
4. **已支付请求：** `客户端`为同一资源发送一个新的HTTP请求，这次在自定义`X-PAYMENT`头中包含已签名的支付载荷。
5. **验证：** `资源服务器`接收已支付的请求并验证支付载荷。它可以在本地执行此操作，也可以将载荷发送到`中介服务器`的`/verify`端点。
6. **履行：** 如果验证成功，`资源服务器`将处理请求并生成资源。
7. **结算：** `资源服务器`结算付款。这可以通过直接与[区块链](https://iq.wiki/wiki/blockchain)交互或将经过验证的载荷发送到`中介服务器`的`/settle`端点来完成。
8. **确认：** `中介服务器`将交易提交到[区块链](https://iq.wiki/wiki/blockchain)，等待确认，并将结果（包括交易哈希）返回给`资源服务器`。
9. **最终响应：** `资源服务器`向`客户端`发送`200 OK`响应，传递请求的资源。它还可以包含一个`X-PAYMENT-RESPONSE`头，其中包含成功交易的详细信息。

此流程将支付直接集成到Web的本机通信协议中，使用自定义头来管理交易，而不会改变HTTP的根本工作方式。 [\[6\]](#cite-id-event-project-inception-on-github-link) [\[7\]](#cite-id-event-x402-protocol-officially-launched-link) [\[9\]](#cite-id-A8GjY5qXBF)

#

## 关键概念

* **方案 (Schemes):** 转移资金的逻辑方法。该协议被设计为可扩展的，支持不同的方案。第一个提出的方案是 `exact`，用于转移特定的、预定义的金额。未来理论上的方案 `upto` 可用于基于资源消耗的支付，例如 LLM token 的生成。
* **网络 (Networks):** 该协议与区块链无关，通过支持 `(方案, 网络)` 对来运作，例如在 [Ethereum](https://iq.wiki/wiki/ethereum) 或 [Solana](https://iq.wiki/wiki/solana) 上的 `exact` 支付。
* **协调器 API (Facilitator API):** 协调器服务器公开了一个简单的 API 来协助资源服务器。关键端点包括 `POST /verify` 来验证支付负载，`POST /settle` 来将支付提交到 [区块链](https://iq.wiki/wiki/blockchain)，以及 `GET /supported` 来列出协调器支持的支付方案和网络。

这些概念为互联网原生支付提供了一个灵活且可扩展的框架。 [\[6\]](#cite-id-event-project-inception-on-github-link) [\[3\]](#cite-id-Pc5qhkqf56)

#

## Bazaar Discovery Layer

x402 Bazaar是协议生态系统的发现层，[Coinbase](https://iq.wiki/wiki/coinbase)将其描述为“代理搜索引擎”，也是代理商务的第一个发现层。它作为一个去中心化的开放网络运作，服务器通过托管机器可读的`x402.json`清单文件（通常位于`.well-known/x402.json`路径）来宣传其付费服务。该文件列出了可用的资源、API端点、定价详情和接受的支付方式，为[AI代理](https://iq.wiki/wiki/ai-agents)创建了一个市场，使其能够自主发现并支付[API](https://iq.wiki/wiki/apis)费用，无需人工干预。该系统的主要目的是解决AI的工具发现问题，使代理能够动态地查找和使用添加到生态系统中的新服务。这解锁了一类新的自我改进、自适应代理，它们可以随着可用工具网络的增长而不断发展能力，从而能够自动执行复杂的多步骤任务，如研究数据、委托AI生成的艺术品或预订服务。 [\[4\]](#cite-id-YhB2v81VAY) [\[5\]](#cite-id-RLz8TXpTN6) [\[6\]](#cite-id-vcmBuLWv4E)



## 与传统系统的比较

#

## x402 与传统支付渠道的比较

x402 的设计与 Visa、Stripe 和 PayPal 等传统在线支付系统有着根本的不同。虽然传统系统以平台为先，以人为本——需要登录、用户帐户和手动步骤——但 x402 以协议为先，并针对机器对机器的交互进行了优化。主要区别包括：

* **结算时间：** x402 支付可以通过链上交易在几秒钟内结算，而传统的[渠道](https://iq.wiki/wiki/rails)通常需要一到三个工作日。
* **小额支付：** 该协议支持小至几美分的分数支付，这种模式在信用卡网络上由于高额的固定费用而不可行。
* **全球访问：** 作为一个加密原生协议，x402 在设计上是全球性的，不需要货币兑换或区域银行关系。
* **管理费用：** 它旨在通过利用链上转账的不可变性，几乎消除退款、欺诈风险和中介费用。
* **集成：** 传统系统需要与中心化处理器进行复杂的集成，并且通常涉及重定向。x402 将支付直接嵌入到 HTTP 协议中，无需单独的接口。

这种结构支持一种原生于互联网架构的后端到后端货币化模型。 [\[9\]](#cite-id-A8GjY5qXBF)

#

## 人工智能支付的现有方法

主要的支付巨头也开始探索人工智能驱动的和 [稳定币](https://iq.wiki/wiki/stablecoin) 驱动的支付。Visa 宣布了 [人工智能代理](https://iq.wiki/wiki/ai-agents) 进行购买的计划，Stripe 引入了 [稳定币](https://iq.wiki/wiki/stablecoin) 金融账户，PayPal 推出了自己的 [稳定币](https://iq.wiki/wiki/stablecoin) ([PYUSD](https://iq.wiki/wiki/paypal-usd-pyusd)) 并附带奖励计划。然而，这些努力都在中心化的“围墙花园”生态系统中运作。他们的服务是许可制的，受公司政策管辖，并且需要注册和平台批准。相比之下，x402 是一个开放且无需许可的协议，允许任何开发者集成它，而无需商家帐户或批准。封闭服务和开放协议之间的这种区别是 x402 创建更分散的、代理驱动的经济的目标的核心。 [\[9\]](#cite-id-A8GjY5qXBF)



## 货币化和费用

x402协议本身是一个开放标准，不向商家或客户收取任何费用。实施和使用都是免费的。但是，使用该协议进行的交易需要支付底层[区块链](https://iq.wiki/wiki/blockchain)上的标准网络费用（[gas](https://iq.wiki/wiki/gas)费）。通过利用低成本的Layer 2网络，这些费用可以忽略不计，使得低至0.001美元的小额支付在经济上可行。这种模式与传统的支付系统形成对比，后者通常包括固定费用加上交易价值的百分比。 [\[1\]](#cite-id-z9RPQ1pYeJ) [\[2\]](#cite-id-UwTVIQe8nV)

[USDC](https://iq.wiki/wiki/usdc)等稳定币在该协议的功能中至关重要。其价格稳定性允许代理和开发者以可预测的单位进行交易，而无需承担加密货币市场波动的风险。此外，[Base](https://iq.wiki/wiki/base)等高速链或其他Layer 2上的稳定币提供快速的最终性，转移在几秒钟内确认，费用极低，使其成为x402旨在处理的高频率、低价值交易的理想选择。 [\[9\]](#cite-id-A8GjY5qXBF)



## 使用案例

该协议旨在为数字经济实现新的货币化模式，特别是对于程序化和自动化系统。

#

## AI Agent Economy

x402 的主要重点是为“代理商务”提供支付层，使自主 [AI 代理](https://iq.wiki/wiki/ai-agents) 能够在没有人为干预的情况下进行交易。这使得代理能够根据需求为资源付费，从而将它们从需要持续人为交互的工具转变为自主的经济参与者。 [\[8\]](#cite-id-ERDG4Xiy3m)

* **自主计算：** 代理可以按每次推理或每秒使用量支付 GPU 资源或云服务费用。
* **数据获取：** 代理可以自主购买对实时市场数据、专有数据集或来自高级来源的文章的访问权限，按每次查询付费。
* **自动化工作流程：** 代理可以通过支付物流 [API](https://iq.wiki/wiki/apis) 来管理供应链，在预测市场中下注，或获取数字资产作为更大的自动化策略的一部分。

[NEAR](https://iq.wiki/wiki/near-protocol) 的联合创始人 [Illia Polosukhin](https://iq.wiki/wiki/illia-polosukhin) 对此潜力发表评论：“我们的愿景是将 x402 的无摩擦支付与 [NEAR intents](https://iq.wiki/wiki/near-intents) 相结合，让用户能够自信地通过他们的人工智能代理购买任何东西，同时代理开发者可以通过跨链结算来收取收入，从而使 [区块链](https://iq.wiki/wiki/blockchain) 的复杂性变得不可见。” [\[7\]](#cite-id-event-x402-protocol-officially-launched-link)

#

## 代理支付

“代理支付”是x402用例的核心概念。这些是由软件代理而非人类自动进行的支付，其特点是快速、可编程且通常价值较低。传统的支付基础设施并非为此而设计，因为它需要手动步骤、费用高且结算时间慢，因此不适合自主、高频的交易。代理支付对于实现机器优先的经济至关重要，它通过消除访问付费服务的摩擦来实现实时AI决策，并为可组合服务铺平道路，使代理可以自主地将付费[API](https://iq.wiki/wiki/apis)链接在一起。 [\[9\]](#cite-id-A8GjY5qXBF)

#

## 开发者和内容货币化

x402为开发者和创作者提供了订阅模式或广告支持之外的替代收入模式。

* **付费API：** 开发者可以通过微支付来货币化每个API调用，实现真正的按需付费模式，而不是分层订阅计划。
* **软件和内容解锁：** 该协议可用于按需、按次付费访问高级软件功能、新闻文章、视频或其他数字内容，无需订阅或信用卡最低消费。 [\[8\]](#cite-id-ERDG4Xiy3m)
* **计量服务：** 云存储提供商或其他基础设施服务可以根据实际资源消耗量进行计费，并以接近实时的速度结算付款。

这些用例得益于该协议能够高效地处理小额、频繁的交易，而无需用户注册或输入信用卡信息。 [\[2\]](#cite-id-UwTVIQe8nV) [\[3\]](#cite-id-Pc5qhkqf56)



## 生态系统和采用

x402 作为一个开源项目启动，并得到了 [Coinbase](https://iq.wiki/wiki/coinbase) 以及来自技术和 [web3](https://iq.wiki/wiki/web3) 行业的众多合作者的支持。

#

## 开发和支持

该协议是 [Coinbase](https://iq.wiki/wiki/coinbase) 开发者平台的一项举措，其主要存储库由 GitHub 上的 [Coinbase](https://iq.wiki/wiki/coinbase) 组织维护。该标准采用 Apache-2.0 许可，鼓励广泛采用和社区贡献。官方开发者资源包括 GitBook 上托管的文档和一个用于使用 x402 构建 AI 应用程序的 Vercel 入门模板。 [\[6\]](#cite-id-event-project-inception-on-github-link) [\[3\]](#cite-id-Pc5qhkqf56)

#

## 实现

提供了官方库和SDK，以方便客户端和服务器应用程序在多种编程语言中集成：

* TypeScript（具有针对Express、Next.js、Hono、Axios和Fetch的特定包）
* Python
* Go
* Java

这些库旨在简化 x402 支付[流程](https://iq.wiki/wiki/flow)的实施。 [\[6\]](#cite-id-event-project-inception-on-github-link)

#

## 合作者和早期采用者

该项目于2025年5月6日启动，得到了多个关键组织的支持。

* **启动合作者：** AWS、Anthropic、[Circle](https://iq.wiki/wiki/circle)和[NEAR](https://iq.wiki/wiki/near-protocol)。
* **早期采用者和构建者：** 一批多元化的公司和项目在启动时开始使用x402进行构建，包括用于社交应用的Neynar和XMTP；用于代理交互的Anthropic和NEAR AI；以及用于实时数据演示的[Chainlink](https://iq.wiki/wiki/chainlink)。

[Circle](https://iq.wiki/wiki/circle)的产品管理副总裁Gagan Mac评论说，x402“优雅地简化了实时货币化”，并解锁了“令人兴奋的新用例，如[AI代理](https://iq.wiki/wiki/ai-agents)和应用程序的微支付”。 [\[8\]](#cite-id-ERDG4Xiy3m) 早期采用者Neynar的创始人Rish Mukherji指出该协议的实用性：“x402将Neynar的[Farcaster](https://iq.wiki/wiki/farcaster) [API](https://iq.wiki/wiki/apis)变成了一种纯粹的按需实用程序——代理可以准确地提取他们需要的数据，在同一个HTTP 402往返中以[USDC](https://iq.wiki/wiki/usdc)结算，并完全跳过API密钥或预付费层。” [\[7\]](#cite-id-event-x402-protocol-officially-launched-link)

#

## 与 Vercel 的 MCP 集成

在 2025 年 9 月，Vercel 宣布了 `x402-mcp`，这是一个旨在将 x402 支付协议与模型上下文协议 (MCP) 和 Vercel AI SDK 集成的库。 这种合作解决了 [AI 代理](https://iq.wiki/wiki/ai-agents) 需要访问付费外部服务而无需手动设置（例如管理 API 密钥和单独计费）的挑战。 该集成允许开发人员在其 MCP 服务器中定义 `paidTool`，并为每次工具调用指定价格。 当 AI 代理需要使用其中一个工具时，`x402-mcp` 库会使用 x402 按每次调用进行支付。 这创建了一个自我维持的生态系统，开发人员可以直接通过其工具获利，并且 [AI 代理](https://iq.wiki/wiki/ai-agents) 可以自主发现、授权支付并利用不断增长的功能范围，而无需预先存在的商业关系。 [\[7\]](#cite-id-V81L7Drwde)
