建立情境
請將訂單、工作階段、證據或代理任務，與付款事實分開描述。
在不接管錢包的情況下請求付款。
建立標準的 Payment Request，附上商務情境，讓客戶在本機審查並簽署，再透過一致的狀態模型追蹤結果。
Official Testnet integration is open for supported flows. Mainnet settlement, commercial pricing, and service-level commitments are not offered.
更清楚的界線
由您的系統提出請求，由客戶的錢包做決定。
VelarumPay 明確區分商家系統、代理系統與錢包簽署責任。
請求付款
傳送精確的金額、資產、網路、收款方、到期時間與 idempotency key。
使用者核准
客戶會先審查風險與交易事實，再於自己的裝置上簽署。
觀察狀態
您的整合可以讀取可確定的狀態與事件，但不會取得簽署權限。
整合路徑
一種 protocol，多種連接方式。
選擇適合您應用程式的介面。所有受支援的路徑都會匯聚到 velarum.payment_request.v1.
直接整合 Platform API。
請使用已發布的 OpenAPI 契約處理配對、連線、交易情境、Payment Requests、狀態與事件。伺服器端服務會驗證範圍、到期時間、精確金額與冪等性。
使用圍繞相同契約的 typed helpers。
JavaScript SDK 將配對、驗證、建立情境、建立 Payment Request 與狀態輪詢封裝成較精簡的用戶端介面。API 與 JSON Schema 仍是唯一準據。
提供代理請求工具，但絕不提供錢包金鑰。
MCP server 與 connectors 刻意只提供一組精簡工具，用於配對、建立情境、請求付款與讀取狀態。它們不能核准、簽署、匯出金鑰，也不能繞過錢包審查。
Official Testnet 適用情境
從控制模型最重要的地方開始。
受支援的整合應具有明確的使用者、請求方、付款原因和可測試的核准流程。
商家結帳
從訂單流程評估錢包配對與付款請求，而不需讓商家處理使用者金鑰。
受信任應用程式
連接需要使用者核准付款與可稽核狀態、但不具託管權限的軟體。
AI 代理工作流程
讓本機或代管代理提出購買建議，同時保留可確定的驗證與人工核准。
您的整合必須保留的重點
清楚的事實、有限的範圍與可觀察的狀態。
良好的整合應讓錢包使用者容易核對請求，也讓您的團隊容易診斷結果。
- 精確的小數金額字串與明確的資產識別
- 網路、收款方、手續費、到期時間與冪等性控制
- 交易情境與不可變更的付款事實分開呈現
- 範圍僅限於您的應用程式實際需要的能力
- 安全處理連線 tokens 與可確定的錯誤狀態
- 您的服務中不得包含私鑰、助記詞或簽署資料
Official Testnet integration support
Tell us what you want to integrate.
Share your use case, integration surface, intended user approval flow, and test environment. This support request does not grant mainnet or commercial production access.
不得包含敏感資料請勿包含 API 金鑰、錢包地址、助記詞、私鑰、正式環境客戶資料或簽署資料。