StableOps
API 參考

查詢退款列表

查詢目前組織與環境中的 StableOps 退款記錄，可按付款訂單和退款狀態篩選，並透過分頁檢視申請、已提交、已確認、失敗或取消的退款。介面適合客服追蹤處理進度、財務核對剩餘退款額度，以及運維發現長期未完成的鏈上退款任務。

GET/v1/refunds

Authorization

bearerAuth
AuthorizationBearer <token>

Paste your API key from the dashboard.

In: header

Query Parameters

offset?number
limit?number
status?string
payment_order_id?string

Response Body

application/json

curl -X GET "https://example.com/v1/refunds"
{
  "items": [
    {
      "id": "string",
      "payment_order_id": "string",
      "source_payment_event_id": "string",
      "chain": "ethereum",
      "asset": "USDC",
      "amount": "string",
      "amount_minor": "string",
      "source_address": "string",
      "destination_address": "string",
      "status": "requested",
      "tx_hash": "string",
      "failure_reason": "string",
      "submitted_at": "2019-08-24T14:15:22Z",
      "confirmed_at": "2019-08-24T14:15:22Z",
      "canceled_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "has_more": true,
  "total": 0
}

這篇文件怎麼樣？

最後更新

建立非託管退款請求 POST

為已最終完成的 StableOps 付款訂單建立非託管退款請求，指定精確退款金額和客戶確認的目標地址。介面沿用原始收款的鏈、資產與來源地址，校驗剩餘可退款額度並生成待簽名記錄，資金仍由商戶錢包控制，適合接入客服審批與資金操作流程。

查詢退款 GET

按退款標識查詢一筆 StableOps 退款的完整記錄，包括原始支付事件、鏈、資產、退款金額、來源與目標地址、交易雜湊、目前狀態、失敗原因和關鍵時間。介面適合退款詳情頁、客服調查、財務稽核與鏈上對帳流程讀取權威狀態。