StableOps
常見問題

我該用 SDK 自行接入還是託管結帳頁?

比較使用 StableOps SDK 自建支付頁面與跳轉到託管結帳頁的差異,瞭解兩種方案在開發工作量、介面控制、錢包支援、網路選擇和狀態跟蹤方面的取捨,並根據團隊能力、品牌體驗與上線速度選擇合適的整合方式。

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 與對帳程式碼。

相關閱讀

這篇文件怎麼樣?

最後更新

本頁內容