## query_order（查詢訂單）
| 接口地址 | 接口名稱 |
| --- | --- |
| 平臺域名/api/query_order | 查詢訂單 |
| 請求方式 | 字符編碼 | 響應數據格式 | 商戶身份驗證 |
| --- | --- | --- | --- |
| GET/POST | UTF-8 | JSON | 是 |
* 請求參數
| 參數名 | 類型 | 名稱 | 必填 | 示例 | 描述 | 系統版本號 |
| --- | --- | --- | --- | --- | --- | --- |
| out_trade_no| string | 系統訂單號 | 否 | XY20210819155352820192199 | out_trade_no或api_trade_no至少傳入一個 | 1.3+ |
| api_trade_no | string | 接口訂單號 | 否 | 4200001180202108191793854834 | out_trade_no或api_trade_no至少傳入一個 | 1.3+ |
* 響應參數
| 參數名 | 類型 | 名稱 | 必填 | 示例 | 描述 | 系統版本號 |
| --- | --- | --- | --- | --- |--- |--- |
| code | int | 返回碼 | 是 | 0 | 除0以外的值都為失敗，詳情見[公共返回碼](公共返回碼.md) | 1.3+ |
| msg | string | 提示信息 | 是 | 成功 | 具體提示信息以實際返回為準 | 1.3+ |
| data| array| 訂單信息 | 是 | 具體參數見1.1表 | 訂單的信息的數組數據 | 1.3+ |
* 參數名：data（1.1）：
| 參數名 | 類型 | 名稱 | 必填 | 示例 | 描述 | 系統版本號 |
| --- | --- | --- | --- | --- |--- |--- |
|uid| string | 商戶UID | 是 | 94001 | 訂單歸屬商戶的UID | 1.3+ |
|out_trade_no| string | 系統訂單號 | 是 | XY20210819155352820192199 | ... | 1.3+ |
|api_trade_no| string | 接口訂單號 | 是 | 4200001180202108191793854834 | ... | 1.3+ |
|type| string | 支付方式 | 是 | alipay | ... | 1.3+ |
|money| string |支付金額 | 是 | 1.00| ... | 1.3+ |
|name| string |支付商品名稱 | 是 | 聚合收銀臺-測試支付 | ... | 1.3+ |
|creation_time| string |訂單創建時間 | 是 | 2021-10-21 00:00:00 | ... | 1.3+ |
|payment_time | string |訂單支付時間 | 是 | 2021-10-21 00:00:00 | 未支付將為null | 1.3+ |
|remarks| string |訂單備注信息 | 是 | 聚合收銀臺 | 付款時填寫的訂單備注，沒有備注則為null | 1.3+ |
|refund_money| string |已退款金額 | 是 | 1.00 | 未退款將為0.00 | 1.3+ |
|refund_time| string |退款時間 | 是 | 2021-10-21 00:00:00 | 未退款將為null | 1.3+ |
|ip| string |IP地址 | 是 | 127.0.0.1 | 用戶支付IP | 1.3+ |
|buyer| string |用戶標識 | 是 | 2088722372306754 | 如支付寶用戶ID等。但因接口的多樣性，部分接口沒有用戶標識，則可能會返回null | 1.3+ |
|state| int |訂單狀態 | 是 | 1 | 詳見[訂單狀態列表](訂單狀態列表.md) | 1.3+ |
