ovahubPOSTBearer 權杖
使用團隊 USD 購買報價
/api/v1/orders/buy
僅使用權杖固定團隊的 USD 餘額購買自己建立且未過期的訂單報價。成功回傳 HTTP 202 與 applied/balance 付款意圖，不代表伺服器已交付。重試同一報價會回傳原結果。
呼叫前請注意
API 購買預設關閉。請先以團隊既有且尚未回收的伺服器關聯工單，申請由管理員為指定權杖開通。USD 不足回傳 409；不轉用 x402、儲值、xTOVA 或佣金。結果不明時保留原報價 ID，查詢 get_payment 與 get_order。MCP 購買不受此開關限制。其他及新權杖不會繼承權限。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
cURL
curl "https://tovahub.com/api/v1/orders/buy" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"id": "507f1f77bcf86cd799439011"
}'僅提供範例，此頁不會發送 API 請求。
回應示例
JSON
{
"id": "507f1f77bcf86cd799439011",
"purpose": "order",
"amount": "1200",
"asset": "USD",
"state": "applied",
"mode": "balance",
"expiresAt": "2026-11-07T12:30:00.000Z",
"transactionHash": null,
"network": null,
"result": {
"_id": "507f1f77bcf86cd799439012",
"status": "pending"
},
"error": null
}參數
idJSON 請求主體 · 必填string
quote_vps_order 回傳的報價／付款意圖 ID，必須為 24 個十六進位字元。僅原報價建立者可在同一固定團隊內購買，不得傳送其他欄位。
回應
HTTP 狀態 202
重試會回傳同一筆已受理訂單的結果。受理不代表伺服器已交付。
idstring (ObjectId)付款意圖識別碼，同時也是報價識別碼。
purpose"order"意圖用途。目前公開建立流程使用 order 或 deposit；儲存值也可能是 renew，但不代表目前支援續約。
amountstring以美分表示的整數金額。
assetstring ('USD')平台記帳資產。
state"applied"持久化的付款意圖狀態。
mode"balance"選定的付款資金來源模式，選定前為 null。
expiresAtstring (ISO 8601)報價到期時間。即使超過此時間，已接受的資金仍須完成核對處理。
transactionHashnull區塊鏈交易雜湊值（若有）。
networknull付款網路（若有）。
resultunknown | null依用途持久化的處理結果，未定義通用的巢狀回應格式。
errornull持久化的付款錯誤（若有）。