課程網站突然有人反映「刷卡失敗」「付款後沒開課」「結帳一直轉圈」，先不要急著重裝外掛，也不要直接認定是金流掛掉。付款流程中間會經過瀏覽器、WordPress、WooCommerce、付款外掛、金流服務與訂單回呼，任何一層出問題，都可能讓學員看到類似的「付款失敗」。
先分清楚：是「付款被拒絕」還是「網站流程出錯」
信用卡被銀行拒絕、餘額不足、驗證失敗，和網站 API 錯誤、回呼沒有收到、外掛衝突是不同類型。前者通常需要學員確認付款方式；後者才需要網站端排查。
如果只有單一學員失敗、其他訂單正常，先看該筆交易的錯誤原因；如果突然所有人都無法付款，就更值得優先檢查網站、金流設定與近期更新。
第 1 步：先看 WooCommerce 訂單備註
訂單備註常會記錄付款嘗試、狀態變更、金流回傳與錯誤時間。不要只看訂單最後停在 Pending、Failed 還是 Processing，而要看中間發生了什麼。
- 付款是否真的送到金流？
- 金流有沒有回傳錯誤碼或拒絕原因？
- 訂單狀態什麼時候改變？
- 付款成功後是否有回呼但沒有更新訂單？
第 2 步：開啟付款外掛 log，再做新的測試訂單
WooCommerce 官方目前也建議遇到付款問題時檢查交易 log。多數金流外掛會在 WooCommerce 的付款設定中提供除錯記錄，之後可到狀態／Log 區查看。
注意：log 通常只會記錄開啟之後的新交易。如果錯誤已經發生，才打開記錄，舊訂單不一定會突然出現完整資訊，所以通常需要再做一筆測試。
第 3 步：確認金流帳號、模式與 API 設定
最基本但常被忽略的問題，包括測試金鑰放到正式模式、正式金鑰貼錯、商店代號變更、Webhook／回呼網址錯誤，或金流後台權限被修改。
- 目前是測試模式還是正式模式？
- API Key／Secret 是否對應同一環境？
- 回呼網址是否仍正確？
- 網站網址、HTTPS 或網域近期是否變更？
第 4 步：確認金流「有收錢」但網站「沒更新」的狀況
有一種特別麻煩的情況：學員銀行端顯示付款成功，WooCommerce 卻還停在待付款。這時不要叫學員立刻再刷一次，應先查金流後台交易狀態、訂單備註與回呼。
如果款項成功但網站沒有收到通知，問題可能出在 Webhook／回呼、API、網站防火牆或主機阻擋。先確認交易，再決定是否人工更新訂單與補開課。
第 5 步：檢查近期更新與外掛衝突
如果付款功能原本正常，更新 WordPress、WooCommerce、金流外掛、快取或安全外掛之後才出問題，時間點本身就是重要線索。
可以先在測試環境保留 WooCommerce 與付款外掛，再逐步停用其他外掛確認。不要在正式招生期間直接把整站所有外掛關掉。外掛衝突的完整排查流程可搭配課程網站外掛衝突怎麼查。
第 6 步：檢查快取、防火牆與安全規則
結帳、購物車與會員頁是動態頁面，通常不應像一般文章頁一樣被錯誤快取。安全外掛、CDN 或 WAF 如果阻擋金流 API／回呼，也可能造成付款完成卻無法同步。
如果網站有使用多層快取，可參考CDN vs 快取差在哪，確認結帳與登入相關頁面是否有正確排除。
第 7 步：看 WooCommerce 系統狀態，不要只盯著金流
WooCommerce 系統狀態可以幫你檢查 PHP、WooCommerce 頁面、模板與部分環境資訊。版本太舊、結帳頁設定錯誤、必要擴充不相容，都可能影響付款。
第 8 步：用測試站重現，不要在正式站一直試錯
複雜付款問題最好在 staging／測試環境重現。把正式網站複製到測試站後，再停用外掛、切換佈景主題或更換版本，比直接在有真實學員下單的網站操作安全。
| 症狀 | 優先檢查 |
|---|---|
| 只有一位客戶刷不過 | 拒絕原因、付款方式、訂單備註 |
| 全部突然不能付款 | 金流狀態、近期更新、API、外掛衝突 |
| 銀行扣款但訂單未更新 | 金流後台、Webhook／回呼、log |
| 付款成功但沒開課 | 訂單狀態、LMS 整合、會員權限 |
| 手機才失敗 | 前端 JS、瀏覽器、第三方跳轉與快取 |
付款修好後，還要再測「開課」而不是只看訂單
課程網站的交易終點不是 WooCommerce 顯示付款成功，而是正確會員取得正確課程、收到通知並能登入。完整流程可以再對照付款後自動開課流程與會員權限設計。
課程網站付款失敗常見問題
付款失敗可以直接叫客戶再刷一次嗎？
先確認是否真的沒有成功扣款。如果銀行或金流已顯示成功，但網站訂單沒更新，重複付款可能造成重複扣款與後續退款工作。
要長期開著金流 debug log 嗎？
通常不需要。排錯時開啟、取得需要的紀錄後再依外掛建議關閉，避免 log 長期膨脹或留下不必要資訊。
付款成功但沒有自動開課，算金流問題嗎？
不一定。如果 WooCommerce 訂單已正確更新，問題更可能在 LMS 整合、會員帳號或課程權限設定。
先保留證據，再一層一層排除
付款問題最怕一看到錯誤就同時改金流、快取、外掛和主機，最後即使恢復也不知道原因。先看訂單備註與 log，確認交易實際發生在哪一步，再逐層縮小範圍，處理速度通常會快很多。