常见问题
我该用 SDK 自行接入还是托管收银台?
如何在「用 SDK 自己搭支付页」与「把付款人重定向到 StableOps 托管的收银台页面」之间做选择。
StableOps 提供两种收取稳定币付款的方式。两者创建的是同一套支付单,并通过同一套 Webhook 结算,唯一的区别是由谁来搭支付页。
- 用 SDK 自行接入:你自己搭支付 UI,用
@stableops/api-sdk(在服务端建单)和@stableops/wallet-sdk(让付款人的浏览器钱包发起链上转账)。 - 托管收银台:你的服务端创建一个收银台 Session,再把付款人重定向到 StableOps 托管的支付页。钱包支付、自动/手动选网、收款地址展示、实时状态跟踪都已内置。
一览对比
| 自行接入(SDK) | 托管收银台 | |
|---|---|---|
| 由谁搭支付页 | 你 | StableOps |
| 前端工作量 | 自己实现金额、地址、状态、连钱包 | 几乎为零,一次重定向 |
| 服务端工作量 | 建单 + 处理 Webhook | 建 Session + 处理 Webhook |
| UI 控制 / 品牌 | 完全自主 | StableOps 品牌的托管页 |
| 钱包 + 手动转账 | 自己接(wallet SDK) | 已内置 |
| 结算的事实来源 | Webhook | Webhook |
| 适合 | 嵌入式/定制收银台、完全掌控设计 | 快速上线、前端投入最小 |
什么时候选托管收银台
- 你想要最少的前端工作。你的接入只需创建 Session和处理 Webhook,完全不用自己搭支付 UI。
- 你可以接受一个 StableOps 托管、StableOps 品牌的页面,以及离开应用、再经
successUrl/cancelUrl跳回的重定向流程。 - 你希望钱包支付、自动/手动选网、收款地址、实时状态跟踪开箱即用。
建 Session 的调用与参数说明见收银台。
什么时候选自行接入
- 你想把支付体验嵌进自己的应用,对布局、品牌、文案完全掌控。
- 你已经在渲染自己的购物车/收银台,不想再跳走一次。
- 你想用
@stableops/wallet-sdk直接在前端发起链上转账,或在自己的 UI 里 展示paymentInstructions供手动转账。
快速开始完整演示了这条路径。
两种方式相同的部分
两条路径共享整套结算引擎,所以选择只关乎支付页本身,而与资金如何被跟踪无关:
- 同一套订单模型。 两者创建相同的支付单,并按
created → detected → confirmed → finalized推进。 - 同一批收款地址。 入金都落在你自己管理的链上地址;见 BYO 地址。
- 两种方式都不托管资金。 StableOps 既不保管你的资金,也不接触你的私钥,更不会代你签名或转移任何交易。 付款人直接转入你掌控的地址,StableOps 只负责检测与对账这些链上付款。
- Webhook 是事实来源。 两种方式都应在
payment.confirmed/payment.finalizedWebhook 上履约,绝不要把successUrl跳转或「我已转账」的口头声明当作付款凭证。
由于后端完全一致,你可以先用收银台,之后再迁到自行接入(或两者并行),而无需改动对账逻辑。
还是拿不定主意?
托管收银台直接在收银台页面体验,SDK 接入则推荐去 Playground 试跑。建议先体验托管收银台,它是跑通一笔付款最快的路径,之后切到 SDK 也不用改动你的 Webhook 与对账代码。
相关阅读
这篇文档怎么样?
最后更新