角色與定位
SOHO Wallet 只是商戶系統中的系統部分:商戶利用 SOHO Wallet 建構完整的商戶系統,與支付渠道結合,向自己的客戶提供服務。商戶是在本站開戶的企業或個人:開戶即擁有錢包(可充幣、提幣),自助產生 API Key、自己建立渠道並代渠道操作。開戶免審核,站主不審任何東西。
只有兩種會登入的人
站主(向 Stellabit 取得授權、自行部署本站,負責總覽、煞車與 License)與 商戶(開戶、管 API Key、建渠道)。 商戶底下是渠道(純資料)與客戶(在商戶自己的系統)。
沒有公開看板
Stellabit 不是交易所式的 C2C 市集,刻意不提供全站公開的報價看板。每個商戶自己建立自己的渠道、經營自己的客戶;客戶只看得到所屬商戶的渠道報價。渠道是商戶自己的人脈與信用關係,風險由商戶承擔,站主也不替渠道背書。
1.1 開戶與接入概覽
本節給商戶閱讀;站主請參考 /license。
在 Stellabit 開戶即擁有錢包(可充幣、提幣),不需審核。之後可自助產生 API Key,接上您的後端;也可用嵌入式 Widget 讓客戶在您的 App 或網站內買賣、充提。
接入步驟
- 1前往開戶頁建立商戶帳號(Email、密碼、2FA),開戶即有錢包
- 2登入商戶後台,自助產生 API Key;在「渠道管理」建立自己的渠道,並代渠道維護收款方式與報價
- 3後端以 API Key 換取客戶 Token 後,開啟 Widget 或呼叫 API;訂單的法幣收付由您在後台(或以 API)確認
1.2 錢包
商戶採預存制:開戶時系統同時建立您的錢包。您劃轉給客戶的資金一律從錢包餘額即時扣款,請先為錢包儲值再開始劃轉。
- 錢包儲值 — 在商戶後台取得充幣地址,走一般鏈上充幣流程(TRC-20 / BEP20 / ARB)即可為錢包加值
- 劃轉給客戶(from_platform)— 僅限您的後端以 API Key 發起,系統在同一筆交易內原子性「扣錢包 → 為客戶入帳」
- 錢包餘額不足 — 劃轉直接被拒絕(錯誤碼 INSUFFICIENT_PLATFORM_BALANCE),並發送 Webhook 通知您補款
- 客戶劃回商戶(to_platform)— 資金自動進入錢包餘額,並以 Webhook 通知您為客戶入帳
- 錢包提幣 — 僅限商戶本人登入後台操作(需通過 2FA),API Key 無法發起提幣
劃轉 API 的請求格式與錯誤碼詳見 開發者文件 的「商戶劃轉 API」章節。
1.3 商戶後台
每個商戶均有專屬的自助管理後台(Portal),無需聯繫站主即可自行管理設定。
開戶頁:https://stellabit.cc/register
登入頁:https://stellabit.cc/login- API Key — 僅供您的程式使用(不是登入憑證),可自助產生/重新產生;Webhook 簽章與代客戶呼叫 API 不變
- Webhook URL — 隨時修改,儲存後立即生效
- 測試 Webhook — 一鍵發送測試請求,確認 URL 可接收
- Webhook 紀錄 — 查看最近呼叫記錄,含狀態碼與成功/失敗
- 渠道管理 — 自己建立渠道(渠道不登入、沒有 Key),並代渠道維護收款方式、報價、查看該渠道訂單,按「已收到法幣/已付法幣」確認;暫停/解綁渠道亦在此操作
1.4 結算說明
商戶與渠道之間按站內軋差報表於站外日結對帳;商戶與站主之間的結算條款按合約約定。如有對帳需求請聯繫站主。
Stellabit — 使用指南