API說明

API位置 /new_ez_order/orders/get_payment_order?ez_trans_master_id={ez_trans_master_id}
需求描述 查詢銀行訂單
傳輸物件格式 json
方法 GET

範例

curl -X GET \
-H "X-Ftcsys-key: {KEY}" \
-H "X-Accept-Language: {language}" \
-H "Content-Type: application/json" \
https://{endpoint}/new_ez_order/orders/get_payment_order?ez_trans_master_id={ez_trans_master_id}

回傳範例

< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
  "result": {
    "total_pages": 6,
    "total_records": 60,
    "page": 1,
    "list": [
      {
        "ez_payment_order_master_id": "445b11d533524dcb8a836f4407c8bdfc",
        "ez_trans_master_id": "445b11d533524dcb8a836f4407c8bdfc",
        "ez_foreign_trans_id": "TEST2017122200001",
        "payment_channel_id": 27,
        "bank_trans_id": "022a45f3450c4971b79fd0f2c6fca1d6",
        "payment_type": 1,
        "store_code": "270001",
        "ez_payment_order_status": 1,
        "authorization_code": "N123ABC",
        "price_sum": 800,
        "point_sum": 800,
        "ez_member_point_sum": 1000,
        "refund_price_sum": 40,
        "refund_point_sum": 50,
        "refund_ez_member_point_sum": 2,
        "capture_time": 1504180800000,
        "refund_time": 1504180800009,
        "product_price_detail_id": "022a45f3450c4971b79fd0f2c6fca1d7",
        "card_num": 4566,
        "created_time": 1504137600000,
        "account_flag": 1,
        "payment_order_detail": [
          {
            "ez_payment_order_detail_id": "022a45f3450c4971b79fd0f2c6fca1d8",
            "bank_trans_detail_id": "022a45f3450c4971b79fd0f2c6fca189",
            "product_code": "UB87654321",
            "product_status": 1,
            "quantity": 1,
            "refund_quantity": 0,
            "price": 400,
            "point": 20,
            "ez_member_point": 20,
            "redund_price": 20,
            "refund_point": 0,
            "refund_ez_member_point": 0
          }
        ]
      }
    ]
  },
  "local_return": 233,
  "code": 200,
  "status": "success"
}

HTTP回應碼 result 說明
200 "" 查詢成功
403.107 "" 參數錯誤
401.105 "" ez訂交易編號不可為空
404.109 "" ez訂交易編號不存在
404.114 "" 查無訂單

接收參數

參數 名稱 範例 必填 備註
ez_trans_master_id ez訂交易id 445b11d533524dcb8a836f4407c8bdfc Y

回傳json參數

參數 名稱 範例 必填 備註
total_pages 總頁數 2 Y
total_records 總筆數 20 Y
page 所在頁數 1 Y
list 訂單資料
ez_payment_order_master_id ez訂付款方訂單主檔id 445b11d533524dcb8a836f4407c8bdfc Y
ez_trans_master_id ez訂交易id 445b11d533524dcb8a836f4407c8bdfc Y
ez_foreign_trans_id ez訂付款方訂單編號 TEST2017122200001 Y
payment_channel_id 付款方代碼 27 Y
bank_trans_id 付款方交易id 022a45f3450c4971b79fd0f2c6fca1d6 Y
payment_type 交易類型 1 Y 1:點數、2:純金、3:點加金、4:coupon
store_code 特店代碼 270001 Y
ez_payment_order_status 付款方訂單狀態 1 Y 請詳備註一
authorization_code 授權碼 N123ABC N
price_sum 總金額 800 Y
point_sum 付款方總紅利點 800 N
ez_member_point_sum ez訂會員總紅利點 1000 N
refund_price_sum 退貨總金額 0 N
refund_point_sum 退貨付款方紅利總點數 0 N
refund_ez_member_point_sum 退貨ez訂會員紅利總點數 0 N
capture_time 請款時間 1504180800000 N
refund_time 退貨時間 1504180800009 N
product_price_detail_id 價格id 022a45f3450c4971b79fd0f2c6fca1d7 Y
card_num 卡號 4566 N
created_time 建立時間 1504137600000 Y
account_flag 帳務處理註記狀態 1 Y 1:已關帳、0:未關帳
payment_order_detail 付款方訂單明細 Y
ez_payment_order_detail_id 付款方訂單明細id 022a45f3450c4971b79fd0f2c6fca1d8 Y
bank_trans_detail_id 付款方交易明細id 022a45f3450c4971b79fd0f2c6fca189 N
product_code 商品代碼 UB87654321 N
product_status 商品狀態 1 Y 1:成功、0:失敗、2:退貨、3:部分退貨
quantity 數量 1 N
refund_quantity 退貨數量 0 N
price 金額 800 Y
point 付款方紅利點 400 N
ez_member_point ez訂會員紅利點 500 N
refund_price 退貨金額 0 N
refund_point 銀行紅利點退貨點數 0 N
refund_ez_member_point ez訂會員紅利點退貨點數 0 N

備註一：

1:成功

2:由user取消訂單成功

20:取消授權成功(對應到r舊訂單的banking_status狀態40)

21:取消授權失敗

22:已送出取消授權請求(對應到r舊訂單的banking_status狀態41)

3由user取消訂單失敗

4:由系統人員取消訂單成功

5:由系統人員取消訂單失敗

30:請款成功

31:請款失敗

32:待請款-已送出請款檔

40:取消請款成功

41:取消請款失敗

52:待退貨-已送出退貨檔(對應到r舊訂單的banking_status狀態52)

60:取消退貨成功

61:取消退貨失敗

70:已入帳

80:已關帳

results matching ""

    No results matching ""