方式一：Popup Modal 方式二：嵌入 iframe 方式三：API 對接（自訂 UI）

方式三：API 對接（自訂 UI）

不使用 Stellabit 的任何界面——平台完全自建 UI，直接調用用戶側 API。 Widget 的每一個畫面背後都是同一組 REST API，改為自己呼叫即可，功能完全對等。

對接流程

1
後端簽發用戶 Token
平台後端用 API Key 呼叫 POST /api/widget/token 換取代表用戶身份的短效 JWT；或後端 server-to-server 場景直接用 x-api-key + x-user-id 標頭呼叫，免簽 Token。
2
自家 UI 調用用戶側 API
報價查詢、買賣下單、餘額流水、劃轉、鏈上充提、閃兌——每個 Widget 畫面背後的 REST API 全部開放，功能與 Widget 完全對等。前端帶 Authorization: Bearer {token} 直接呼叫。
3
Webhook 接收事件對帳
訂單完成、充提到帳等事件由 Webhook 主動推送到貴司後端（含簽名驗證），以此為準做入帳與對帳，不依賴前端輪詢結果。

示例：簽 Token → 查報價 → 下單

bash

# 1) 後端：用 API Key 簽發用戶 Token（API Key 絕不可出現在前端）
curl -X POST https://stellabit.cc/api/widget/token \
  -H "Content-Type: application/json" \
  -H "x-api-key: <YOUR_PLATFORM_API_KEY>" \
  -d '{ "userId": "user_123" }'
# → { "token": "eyJhbG…", "expiresIn": 3600 }

# 2) 前端：查詢買幣報價（用戶買 USDT → 查幣商賣單 type=sell）
curl "https://stellabit.cc/api/v1/offers?type=sell&crypto=USDT" \
  -H "Authorization: Bearer <TOKEN>"

# 3) 前端：用選定的報價建立買單
curl -X POST https://stellabit.cc/api/v1/orders/topup \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  -d '{
    "offerId": "<OFFER_ID>",
    "platformUserId": "user_123",
    "fiatAmount": 1000,
    "currency": "THB"
  }'

接入說明

適合場景

希望完全掌控品牌與用戶體驗
已有前端團隊，自建交易界面
App 原生界面（iOS / Android）直接調 API

注意事項

錯誤碼是對外契約，請按文檔錯誤碼一覽表處理，勿只比對訊息文字
Token 沒有 refresh 端點——建議簽短效（預設 1 小時），過期收到 401 時由後端重簽
下單 / 充提失敗要有明確的失敗處理與重試策略，最終以 Webhook 事件對帳為準
平台 API Key 只能放在貴司後端，絕不可打包進前端或 App

完整 API 參考

認證模型、報價、買賣訂單、餘額流水、劃轉、鏈上充提、閃兌、2FA 與錯誤碼一覽，共 23 條用戶側 endpoint，全部在開發者文檔的「API 參考」中。

查看用戶側 API 文檔 →

完整接入文件 →API 參考 →