7. 訂單管理

7.訂單管理接口

7.1.創建訂單

當用戶申請購買時，調用該接口創建一個訂單。

• 請求
  /order/create?album_id=2

參數：
album_id 【必選】專輯（課程）編號，指明要購買哪個課程。

• 響應

          {
              "code": 0,
              "data": {
                  "count": 1,
                  "ts": 1530760164,
                  "items": [
                      {
                          "id": "5",
                          "name": "我的直播課",
                          "amount": "0.00",
                          "trade_no": "5-9996-6d2d",
                          "status": 2
                      }
                  ]
              }
          }

name 訂單名稱，購買內容的名稱
amount 要支付的總金額
trade_no 我方平臺的訂單號，提交給第三方支付系統。注意：在支付寶平臺中，以 out_trade_no 的參數名給支付寶平臺。
status 支付狀態，重要說明：
------如果 status值為0，表示訂單創建成功，可以提交支付平臺支付；
------如果status值為2，表示該用戶已經自動完成支付，原因可能是：課程免費、已經支付、其他優惠等，此時無需再向第三方支付平臺提交支付，直接返回購買成功即可。

創建訂單失敗時返回錯誤，如：

                {
                    "code": 4,
                    "err_desc": "缺少訂購內容參數"
                }

7.2.支付結果回調通知

當支付成功時，通過該接口進行通知，系統收到通知后更新訂單狀態。

• 請求
  阿里云回調接口
  /order/alipay

微信支付回調接口
/orders/wxpay

• 參數
  result 支付結果，數字2 或者字符串“SUCCESS”，表示支付成功；其他值表示支付失敗。
  trade_no 我方訂單編號
  third_trade_no 第三方支付平臺的訂單編號
  third_buyer_id 第三方支付平臺的支付用戶編號
  amount 支付金額

• 響應
  {
  "code": 0
  }

注意： 如果后臺返回錯誤，或者無響應，回調方要生成本地錯誤日志用于核查。

7.3.查詢一個訂單

• 請求
  /order/get

• 參數
  id 訂單編號
  trade_no 提交給第三方系統時的我方訂單號
  以上參數二選一。如果都給，忽略trade_no

• 響應

          {
              "code": 0,
              "data": {
                  "count": 1,
                  "ts": 1530765028,
                  "items": [
                      {
                          "id": "1",
                          "user_id": "1",
                          "puber_id": "1",
                          "album_id": "1",
                          "title": "我的直播課",
                          "user_name": "王小二",
                          "price": "0.00",
                          "amount": "0.00",
                          "servicer": null,
                          "trade_no": null,
                          "third_trade_no": null,
                          "third_buyer_id": null,
                          "pay_status": "0",
                          "add_time": "2018-07-05 10:57:18",
                          "pay_time": "2018-07-05 10:57:18"
                      }
                  ]
              }
          }

user_id 購買者id
puber_id 發布者id
album_id 課程id
title 課程標題
price 價格
amount 金額
servicer 支付平臺 1微信，2支付寶
trade_no 我方訂單號
third_buyer_id 支付平臺購買者編號
third_trade_no 支付平臺訂單號
pay_status 支付狀態 0 未支付；2 已支付； 4 支付錯誤
add_time 創建時間
pay_time 支付時間

7.4.查詢訂單列表

查詢老師或學生的訂單列表。
如果以老師身份登錄，查選售出的訂單；
如果以學生身份登錄，查詢購買的訂單。

• 請求
  /order/list

• 參數

album_id 專輯（課程）編號，忽略時請求全部。
time_para 時間參數，定義要查詢訂單的時間范圍：
0 今天
1 昨天
-7 最近7天的
-30 最近30天
30 30天前的

page 頁碼
page_size 分頁大小

返回同查詢一個訂單，只是返回內容可能有多個記錄。

7.5.查詢訂單匯總

查詢老師的所有成交訂單的匯總數據，已課程為匯總條件。
匯總時間截止到最近一個匯總時間點。

• 請求
  /order/sum

• 參數
  無

• 響應

      {
          "code": 0,
          "data": {
              "count": 3,
              "ts": 1531213233,
              "items": [
                  {
                      "album_id": "7",
                      "title": "測試點播",
                      "total": "0.01",
                      "timestamp": "2018-07-10 17:00:33"
                  },
                  {
                      "album_id": "2",
                      "title": "測試支付",
                      "total": "0.01",
                      "timestamp": "2018-07-10 17:00:33"
                  },
                  {
                      "album_id": "1",
                      "title": "測試支付",
                      "total": "0.02",
                      "timestamp": "2018-07-10 17:00:33"
                  }
              ]
          }
      }

  album_id 課程編號
  title 課程名
  total 總收入
  timestamp 統計截止時間