x402-development

基于HTTP 402的链上微支付SDK

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:x402-development。
它的用途是:基于HTTP 402的链上微支付SDK
完整的 Skill 内容见:https://321skill.com/skills/x402-development-x/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请帮我集成x402支付到我的AI绘画服务中,每次生成图片前先返回HTTP 402要求支付0.01 ETH。' 它会自动安装npm包,在响应中间件中添加402判断逻辑,并配置钱包地址和链上验证回调,完成从请求到支付的闭环。

介绍

x402-development 是一套基于 HTTP 402 Payment Required 状态码的开放协议 SDK,旨在为互联网原生支付场景提供无账户、无 API Key 的链上微支付能力。传统支付方案往往需要用户注册、绑定银行卡或接入第三方支付网关,而 x402 通过 HTTP 402 状态码直接触发链上交易,让开发者能够以极低的摩擦成本实现按调用付费、按内容付费等场景。

使用方式非常简单:在后端服务或 AI 应用中,当需要收费时返回 HTTP 402 响应,客户端收到后自动构造并提交链上交易,验证通过后即可获得资源。该协议覆盖 TypeScript、Python、Go 三种主流语言,并支持 EVM、Solana、Stellar、Aptos、NEAR、XRPL 等多条区块链,开发者只需安装对应 SDK 并配置钱包地址即可快速集成。

适合正在开发付费 API、付费内容、AI Agent 计费系统或 MCP 工具的开发者,尤其是希望避免用户注册流程、追求轻量级链上结算的团队。无论是个人开发者构建收费的 AI 接口,还是企业搭建去中心化微支付网关,都能从中受益。

建议先在小流量场景中测试交易流程和用户体验,确认链上确认时间与回退机制是否满足业务要求。由于采用区块链原生支付,交易最终确认存在一定延迟,不适合要求秒级到账的场景。另外需注意处理交易失败时的重试逻辑,避免因网络拥堵导致服务中断。

核心特点

与其他支付 SDK 不同,x402 基于 HTTP 402 状态码实现无账户、无 API Key 的链上微支付,一次集成即可在多个区块链上运行,无需对接多个支付网关。

注意事项

不适合需要用户登录、订阅制或支持法币支付的场景,且链上交易确认时间受网络拥堵影响,不适合高频低延迟的支付场景。

常见问题

如何在AI应用中集成x402支付?

安装对应语言SDK后,在返回AI响应前判断是否需付费,若需付费则返回HTTP 402,客户端自动处理链上交易,验证通过后返回资源。

x402支持哪些区块链?

目前支持EVM(以太坊、Polygon等)、Solana、Stellar、Aptos、NEAR、XRPL。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/x402-development-x/raw/index.md 读取 x402-development 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。