上線檢查清單

上線前逐項確認。每一項都附上說明頁。

帳號與設定

• 正式環境的 token 已產生，只放在伺服器的環境變數或密鑰管理服務，沒有進版本控制。（驗證與 token）
• 伺服器的對外 IP 已綁定，從正式環境呼叫查詢 API 不會回 403。（固定 IP 白名單）
• 正式環境 CRM 已設定「交易資料回傳網址位置」，是 https、443 port、可以從外部連到。（付款通知）
• API 與結帳頁網址已經拿掉 .testing。
• 要用的付款方式都已開通，結帳頁實際出現的方式符合預期（信用卡一定會出現）。（付款方式）
• 需要退款、取消通知的話，已請應援開啟「Webhook 新版事件」。

建立交易

• 每一筆都帶 productDetails，品項合計等於 amount。
• 消費者按下付款時才建立結帳，建立後立即導轉（結帳頁 5 分鐘內有效）。
• successUrl、failureUrl 用路徑或參數帶上自己的訂單編號，failureUrl 沒有自帶 ?。
• 網域有開通電子發票時，有帶 userName 與 userEmail。

判斷結果

• 出貨以回查結果為準，不是導回網址，也不是付款通知的內容。
• 收到付款通知後用 id 呼叫 GET /transactions/{id} 回查，並比對 orderId 與金額。
• charged 與 claimed 都視為付款成功。
• 收到 charging（超商、ATM、LINE Pay）時不出貨，等下一則通知。
• 付款通知的接收端在 10 秒內回 200，耗時工作放到背景；同一則通知重複收到也不會重複出貨。

重試與對帳

• 逾時、504、409 C026 時不直接重送，先用訂單編號查詢。（錯誤處理）
• 有定期工作處理「超過 15 分鐘還沒結果」的訂單，補救漏掉的付款通知。
• 同一個 orderId 有兩筆以上成功時，會通知人員處理。
• 每天和應援的交易資料對帳一次。（查詢與對帳）

定期定額與存卡（有用到才需要）

• 已在 CRM 開啟「定期交易重試機制」，或有機制處理一期失敗後整個停止的情況。（定期定額）
• 消費者提出取消時，會立即呼叫取消 API。
• token 通知的接收端穩定，並用 customId 對應會員；token 只存在伺服器。（存卡與後續扣款）
• 用 token 扣款逾時時，先查詢再決定是否重送。

退款

• 退款前確認交易還沒退過，金額一次決定好。
• 超商代碼、ATM 退款會帶退款帳戶。
• 有開發票的交易，退款會帶 productDetails。

最後測試

• 在測試環境跑過：付款成功、付款失敗、結帳頁逾時、消費者放棄付款、退款。
• 上線後用正式環境跑一筆小額交易並退款，確認付款通知、回查與退款都正常。