臺北市雙層觀光巴士 — 線上購票系統交接說明

範圍:線上購票相關功能(購物車、結帳、訂單查詢、訂單通知、後台訂單管理)

---

一、頁面與功能總覽

頁面	功能說明
首頁 / 票價資訊	展示票種,點「我要購票」開啟購票彈窗選數量加入購物車
購物車 / 結帳	三步驟結帳:檢視購物車 → 付款資訊 → 確認結帳,建立訂單並寄發通知信
訂單查詢	公開頁,輸入訂單號碼 + 付款人電話查詢單筆訂單狀態與明細
後台訂單管理	管理員可搜尋訂單、手動取消,退款功能預留待串接

---

二、購物車結帳流程

• 檢視購物車 — 調整數量、刪除品項;空車無法結帳
• 付款資訊 — 必填姓名、電話、Email(皆含格式驗證);需勾選隱私權同意;付款方式固定「線上刷卡」
• 確認結帳 — 顯示明細,點付款建立訂單(狀態 pending 待付款),清空購物車,顯示完成頁

電話正規化

結帳時電話自動正規化(只留數字與開頭 +),無論輸入 +886 912-345-678 或 0912345678 都會存成一致格式,方便後續查詢比對。支援國際號碼,外國觀光客可使用。

---

三、訂單查詢規則

• 必須同時輸入 訂單號碼 + 付款人電話,缺一不可(防止單一欄位列舉)
• 電話同樣會正規化後比對,與結帳格式不一致也能查到
• 限定近 6 個月訂單
• 不需登入,為公開頁面
• 顯示狀態:待付款 / 已付款 / 付款失敗 / 已取消

---

四、訂單通知信

• 結帳成功自動寄發「訂單成立通知」(四語:中 / 英 / 日 / 韓)
• 內含訂單明細、總金額、客服聯絡資訊
• 「付款完成通知」模板已備,待金流串接後於付款成功時觸發

---

五、尚待完成事項

• 線上刷卡金流串接 — 目前僅建立待付款訂單,未實際扣款;可用 Stripe(本地區 Wix 系列不適用)。串接後:付款成功 → 更新狀態為 paid + 寄付款完成信;失敗 → 更新 failed
• 電子票券(QR Code) — 通知信已提及,產生與寄送功能尚未實作
• 後台退款功能 — UI 已預留,待金流 API 串接
• 訂單編號機制 — 目前用時間戳產生,量大時可考慮更嚴謹規則