錯誤碼一覽

在 ChatGPT 開啟在 Claude 開啟

API 回應的 code

錯誤碼	HTTP	意思	建議處理
`S0000`	200	成功	—
`A0001`	401	未授權：token 缺少、格式錯誤、已被重新產生，或網域沒有開啟 API 串接	確認 header 是 `Authorization: Bearer <token>`，以及用對了測試或正式環境的 token。token 被重新產生過就要換新的
`V0001`	400	請求參數錯誤	依 `message` 修正後重送。欄位驗證錯誤的訊息不含欄位路徑，請對照 API 參考逐欄檢查
`V0002`	400	狀態不允許：金流尚未開通，或交易、定期定額目前的狀態不能做這個動作	先查詢目前狀態再決定
`V0003`	400	超過單筆最高金額（200,000 元以上需要開通高額交易）	拆成多筆，或聯絡應援開通
`T0001`	400	交易失敗（一般原因）	請消費者換卡或稍後再試
`T0002`	400	安全碼錯誤	請消費者確認卡片資料
`T0003`	400	卡片過期	請消費者換卡
`T0004`	400	額度不足	請消費者換卡或聯絡發卡銀行
`T0005`	400	發卡銀行拒絕授權	請消費者聯絡發卡銀行或換卡
`R0001`	400	退款失敗	先查詢交易狀態。之後重試都回 `V0002` 時，代表退款結果需要人工確認，請聯絡應援
`K0001`	400	風控拒絕：個人身分商家的當月累計或單筆金額超過門檻	回應的 `detail.subCode` 說明原因，請聯絡應援
`C026`	409	付款結果不明，回應帶 `"retryable": false`	不要重試，也不要換一筆新訂單重扣。稍後用查詢交易或訂單編號查詢確認；久未確定請聯絡應援
`F0001`	500	系統錯誤或未分類的錯誤	看 `message`：`Invalid date`（日期參數錯誤）、`Pagination parse failed`（`page` 分頁標記無效）、`Current charged amount too low`（退款時網域待撥款金額不足）請依原因處理；其他請稍後重試，建立交易類的請求重試前先查詢

處理原則見錯誤處理。

結帳頁導回的 payment_error

消費者付款失敗或逾時時，會被導回你的 failureUrl，網址加上 payment_error=<代碼>，例如 https://shop.example.com/payment/failure/A001?payment_error=T0004。

錯誤碼	HTTP	意思	建議處理
`V0002`	導回參數	結帳逾時、交易已處理過或找不到交易；未歸類的錯誤也是這個值	重新建立交易
`V0003`	導回參數	付款結果尚未確定。和 API 回應的 `V0003` 意思不同	等付款通知，或稍後查詢交易
`T0001`	導回參數	付款失敗，包含 3D 驗證失敗	請消費者換卡或稍後再試
`T0002`	導回參數	安全碼錯誤	請消費者確認卡片資料
`T0003`	導回參數	卡片過期	請消費者換卡
`T0004`	導回參數	額度不足	請消費者換卡
`T0005`	導回參數	發卡銀行拒絕	請消費者聯絡發卡銀行或換卡
`Y003`	導回參數	綁卡頁已逾時（10 分鐘）	重新建立綁卡頁

導回的代碼只用來顯示訊息給消費者，請以付款通知或查詢結果為準。
LINE Pay 付款失敗或取消時，導回 failureUrl 不帶 payment_error。

其他 HTTP 狀態

HTTP	什麼時候	body
403	正式環境的呼叫來源 IP 還沒綁定，見固定 IP 白名單	只有 `message` 欄位（通常是 `Forbidden`），沒有 `code`
404	路徑不存在	純文字 `Not Found`
405	不支援的 HTTP method	純文字 `Method Not Allowed`
504	處理超過 29 秒。請求可能已經成功，先查詢再決定要不要重送	—