查询订单
按商户订单号查询一笔入金或出金订单。收到回调后用它复核,网络超时后也用它确认订单有没有建成。
POST
/api/open/order/getDetail完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
merchantNo | string | 是 | 商户号 |
merchantOrderNo | string | 是 | 你的商户订单号 |
只能查到自己商户的订单。先按入金单找,找不到再按出金单找。
返回
| 字段 | 类型 | 说明 |
|---|---|---|
orderState | int | 订单状态。入金见入金订单状态,出金见出金订单状态 |
orderStateText | string | 状态说明(英文) |
amount | number | 法币金额 |
currency | string | 法币代码 |
paymentMethod | string | 收款方式,如 BankPay;入金单还没分配收款账户时为空 |
payTime | string | 入金:客户付款时间;出金:处理完成时间 |
releaseTime | string | 入金:平台释放时间(出金没有这个字段) |
rate | number | 本单汇率 |
fees | number | 本单手续费(USDT) |
入金单和出金单的 orderState 含义不同,请按你自己记录的订单类型判断。
json
{
"code": 0,
"message": "success",
"data": {
"orderState": 6,
"orderStateText": "Released",
"amount": 100,
"currency": "CNY",
"paymentMethod": "BankPay",
"payTime": "2026-10-13 12:00:00",
"releaseTime": "2026-10-13 12:03:10",
"rate": 7.3,
"fees": 0.41
}
}加密货币充值订单
加密货币充值订单也用这个接口查(先查入金订单,查不到再查加密货币订单)。上面的字段照样返回:amount、currency 是下单时传的金额和币种,paymentMethod 是 USDT-TRC20 这种写法,payTime / releaseTime 是第一次入账时间,fees 是累计手续费。另外多一个 crypto 对象:
| 字段 | 类型 | 说明 |
|---|---|---|
crypto.orderNo | string | 平台订单号(CD 开头) |
crypto.payAddress | string | 本单收款地址 |
crypto.payNetwork | string | TRC20 / BEP20 |
crypto.payCoin | string | USDT / USDC |
crypto.payAmount | number | 应付币数量 |
crypto.receivedAmount | number | 累计到账的币数量 |
crypto.creditedAmount | number | 累计记入你余额的 USDT(扣手续费前) |
crypto.txHash | string | 第一笔到账的交易哈希 |
crypto.underpaid / crypto.overpaid | bool | 少付 / 多付 |
crypto.expireAt | string | 付款截止时间,UTC+8 |
json
{
"code": 0,
"message": "success",
"data": {
"orderState": 6,
"orderStateText": "Released",
"amount": 200,
"currency": "USDT",
"paymentMethod": "USDT-TRC20",
"payTime": "2026-10-21 12:05:40",
"releaseTime": "2026-10-21 12:05:40",
"rate": null,
"fees": 2,
"crypto": {
"orderNo": "CD20261021120000123456",
"payAddress": "T…",
"payNetwork": "TRC20",
"payCoin": "USDT",
"payAmount": 200,
"receivedAmount": 200,
"creditedAmount": 200,
"txHash": "…",
"underpaid": false,
"overpaid": false,
"expireAt": "2026-10-21 13:00:00"
}
}
}常见错误
| code | 说明 |
|---|---|
| 40000 | 没传商户订单号 |
| 40020 | 订单不存在 |