Skip to content

Get order ​

Looks up a pay-in or payout order by your merchant order number. Use it to verify callbacks and to check whether an order was created after a timeout.

POST/api/open/order/getDetail

Full URL = your API base URL + this path. The base URL is shown in the merchant console under Developers → API & callbacks.

Request parameters ​

ParameterTypeRequiredDescription
merchantNostringYesMerchant number
merchantOrderNostringYesYour order number

Only your own orders are found. Pay-in orders are searched first, then payouts.

Response ​

FieldTypeDescription
orderStateintOrder state: see pay-in states or payout states
orderStateTextstringState description
amountnumberFiat amount
currencystringCurrency code
paymentMethodstringPayment method, e.g. BankPay; empty for a pay-in before an account is assigned
payTimestringPay-in: when the customer paid; payout: when it finished
releaseTimestringPay-in only: when the platform released the order
ratenumberRate applied to this order
feesnumberFee for this order (USDT)

orderState means different things for pay-ins and payouts — use the order type you recorded.

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
  }
}

Crypto deposit orders ​

Crypto deposit orders are queried with this endpoint as well (pay-in orders are looked up first, then crypto orders). The fields above are returned as usual: amount and currency are what you sent when creating the order, paymentMethod is written like USDT-TRC20, payTime / releaseTime are the time of the first credit, and fees is the total fee so far. There is also a crypto object:

FieldTypeDescription
crypto.orderNostringPlatform order number (starts with CD)
crypto.payAddressstringDeposit address of this order
crypto.payNetworkstringTRC20 / BEP20
crypto.payCoinstringUSDT / USDC
crypto.payAmountnumberAmount of coins due
crypto.receivedAmountnumberTotal coins received so far
crypto.creditedAmountnumberTotal USDT credited to your balance so far (before fees)
crypto.txHashstringTransaction hash of the first transfer
crypto.underpaid / crypto.overpaidboolUnderpaid / overpaid
crypto.expireAtstringPayment deadline, 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"
    }
  }
}

Common errors ​

codeDescription
40000Merchant order number missing
40020Order not found