SDK 参考#

Onchain OS Payment 提供 Node.js / Rust / Go / Java 四个 SDK,覆盖 HTTP 卖家场景下的中间件挂载、配置管理、链上结算对账等核心能力。

Agent 卖家场景请使用 OnchainOS Skill,无需 SDK。


支付方式覆盖#

支付方式Node.jsRustGoJava
单次支付 · exact
单次支付 · charge即将推出
批量支付 · aggr_deferred
按量支付 · session即将推出

担保支付 仅 Agent 卖家可用,请使用 OnchainOS Skill,SDK 不覆盖。


选择你的 SDK#


不打算用 SDK?#

支付协议是完全开放的。你也可以基于 API 参考 直接调用 Broker REST 接口,自己处理 402 响应构造、签名验证、Settle 提交等流程。

但这样意味着你需要自己处理:

  • HTTP 402 响应规范(Challenge 字段结构)
  • 多 scheme 声明 + 买家钱包能力检测
  • KYT 错误处理
  • 通道状态对账(如使用 session
  • 聚合结算事件监听(如使用 aggr_deferred

SDK 帮你封装了上述全部细节。除非有强定制需求,否则建议优先用 SDK。


下一步#