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

Common errors ​

codeDescription
40000Merchant order number missing
40020Order not found