查询订单状态
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 会创建真实报价与真实订单。