API說明
API位置 | /new_ez_order/orders/update_ez_payment_order |
---|---|
需求描述 | 更新付款方訂單 |
傳輸物件格式 | json |
方法 | PUT |
範例
curl -X PUT \
-H "X-Ftcsys-key: {KEY}" \
-H "X-Accept-Language: {language}" \
-H "Content-Type: application/json" \
-d '{
"ez_payment_order_master_id": "445b11d533524dcb8a836f4407c8bdfc",
"bank_trans_id": "022a45f3450c4971b79fd0f2c6fca1d6",
"ez_payment_order_status": 1,
"capture_time": 1504180800000,
"refund_time": 1504180800009,
"modifier": "ez_job",
"payment_order_detail": [
{
"ez_payment_order_detail_id": "022a45f3450c4971b79fd0f2c6fca1d8",
"bank_trans_detail_id": "022a45f3450c4971b79fd0f2c6fca189",
"product_status": 1,
"refund_quantity": 0,
"redund_price": 20,
"refund_point": 0,
"refund_ez_member_point": 0
}
]
}
https://{endpoint}/new_ez_order/orders/update_ez_payment_order
回傳範例
< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
"result": {
"ez_payment_trans_master_id": "445b11d533524dcb8a836f4407c8bdfc"
},
"local_return": 23,
"code": 200,
"message": "交易成功",
"status": "success"
}
HTTP回應碼 | 結果 | 說明 |
---|---|---|
401.117 | "" | 付款方訂單編號不可為空 |
404.006 | "" | 訂單不存在 |
403.999 | "" | 參數錯誤 |
接收參數
參數 | 名稱 | 範例 | 必填 | 備註 |
---|---|---|---|---|
ez_payment_order_master_id | ez訂付款方訂單主檔id | 445b11d533524dcb8a836f4407c8bdfc | Y | |
bank_trans_id | 付款方交易id | 022a45f3450c4971b79fd0f2c6fca1d6 | Y | |
ez_payment_order_status | 付款方訂單狀態 | 1 | Y | 請詳備註一 |
capture_time | 請款時間 | 1504180800000 | N | |
refund_time | 退貨時間 | 1504180800009 | N | |
modifier | 更新主 | ez_job | Y | ez訂排程:ez_job、後台user:user帳號、帳務排程:account_job,陸續新增 |
payment_order_detail | 付款方訂單明細 | Y | ||
ez_payment_order_detail_id | 付款方訂單明細id | 022a45f3450c4971b79fd0f2c6fca1d8 | Y | |
bank_trans_detail_id | 付款方交易明細id | 022a45f3450c4971b79fd0f2c6fca189 | N | |
product_status | 商品狀態 | 1 | Y | 1:成功、0:失敗、2:退貨、3:部分退貨 |
refund_quantity | 退貨數量 | 0 | N | |
refund_price | 退貨金額 | 0 | N | |
refund_point | 銀行紅利點退貨點數 | 0 | N | |
refund_ez_member_point | ez訂會員紅利點退貨點數 | 0 | N |
回傳json的參數
參數 | 名稱 | 範例 | 必填 | 備註 |
---|---|---|---|---|
ez_payment_trans_master_id | 付款方交易id | 445b11d533524dcb8a836f4407c8bdfc | Y |
備註一:
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:已關帳