ovahubGETBearer 權杖
查詢付款狀態
/api/v1/payments/:id
查詢付款請求及其訂單或儲值結果。
呼叫前請注意
鏈上或供應商結果尚未確定時，請持續查詢同一筆付款請求。不要再次付款或更換 requestKey。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
cURL
curl "https://tovahub.com/api/v1/payments/507f1f77bcf86cd799439012" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例，此頁不會發送 API 請求。
回應示例
JSON
{
"id": "507f1f77bcf86cd799439011",
"purpose": "order",
"amount": "1200",
"asset": "USD",
"state": "quoted",
"mode": null,
"expiresAt": "2026-11-07T12:30:00.000Z",
"transactionHash": null,
"network": null,
"result": null,
"error": null
}參數
id路徑 · 必填string
資源 ID：24 個十六進位字元。請使用對應列表端點回傳的平台 ID，而非供應商的執行個體 ID。
回應
HTTP 狀態 200
讀取組織現有付款意圖目前的持久化狀態。
idstring (ObjectId)付款意圖識別碼，同時也是報價識別碼。
purposestring意圖用途。目前公開建立流程使用 order 或 deposit；儲存值也可能是 renew，但不代表目前支援續約。
amountstring以美分表示的整數金額。
assetstring ('USD')平台記帳資產。
statestring ('quoted' | 'authorized' | 'broadcast' | 'settled' | 'applied' | 'failed')持久化的付款意圖狀態。
modestring ('balance' | 'x402') | null選定的付款資金來源模式，選定前為 null。
expiresAtstring (ISO 8601)報價到期時間。即使超過此時間，已接受的資金仍須完成核對處理。
transactionHashstring | null區塊鏈交易雜湊值（若有）。
networkstring | null付款網路（若有）。
resultunknown | null依用途持久化的處理結果，未定義通用的巢狀回應格式。
errorstring | null持久化的付款錯誤（若有）。