HTTP 402 和 x402 协议完整指南 — 文档、教程、白皮书和开发者资源。
无论你是想要实现按使用付费 API 的开发者、希望变现内容的创作者，还是构建自主支付能力的 AI 代理开发者，这个资源中心都有你开始使用 x402 和 HTTP 402 所需的一切。
x402 协议将长期沉寂的 HTTP 402 状态码转变为强大、实用的支付机制。下面你将找到按主题和技能水平组织的官方文档、代码示例、集成指南和社区资源。
x402 新手？从这里开始了解基础知识，几分钟内就能运行你的第一个集成。
x402 协议全面介绍，包括 V2 功能、钱包认证和多链支持。
深入了解 HTTP 402 状态码、其历史、与其他状态码的比较，以及为什么它终于变得有用。
用户分步指南：设置你的钱包、获取 USDC，并完成你的第一笔 x402 支付。
来自 x402 协议团队和网络标准组织的权威资源。
协议总览、生态系统更新、在线演示和入门指南。x402 新闻和公告的主要来源。
完整的技术规范，涵盖协议设计、工作流程细节、安全考虑和实现指南。
开源参考实现、SDK 代码、示例应用程序和贡献指南。
帮助你快速、安全地将 x402 集成到应用程序中的库和工具。
| 语言 | 包名 | 描述 |
|---|---|---|
| Node.js | @x402/server |
Express/Fastify 中间件，用于使用 402 支付门保护端点 |
| Python | x402-python |
Django/Flask 装饰器，用于向视图添加支付要求 |
| Go | x402-go |
Go Web 框架的 HTTP 中间件 |
| Rust | x402-rs |
带有异步支付验证的 Actix/Axum 中间件 |
| 平台 | 包名 | 描述 |
|---|---|---|
| JavaScript/TypeScript | @x402/client |
浏览器和 Node.js 客户端，用于处理 402 响应和钱包签名 |
| React | @x402/react |
用于支付流程的 React hooks 和组件 |
| Python | x402-requests |
带有自动 402 处理的 Requests 库扩展 |
常见集成场景的分步教程。
HTTP 状态码和支付协议的官方网络标准文档。
Mozilla 开发者网络对 402 状态码的全面参考，包括浏览器兼容性和使用说明。
IETF 的官方 HTTP 规范，包括 402 作为保留状态码的定义。
历史背景、402 发展时间线，以及多年来实现尝试的概述。
所有 HTTP 状态码的快速参考，附带解释和相关代码。
了解支撑 x402 交易的支付层。
USDC 的官方文档，这是 x402 支付中使用的美元支持的稳定币。了解储备金、审计和支持的链。
集成 USDC 的技术文档，包括 API 参考、SDK 和最佳实践。
x402 支持多个网络上的 USDC，提供最大灵活性：
根据你的角色和目标组织的结构化学习旅程。
与 x402 社区连接，在需要时获得帮助。
关注 @x402protocol 获取公告、技巧和生态系统新闻。
对此文档有疑问？请联系 [email protected]
了解 x402 与现有支付集成选项的比较。
| 功能 | x402 | Stripe/PayPal | 手动加密 |
|---|---|---|---|
| 微支付（<$1） | ✅ 高效 | ❌ 费用过高 | ⚠️ Gas 成本不定 |
| 无需账户 | ✅ 仅需钱包 | ❌ 需要账户 | ✅ 仅需钱包 |
| 机器对机器 | ✅ 一等公民 | ❌ 不支持 | ⚠️ 复杂 |
| HTTP 原生 | ✅ 402 状态码 | ❌ 重定向 | ❌ 自定义流程 |
| 全球访问 | ✅ 无需许可 | ⚠️ 地区限制 | ✅ 无需许可 |
| 即时结算 | ✅ 区块链 | ❌ 延迟数天 | ✅ 区块链 |
实现 x402 时的基本安全考虑。
跟踪和优化你的 x402 支付实现。
是的，x402 V2 已可用于生产环境，正被多个应用程序使用。该协议由 Coinbase 支持，并经过了广泛测试。
费用取决于使用的区块链。Base 和 Polygon 提供低于一美分的费用，而 Ethereum 主网每笔交易可能需要几美元。
目前，x402 专注于 USDC 以简化和符合监管要求。多货币支持在路线图中。
退款在应用层处理。由于支付在链上，你需要发送单独的交易来退款到用户的钱包。
x402 是无需许可的——用户不需要 KYC。但是，作为商家，你可能根据你所在的司法管辖区有合规义务。