查詢訂單狀態
GET
/cash/v1/merchant/exchange/orders/{orderId} 鑑權: API Key（Bearer）exchange:read回傳訂單的即時狀態。讀取會觸發上游狀態的節流同步（最多每 10 秒一次），因此每 10 秒輪詢一次即可。
狀態模型
status | 含義 |
|---|---|
pending | 等待你的入金 |
processing | 已見入金；確認中 / 兌換中 / 發送中 |
completed | 已出金；deliveryTxHash 已回填 |
expired | expiresAt 前未入金；若過期後仍有款項到帳，訂單會轉為 reconciliation_required |
failed | 兌換未能完成；退款按訂單頁顯示的規則處理 |
reconciliation_required（orderStatus: MANUAL_REVIEW） | 已收到款項但需人工處理（如過期後才付款、金額不符）；請勿再次轉帳——我們核對後繼續兌換或退款，可憑訂單號聯繫客服 |
providerStatus 為更細的處理階段（、、、、 等）， 為入金鏈上確認數。
參數
| 名稱 | 位置 | 類型 | 必填 | 說明 |
|---|---|---|---|---|
| orderId | path | string | 是 | 建單回傳的訂單 id 或訂單號。 |
回應範例
{
"ok": true,
"code": 200,
"message": "OK",
"data": {
"orderId": "order_6b1e6d3d-…",
"status": "completed",
"orderStatus": "COMPLETED",
"providerStatus": "done",
"paymentAddress": "0x9a1f…c3e2",
"paymentAmount": "50",
"paymentTxHash": "0x3c5e…9d1a",
"deliveryTxHash": "7f0b…e4c2",
"actualFromAmount": "50",
"actualToAmount": "145.02",
"payinConfirmations": 15,
"completedAt": 1789305412000,
"feeBreakdown": {
"total": "0.728715",
"currency": "TRX",
"totalPercentage": "1.00"
}
}
}程式碼範例
cURL
curl -X GET 'https://api.moin.cash/cash/v1/merchant/exchange/orders/<orderId>' \
-H 'Authorization: Bearer ck_live_xxxxxxxxxxxxxxxx'線上除錯
除錯請求經官網發往與你的串接相同的閘道。請使用沙箱 Key（ck_test_…）：報價是合成的、訂單是模擬的；正式 Key 會建立真實報價與真實訂單。