從金鑰到第一筆付款.
建立 API 金鑰
在 Moove Business 中為 Moove Receive Agent 建立金鑰。金鑰只會顯示一次，請立即存入您的環境變數。建立付款連結
一次 POST 即回傳結帳 URL。客戶在該頁面用任意鏈上的任意代幣付款。付款即時通知
註冊一個 HTTPS 端點，連結一旦付款，Moove 會立即向其傳送簽名事件。
API 精簡，保障可靠.
任意代幣付款，結算為您的代幣
客戶用手中持有的資產付款，涵蓋 30+ 區塊鏈網路。每筆付款都會以您選擇的代幣和鏈結算到您的錢包。可放心建構的 API 契約
版本號寫在路徑中，v1 只做新增，並提供即時更新的 OpenAPI 規格。限制清晰，錯誤明確
按金鑰和 IP 限流，超限回傳簡單的 429，統一的錯誤格式搭配穩定的錯誤碼。API 本身不收費.
無訂閱費，也不按呼叫次數收費。客戶若用其他代幣或鏈付款，由其承擔 0.02%，您可全額到帳。- API 存取
- 免費
- 同一代幣、同一網路
- 免費
- 跨代幣或跨網路
- 0.02%
Moove 與自行開發比較.
| Moove 與自行開發比較。 | Moove | 自行開發 |
|---|---|---|
| 支援的鏈 | Moove: 30+ 條鏈，一個端點搞定 | 自行開發: 每條鏈單獨整合 |
| 轉換為您的代幣 | Moove: 每筆付款均已內建 | 自行開發: 自建兌換與跨鏈橋路由 |
| 確認款項到帳 | Moove: 簽名 Webhook 和列表端點 | 自行開發: 每條鏈都要自行執行監聽服務 |
| 結帳頁面 | Moove: 託管連結，隨時分享 | 自行開發: 自行設計、開發和託管 |
| 如果金鑰外洩 | Moove: 只能發起向您付款的請求 | 自行開發: 熱錢包裡的全部資產 |
常見問題.
如何取得 API 金鑰？
登入 Moove Business 控制台，開啟「API 金鑰」。為金鑰命名並選擇 Moove Receive Agent，它會授予建立和讀取付款連結的權限。完整金鑰只在建立時顯示一次，之後不會再顯示，請將其存入密鑰管理工具。沒有用於建立金鑰的端點，因此一個金鑰永遠無法簽發另一個金鑰。
客戶付款後，資金去哪裡？
進入金鑰擁有者的預設錢包，使用該錢包的鏈和結算代幣。呼叫方無法指定其他收款地址。因此，首次呼叫前，帳戶需要已註冊的 Moove handle，以及設定了結算代幣的預設錢包；缺少任一項，建立連結都會回傳 409，提示帳戶尚未準備好收款。
有出款 API 嗎？
暫時沒有。該 API 只收款，不付款。如需立即向供應商或承包商付款，請使用 Moove Business 控制台中的「發送」。Moove Send Agent 已經發布預告，上線後將出現在文件中。
Moove Webhook 如何運作？
在控制台中最多可註冊五個 HTTPS 端點。每個端點接收兩種事件：一種在某個連結的付款結算時傳送，另一種在連結完成時傳送。推送使用僅顯示一次的密鑰，以 HMAC-SHA256 簽名。推送保證至少送達一次，請依事件 ID 去重。推送失敗後最多重試六次。
有速率限制嗎？
有。請求按 API 金鑰和來源 IP 分別限流，以先達到的上限為準，超限回傳 429。被拒絕的請求同樣計數，因此不要立即重試，而應採用帶隨機抖動的指數退避。請透過 Webhook 取得付款狀態，而不是輪詢單一連結；如果多個整合共用一台主機，請按 IP 上限規劃請求量。
API 如何進行版本管理？
版本號寫在路徑中。目前只有一個公開版本：v1。同一版本內的變更只做新增：新端點、新的選填欄位、新的回應欄位。任何可能導致用戶端出錯的變更，例如刪除欄位或變更型別，都會以新的路徑版本發布。請讓用戶端忽略未知欄位，並依據錯誤碼而非錯誤訊息進行分支處理。
