总览#

Onchain OS Payment 提供两种支付方式：单次支付和批量支付。

• 单次支付：一次请求，一次结算，逐笔上链。适合高价值、需要即时链上确认的场景。
• 批量支付：请求时立即确认，链上结算在后台批量完成。适合 AI Agent 高频、低值的连续调用。

两种方式均支持 X Layer 网络，支持 USDG、USDT，零 Gas 费用。

原理#

两种支付方式共享同一套 x402 协议框架和 API 接口，区别在于签名方式和结算时机。

单次支付#

每次请求独立完成一笔完整的支付：

• 买家的支付签名是 EOA 签名（经过 signConvert 转换），可直接被链上合约接受
• 卖家调用 /settle 后，Facilitator 将交易提交到链上
• 支持同步结算（等待链上确认后返回）和异步结算（提交后立即返回）

→ 详细接入指南见单次支付

批量支付#

买家签名后卖家立即获得确认，链上结算在后台异步批量完成：

• 买家使用 session key 直接签名（跳过 signConvert），签名无法被链上合约直接接受
• 卖家调用 /settle 后，Facilitator 将签名存入数据库，立即返回 status: "success"
• 后台由 TEE 将多笔签名批量压缩为一笔链上交易，大幅降低 Gas 成本
• 安全保障：session key 签名由 TEE 统一结算，卖家无法绕过 Facilitator 自行上链

→ 详细接入指南见批量支付

适用场景#

根据你的业务场景，选择适合的方式：

如果你的业务同时覆盖以上多种场景，不需要二选一。在 402 响应中同时返回 exact 和 aggr_deferred 两个 scheme，系统会根据买家能力自动匹配。