x402-development
基于HTTP 402协议实现无需账户的链上小额支付
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:x402-development。 它的用途是:基于HTTP 402协议实现无需账户的链上小额支付 完整的 Skill 内容见:https://321skill.com/skills/x402-development-x-6/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我想为我的AI问答API设置按次收费,每次调用收费0.01美元,用户不用注册账号。’,它会引导你使用 x402 的 TypeScript SDK,在你的 Node.js 服务端拦截 API 请求并返回 HTTP 402 响应,同时在前端嵌入一个轻量级的支付组件,引导用户用钱包扫码完成支付后自动解锁API调用。
介绍
x402 是一个开源协议,旨在解决互联网原生小额支付的核心痛点:传统支付方式通常需要用户注册账户、绑定银行卡,流程繁琐且不适用于微额场景,而加密货币的直接支付又对用户门槛过高。该协议通过扩展 HTTP 402 “Payment Required” 状态码,让开发者能够轻松地在 API、内容或服务调用中嵌入即时、无需账户的链上支付。
开发者只需集成 x402 的 TypeScript、Python 或 Go SDK,即可在应用层实现支付逻辑。当用户(或AI Agent)请求一个需要付费的资源时,服务器会返回一个包含支付请求的 HTTP 402 响应,客户端(如浏览器、智能体)可以解析此响应并引导用户完成一次性的链上小额支付,支付成功后即可访问资源。整个过程无需用户预先注册或管理 API 密钥。
它非常适合开发付费 API 接口、创建付费内容墙(Paywall)、设计 AI 智能体之间的服务调用计费流程,或为 MCP(Model Context Protocol)工具实现按调用次数收费的机制。任何需要在去中心化环境中实现轻量级、即时结算的开发者都会从中受益。
使用建议是,优先考虑 EVM 兼容链以获得最广泛的 SDK 支持和社区生态。在集成时,需注意设置合理的支付超时时间和 gas 费预估,以优化用户体验。由于支付发生在链上,需确保前端能妥善处理交易等待、失败等情况,并提供清晰的用户指引。
核心特点
与需要预充值账户或复杂 API 密钥管理的传统支付 SDK 不同,x402 直接利用 HTTP 标准状态码和区块链实现了一次性、无状态的即时支付,真正做到了“无账户”支付。其跨链支持(EVM, Solana, Stellar等)和多种语言 SDK 覆盖,使其在去中心化应用支付领域具有独特的通用性和协议级优势。
注意事项
不适合对交易实时性要求极高(秒级以下)或单笔支付金额过大的传统电商场景。
常见问题
x402 支持哪些区块链?
目前支持 EVM(如以太坊、Polygon)、Solana、Stellar、Aptos、NEAR 和 XRPL 链。
使用 x402 需要用户有加密货币钱包吗?
是的,支付需要用户拥有对应区块链的钱包(如 MetaMask、Phantom)并持有少量代币来支付费用和资源费用。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/x402-development-x-6/raw/index.md 读取 x402-development 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/x402-development-x-6/raw/index.md(查看排版版本)