Query Order

Copy page

Query order API used for merchant/partner to query order status

EndPoint

Code
POST /binancepay/openapi/v2/order/query

Request Parameters

Attributes	Type	Required	Limitation	Description
prepayId	string	N	letter or digit, no other symbol allowed, can not be empty if merchantTradeNo is empty	Binance unique order id
merchantTradeNo	string	N	letter or digit, no other symbol allowed, can not be empty if prepayId is empty	The order id, Unique identifier for the request. Will be ignored if prepayId already provided

Sample Request Body

Query order result by merchantTradeNo:

Code
{
  "merchantTradeNo": "9825382937292"
}

Query order result by prepayId:

Code
{
  "prepayId": "9825382937292"
}

Response Parameters

Attributes	Type	Required	Limitation	Description
status	string	Y	"SUCCESS" or "FAIL"	status of the API request
code	string	Y	-	request result code, refer to
data	QueryOrderResult	N	-	response body, refer to
errorMessage	string	Y	-

Child Attribute

QueryOrderResult

Attributes	Type	Required	Limitation	Description
merchantId	long	Y	-	The merchant account id, issued when merchant been created at Binance.
prepayId	string	Y	-	unique id generated by binance
transactionId	string	N	-	issued once the payment is successful
merchantTradeNo	string	Y	letter or digit, no other symbol allowed, can not be empty if prepayId is empty	The order id, Unique identifier for the request
status	string	Y	"INITIAL", "PENDING", "PAID", "CANCELED", "ERROR", "REFUNDING", "REFUNDED", "FULL_REFUNDED", "EXPIRED"	order status
currency	string	Y	-	order currency
orderAmount	string	Y	limitation refer to Create Order API order amount	order amount
openUserId	string	N	-	Consumer unique id
passThroughInfo	string	N	-	pass through info, from the create order api
commission	string	N	-	Transaction fees charged. Please refer to your contract for more info
transactTime	long	N	-	Timestamp when transaction happened
createTime	long	Y	-	Timestamp when order was created
paymentInfo	object	N	-	payment information, refer to

PaymentInfo Data

Attributes	Type	Required	Limitation	Description
payerId	string	Y	-	payer pay id
payMethod	string	Y	-	pay method
paymentInstructions	list[PaymentInstruction]	Y	-	payment instruction list, refer to
channel	string	N	-	channel
subChannel	string	N	-	sub channel
payerDetail	string	N	-	encrypted payer identity information for merchant compliance purposes without compromising privacy and security. Decryption instructions please refer to. This function is only available for whitelisted merchants.

PaymentInstruction Data

Attributes	Type	Required	Limitation	Description
currency	string	Y	-	payment currency
amount	string	Y	-	currency amount
price	string	Y	-	currency price

Sample Response

Code
{
  "status": "SUCCESS",
  "code": "000000",
  "data": {
    "merchantId": 98729382672,
    "prepayId": "383729303729303",
    "transactionId": "23729202729220282",
    "merchantTradeNo": "9825382937292",
    "status": "PAID",
    "currency": "USDT",
    "orderAmount": "10.88",
    "openUserId": "",
    "passThroughInfo": "",
    "transactTime": 1425744000123,
    "createTime": 1425744000000,
    "paymentInfo": {
      "payerId": "100103455154",
      "payMethod": "funding",
      "paymentInstructions": [
        {
          "currency": "USDT",
          "amount": "10.88",
          "price": "1"
        }
      ],
      "channel": "DEFAULT"
    }
  },
  "errorMessage": ""
}

Result Code

Name	Code	Reason	Solution
UNKNOW_ERROR	400000	An unknown error occurred while processing the request.	Try again later
INVALID_REQUEST	400001	Parameter format is wrong or parameter transferring doesn't follow the rules.	Please check whether the parameters are correct.
INVALID_SIGNATURE	400002	Incorrect signature result	Check whether the signature parameter and method comply with signature algorithm requirements.
INVALID_TIMESTAMP	400003	Timestamp for this request is outside of the time window.	Sync server clock
INVALID_API_KEY_OR_IP	400004	API identity key not found or invalid.	Check API identity key
BAD_API_KEY_FMT	400005	API identity key format invalid.	Check API identity key.
MANDATORY_PARAM_EMPTY_OR_MALFORMED	400100	A parameter was missing/empty/null, or malformed.
INVALID_PARAM_WRONG_LENGTH	400101	A parameter was not valid, was empty/null, or too long/short, or wrong format.
INVALID_PARAM_WRONG_VALUE	400102	A parameter was not valid, the value is out of range.
INVALID_PARAM_ILLEGAL_CHAR	400103	A parameter was not valid, contains illegal characters
INVALID_REQUEST_TOO_LARGE	400104	Invalid request, content length too large
INVALID_MERCHANT_TRADE_NO	400201	merchantTradeNo is invalid or duplicated
ORDER_NOT_FOUND	400202	Order not found.
INVALID_ACCOUNT_STATUS	400203	Not support for this account, please check account status.