Skip to content

查询订单 ​

按商户订单号查询一笔入金或出金订单。收到回调后用它复核,网络超时后也用它确认订单有没有建成。

POST/api/open/order/getDetail

完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。

请求参数 ​

参数类型必填说明
merchantNostring是商户号
merchantOrderNostring是你的商户订单号

只能查到自己商户的订单。先按入金单找,找不到再按出金单找。

返回 ​

字段类型说明
orderStateint订单状态。入金见入金订单状态,出金见出金订单状态
orderStateTextstring状态说明(英文)
amountnumber法币金额
currencystring法币代码
paymentMethodstring收款方式,如 BankPay;入金单还没分配收款账户时为空
payTimestring入金:客户付款时间;出金:处理完成时间
releaseTimestring入金:平台释放时间(出金没有这个字段)
ratenumber本单汇率
feesnumber本单手续费(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.orderNostring平台订单号(CD 开头)
crypto.payAddressstring本单收款地址
crypto.payNetworkstringTRC20 / BEP20
crypto.payCoinstringUSDT / USDC
crypto.payAmountnumber应付币数量
crypto.receivedAmountnumber累计到账的币数量
crypto.creditedAmountnumber累计记入你余额的 USDT(扣手续费前)
crypto.txHashstring第一笔到账的交易哈希
crypto.underpaid / crypto.overpaidbool少付 / 多付
crypto.expireAtstring付款截止时间,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订单不存在