常見問題
我該用 SDK 自行接入還是託管結帳頁?
比較使用 StableOps SDK 自建支付頁面與跳轉到託管結帳頁的差異,瞭解兩種方案在開發工作量、介面控制、錢包支援、網路選擇和狀態跟蹤方面的取捨,並根據團隊能力、品牌體驗與上線速度選擇合適的整合方式。
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 與對帳程式碼。
相關閱讀
這篇文件怎麼樣?
最後更新