7. 訂單管理

7.訂單管理接口

7.1.創(chuàng)建訂單

當(dāng)用戶申請購買時(shí)，調(diào)用該接口創(chuàng)建一個(gè)訂單。

• 請求
  /order/create?album_id=2

參數(shù)：
album_id 【必選】專輯（課程）編號(hào)，指明要購買哪個(gè)課程。

• 響應(yīng)

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

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

創(chuàng)建訂單失敗時(shí)返回錯(cuò)誤，如：

                {
                    "code": 4,
                    "err_desc": "缺少訂購內(nèi)容參數(shù)"
                }

7.2.支付結(jié)果回調(diào)通知

當(dāng)支付成功時(shí)，通過該接口進(jìn)行通知，系統(tǒng)收到通知后更新訂單狀態(tài)。

• 請求
  阿里云回調(diào)接口
  /order/alipay

微信支付回調(diào)接口
/orders/wxpay

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

• 響應(yīng)
  {
  "code": 0
  }

注意： 如果后臺(tái)返回錯(cuò)誤，或者無響應(yīng)，回調(diào)方要生成本地錯(cuò)誤日志用于核查。

7.3.查詢一個(gè)訂單

• 請求
  /order/get

• 參數(shù)
  id 訂單編號(hào)
  trade_no 提交給第三方系統(tǒng)時(shí)的我方訂單號(hào)
  以上參數(shù)二選一。如果都給，忽略trade_no

• 響應(yīng)

          {
              "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 發(fā)布者id
album_id 課程id
title 課程標(biāo)題
price 價(jià)格
amount 金額
servicer 支付平臺(tái) 1微信，2支付寶
trade_no 我方訂單號(hào)
third_buyer_id 支付平臺(tái)購買者編號(hào)
third_trade_no 支付平臺(tái)訂單號(hào)
pay_status 支付狀態(tài) 0 未支付；2 已支付； 4 支付錯(cuò)誤
add_time 創(chuàng)建時(shí)間
pay_time 支付時(shí)間

7.4.查詢訂單列表

查詢老師或?qū)W生的訂單列表。
如果以老師身份登錄，查選售出的訂單；
如果以學(xué)生身份登錄，查詢購買的訂單。

• 請求
  /order/list

• 參數(shù)

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

page 頁碼
page_size 分頁大小

返回同查詢一個(gè)訂單，只是返回內(nèi)容可能有多個(gè)記錄。

7.5.查詢訂單匯總

查詢老師的所有成交訂單的匯總數(shù)據(jù)，已課程為匯總條件。
匯總時(shí)間截止到最近一個(gè)匯總時(shí)間點(diǎn)。

• 請求
  /order/sum

• 參數(shù)
  無

• 響應(yīng)

      {
          "code": 0,
          "data": {
              "count": 3,
              "ts": 1531213233,
              "items": [
                  {
                      "album_id": "7",
                      "title": "測試點(diǎn)播",
                      "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 課程編號(hào)
  title 課程名
  total 總收入
  timestamp 統(tǒng)計(jì)截止時(shí)間