# 訂單查詢接口
* * *
用來主動查詢訂單是否支付成功,一般情況只用支付接口即可。如果您服務器中斷了一段時間,可以用這個接口,快速獲取中斷時期的訂單的支付狀態。注意:此接口不能頻繁查詢,一個訂單30秒只能查詢一次
##### 接口URL:
~~~
http://xxx.com/pay/merchant/query
~~~
##### 傳參方式:POST
* * *
##### 請求參數:
| # | 參數名 | 含義 | 類型 | 說明 |
| --- | --- | --- | --- | --- |
| 1 | merchantno | 商戶號 | string(24) | 必填。您的商戶唯一標識,注冊后在設置里獲得。一個24位字符串 |
| 2 | orderno | 商戶自定義訂單號 | string(50) | 必填。 |
| 3 | sign | 秘鑰 | string(32) | 必填。按順序拼接:merchantno=12&orderno=xxx&key=token(商戶密鑰),取MD5-32位加密后的值,轉大寫。 |
**注意:token(商戶密鑰) 在安全上非常重要,一定不要顯示在任何網頁代碼、網址參數中。只可以放在服務端。計算key時,先在服務端計算好,把計算出來的key傳出來。嚴禁在客戶端計算key,嚴禁在客戶端存儲token(商戶密鑰)。**
#### 返回值(Json字符串)
* * *
##### 參數內容:
~~~
{
"success": true, //是否成功
"message": "ok", //提示文字信息,成功失敗。
"data": {
"orderid": "101808182019641",//單號
"status": 1, //狀態:0 等待支付;1 已支付,2:過期(超過5分鐘未支付,如果客戶正常付款,訂單還是會更新為已支付)
"is_callback":true,//回調狀態
"order_time": "2018-08-18T05:36:39", //訂單時間
"pay_time": "2018-08-18T05:36:54",//支付時間
"price": 200,//金額
"fee": 5//手續費
},
"code": 0
}
~~~