# 查詢訂單接口
**查詢接口URL:**
* `http://api.xx.com(請求平臺的域名.ps:對接的網關)/index/getorder`
使用方法:用表單post的方式,post參數并跳轉到此網址。
\*\* 請求方式:POST\*\*
說明:用curl的post方式傳參數,并直接獲取json返回值,顯示在您自定義的支付頁上。
**參數:**
| 參數名 | 必選 | 類型 | 說明 | 可用值 |
| --- | --- | --- | --- | --- |
| appid | 是 | string | 必填。您的商戶唯一標識 | 20180033 |
| out\_trade\_no | 是 | string | 商戶訂單號 | 2019022123352210133 |
| sign | 是 | string | 簽名算法 | 867073E09C4FFFF7B442CAB7CA4BC3B6 |
**注意:Token在安全上非常重要,一定不要顯示在任何網頁代碼、網址參數中。只可以放在服務端。計算sign時,先在服務端計算好,把計算出來的sign傳出來。嚴禁在客戶端計算sign,嚴禁在客戶端存儲Token。sign值必為小寫**
* * *
**參數示例(注意回調返回的是post數據,類似post表單提交,post接收即可)**
~~~
{
"code":200,
"msg":"獲取訂單成功",
"data":[
{
"out_trade_no":"2019022123352210133",
"amount":"5000.00",
"money":"4999.99",
"status":4,
"pay_time":"2019-02-21 23:35:55",
"callback_status":2,
"callback_url":"http://api.hocan.cn/index/ok.do"
}
]
}
~~~
**返回參數說明**
| 參數名 | 類型 | 說明 |
| --- | --- | --- |
| out\_trade\_no | string | 商戶的訂單號 |
| amount | string | 訂單的金額 |
| money | string | 訂單實付金額 |
| status | int | 訂單狀態 2:未支付 3:訂單超時 4:支付完成 |
| pay\_time | string | 支付時間 |
| callback\_status | string | 回調狀態 1 未回調 2 已回調 |
| callback\_url | string | 回調的地址 |
* 10000 傳參錯誤
* 20000 網站用戶錯誤
* 30000 簽名錯誤
* 40000 該用戶暫無訂單
* 50000 生成訂單錯誤
| 狀態碼 | 類型 | 說明 |
| --- | --- | --- |
| 10003 | 傳參錯誤 | 未傳入appid參數 |
| 10004 | 傳參錯誤 | 未傳入 out\_trade\_no 參數 |
| 10005 | 傳參錯誤 | 未傳入 sign 參數 |
| 20001 | 網站用戶錯誤 | 網站用戶不存在 |
| 20002 | 網站用戶錯誤 | 網站用戶狀態已禁止 |
| 20003 | 網站用戶錯誤 | 網站用戶狀態未審核 |
| 30000 | 簽名錯誤 | 簽名驗證失敗 |
| 40000 | 暫無訂單 | 該用戶暫無訂單 |