StableOps
常见问题

我该用 SDK 自行接入还是托管收银台?

如何在「用 SDK 自己搭支付页」与「把付款人重定向到 StableOps 托管的收银台页面」之间做选择。

StableOps 提供两种收取稳定币付款的方式。两者创建的是同一套支付单,并通过同一套 Webhook 结算,唯一的区别是由谁来搭支付页

  • 用 SDK 自行接入:你自己搭支付 UI,用 @stableops/api-sdk(在服务端建单)和 @stableops/wallet-sdk(让付款人的浏览器钱包发起链上转账)。
  • 托管收银台:你的服务端创建一个收银台 Session,再把付款人重定向到 StableOps 托管的支付页。钱包支付、自动/手动选网、收款地址展示、实时状态跟踪都已内置。

一览对比

自行接入(SDK)托管收银台
由谁搭支付页StableOps
前端工作量自己实现金额、地址、状态、连钱包几乎为零,一次重定向
服务端工作量建单 + 处理 Webhook建 Session + 处理 Webhook
UI 控制 / 品牌完全自主StableOps 品牌的托管页
钱包 + 手动转账自己接(wallet SDK)已内置
结算的事实来源WebhookWebhook
适合嵌入式/定制收银台、完全掌控设计快速上线、前端投入最小

什么时候选托管收银台

  • 你想要最少的前端工作。你的接入只需创建 Session处理 Webhook,完全不用自己搭支付 UI。
  • 你可以接受一个 StableOps 托管、StableOps 品牌的页面,以及离开应用、再经 successUrl / cancelUrl 跳回的重定向流程。
  • 你希望钱包支付、自动/手动选网、收款地址、实时状态跟踪开箱即用。

建 Session 的调用与参数说明见收银台

什么时候选自行接入

  • 你想把支付体验嵌进自己的应用,对布局、品牌、文案完全掌控。
  • 你已经在渲染自己的购物车/收银台,不想再跳走一次。
  • 你想用 @stableops/wallet-sdk 直接在前端发起链上转账,或在自己的 UI 里 展示 paymentInstructions 供手动转账。

快速开始完整演示了这条路径。

两种方式相同的部分

两条路径共享整套结算引擎,所以选择关乎支付页本身,而与资金如何被跟踪无关:

  • 同一套订单模型。 两者创建相同的支付单,并按 created → detected → confirmed → finalized 推进。
  • 同一批收款地址。 入金都落在你自己管理的链上地址;见 BYO 地址
  • 两种方式都不托管资金。 StableOps 既不保管你的资金,也不接触你的私钥,更不会代你签名或转移任何交易。 付款人直接转入你掌控的地址,StableOps 只负责检测与对账这些链上付款。
  • Webhook 是事实来源。 两种方式都应在 payment.confirmed / payment.finalized Webhook 上履约,绝不要successUrl 跳转或「我已转账」的口头声明当作付款凭证。

由于后端完全一致,你可以先用收银台,之后再迁到自行接入(或两者并行),而无需改动对账逻辑。

还是拿不定主意?

托管收银台直接在收银台页面体验,SDK 接入则推荐去 Playground 试跑。建议先体验托管收银台,它是跑通一笔付款最快的路径,之后切到 SDK 也不用改动你的 Webhook 与对账代码。

相关阅读

这篇文档怎么样?

最后更新

本页内容