Repolode
x402-foundation

x402-foundation/x402

基于 HTTP 的开放互联网支付协议,服务端可通过 402 状态码按次收费。

可替代:Stripe

Star
6,744
Fork
2,209
未关闭 Issue
756
最近提交
6天前

这是什么?

x402 是一套面向互联网原生支付的开放标准。资源服务器(如 API 或网页)可以使用 HTTP 402 Payment Required 状态码向客户端请求付款,客户端则在请求头中附上签名的支付信息。协议同时支持加密货币和法币,可跨多个网络和代币使用。

典型流程是:服务器返回付款要求,客户端选择其中一种并发送支付载荷,再由 facilitator 完成校验并在链上结算,之后服务器才返回资源。exact、upto、batch-settlement 等支付方案定义资金如何转移,网络则决定在哪里结算。项目提供 TypeScript、Python 和 Go 版本的 SDK,并集成了 Express、Fetch、Axios、Hono、Next 等框架。

设计上,客户端和服务端无需处理 gas 和 RPC 等链上细节,这些由 facilitator 承担。支付要求非托管,facilitator 或服务器不能动用超出客户端意图的资金。

核心功能

  • 01通过 HTTP 402 返回付款要求,客户端据此完成支付。
  • 02支持 exact、upto、batch-settlement 等多种支付方案。
  • 03通过可插拔的链实现支持多个区块链网络及法币。
  • 04提供 TypeScript、Python 和 Go 的 SDK。
  • 05为 Express、Fastify、Hono、Next 等框架提供中间件。

适用场景

  • 为付费 API 按次收费,无需用户账户或订阅。
  • 以小额单次付费出售文章、数据或文件访问权限。
  • 让 AI 智能体或自动化客户端通过 HTTP 为网络资源付费。

快速上手

  1. 1

    安装 TypeScript Express 服务端包

    npm install @x402/core @x402/evm @x402/svm @x402/express
  2. 2

    安装 Python 包

    pip install x402
  3. 3

    安装 Go 模块

    go get github.com/x402-foundation/x402/go/v2

使用前须知

  • 支付方案和网络支持各不相同,客户端和facilitator必须明确支持每一种(scheme, network)组合。
  • README 建议不要默认将公共 x402.org facilitator 用于主网 EVM 生产环境。

标签

常见问题

x402 是什么?
基于 HTTP 的开放互联网支付协议,服务端可通过 402 状态码按次收费。 x402 是一套面向互联网原生支付的开放标准。资源服务器(如 API 或网页)可以使用 HTTP 402 Payment Required 状态码向客户端请求付款,客户端则在请求头中附上签名的支付信息。协议同时支持加密货币和法币,可跨多个网络和代币使用。
x402 可以免费使用吗?用的什么许可证?
x402 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
x402 还在维护吗?
活跃维护中。x402 最近一次提交是在 2026年10月15日。
x402 适合用来做什么?
为付费 API 按次收费,无需用户账户或订阅。 以小额单次付费出售文章、数据或文件访问权限。 让 AI 智能体或自动化客户端通过 HTTP 为网络资源付费。
x402 怎么安装和运行?
安装 TypeScript Express 服务端包: npm install @x402/core @x402/evm @x402/svm @x402/express 安装 Python 包: pip install x402 安装 Go 模块: go get github.com/x402-foundation/x402/go/v2
在哪里获取 x402?
源代码和安装说明在 GitHub 上:https://github.com/x402-foundation/x402

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目