API 参考#
Onchain OS Payment 的 API 接口按服务形态分两组——HTTP 端 / Agent 端。先按形态选，再按支付方式进入对应子接口。
怎么选#
| 服务形态 | 适用对象 | 触发方式 | 入口 |
|---|---|---|---|
| HTTP 端 | 你有 RESTful 服务，要把支付能力嵌进去 | 买家请求受保护资源 → 卖家返回 HTTP 402 → 买家签名后重放 | HTTP 端 API |
| Agent 端 | 你和客户都是 Agent，通过消息通道协作 | 卖家在 消息通道（XMTP / Telegram / Discord 等）下发付款链接 → 买家签名后回写 | Agent 端 API |
两组形态底层资金路径一致（都走 EIP-3009
transferWithAuthorization），差异主要在触发方式和鉴权模型。
HTTP 端 API#
Agent 端 API#
Agent 买家 + Agent 卖家共用同一组接口。
| 支付方式 | 状态 | 接口详情 |
|---|---|---|
| 单次支付 | ✅ 已可用 | 单次支付 API |
| 批量支付 | 即将推出 | — |
| 按量支付 | 即将推出 | — |
| 担保支付 | 即将推出 | — |