Micropayments For Agents And Developers
按次付费调用 API, 不注册, 不发 Key。
面向 AI Agent、自动化工作流和开发者的 API 支付网关。先请求,收到 402 挑战,再用钱包授权完成单次调用。
Machine-Readable Catalog
可直接给 Agent 调用的 API 目录
前端和 SDK 都从同一份 catalog 读取价格、说明和支付要求。避免页面说一套、网关跑一套。
Builder Workflow
支付流程保持简单,接入模型尽量稳定
请求 API
客户端先正常调用 API。如果还没支付,网关返回 402,并附带 `payTo`、价格和支付头要求。
签名或演示授权
现在支持 demo token,也预留了 `PAYMENT-SIGNATURE` / `Authorization` 的签名承载方式。
拿回数据
网关验证通过后返回真实上游数据或 demo 数据,并附带 `_meta` 方便前端与 SDK 做调试。
Settlement Config
收款地址与支付参数
如果别人调用你的付费 API,网关必须明确告诉对方把钱打到哪个地址。这里展示当前 Worker 对外暴露的收款地址和支付参数。
面向 Agent 的接口边界
免费 catalog 提供 discovery,付费接口返回结构化挑战。Agent 不需要看营销文案,也能知道怎么完成一次请求。
Cloudflare Worker 一体部署
静态页面、catalog、健康检查和付费 API 统一由同一 Worker 提供,减少配置漂移和部署分裂。
真实支付和 SDK
下一阶段重点是链上支付验证、SDK 自动重放请求、更多真实上游代理,以及钱包级限流。
FAQ
开发时最容易问的几个问题
现在是真实链上扣款吗?
还不是。这一版保留 demo 授权路径,同时把 catalog、挑战格式和前后端模型统一,为接入真实 EIP-3009 / x402 验证做准备。
为什么还保留 demo token?
因为它能保证产品页、联调页和 SDK 示例在没有真实钱包支付的情况下也能完整演示 402 -> replay -> data 的工作流。
本地调试时怎么连 API?
页面会优先使用线上 Worker 作为 API 基地址。部署到 `api-402.com` 或 `workers.dev` 后,会自动切换成同源调用。