S100 Mock 17LIVE 電商端|模擬送出 Browser Form POST

對應 17LIVE 外包支付閘道整合規格 v2 §4.2:top-level HTML form POST,非 fetch / 非 axios。 外包 Gateway 不實作此頁面,僅接收表單並將瀏覽器導向第三方付款頁。
§4.2 表單欄位要求(嚴格對齊 v2.pdf / 附錄範例):
支付方式由 Gateway 當前已啟用渠道動態提供;amount 維持 float64(例 150.00), 4.2 新增必填欄位 deviceID / deviceType / version / language / userSelectedRegion / userIpRegion / itemDesc, 其中 webRegion / timezone 只作為可選 regionInfo;三個 returnURL/clientBackURL/errorURL 代表電商網站自身頁面,並自帶 ?manualShip=0&group=0 query params(用來驗證 Gateway 導回時會保留既有參數再安全拼接 success/orderID/...)。
閘道位址:http://host.docker.internal:8080/api/v1/checkout/start
送出方式:form method=POST enctype=application/x-www-form-urlencoded
action 路徑:/checkout/start
① 選擇商品 / 送出表單
② 過去送出的 traceID 紀錄
③ 規格比對視圖(Spec v2 §4.2 vs Form)
🪙
17LIVE Super Points Payment Demo|345pts + Ponta 1pt
merchandiseID=202308_web_super_points_mock_1 · payMethod 依 Gateway 已啟用渠道動態選擇 · sellingChannel=86 (Web Store)
¥ 150
sessionToken*
必填 string · 17LIVE user session
traceID*
必填 string · 17LIVE 前端產生
merchandiseID*
必填 §4.1 merchandise[].merchandiseID
payMethod*
必填 支付方式選擇 · 由 Gateway 已啟用渠道動態載入
sellingChannel*
必填 int32 enum · 86 = Web Store
currency*
必填 ISO4217 · 一期固定 JPY
amount*
必填 float64 · v2 §4.2 / §4.3 / §4.4 一致欄位
⚠ 請輸入小數點兩位(v2 要求 float64),Gateway 會將此值與 A3 金額雙重校驗。
returnURL*
必填 §4.5 電商網站 success/fail 頁(保留既有 query)
clientBackURL*
必填 §4.5 電商網站 back 頁(使用者取消 / 未完成)
errorURL*
必填 §4.2 電商網站 error 頁(付款頁前發生錯誤)
deviceID*
必填 轉發到 internalPrepare header
deviceType*
必填 轉發到 internalPrepare header
version*
必填 Web / App 版本號
language*
必填 轉發到 internalPrepare header
userSelectedRegion*
必填 使用者前端選擇地區
userIpRegion*
必填 依 IP 判定地區
itemDesc*
必填 商品名稱 / 描述,供 Gateway / 第三方顯示
webRegion選填
regionInfo Gateway 填入 internalPrepare
timezone選填
regionInfo Gateway 填入 internalPrepare

近期送出的 traceID(localStorage,最多 20 筆)

Spec v2 §4.2 欄位 vs Form 對照

§4.2 欄位 型別 必要性 Form 實際送出值

(表格會即時反應上方表單的更動,方便與 PDF v2 附錄比對。)