API 串接歷程

路徑：/admin/merchants/api-logs  |  快捷鍵：5 → L

API 串接歷程記錄所有商戶透過 API 進行的請求與回應，供站主排查串接問題、監控異常行為。

頁面說明

頁面提供篩選工具列與表格（採用無限捲動載入）：

篩選條件

欄位	說明
日期區間	請求日期範圍，預設為今日
商戶	下拉選擇特定商戶，預設為「全部商戶」
端點	下拉選擇特定 API 端點，預設為「全部端點」

記錄的 API 端點

系統自動記錄以下五隻商戶 API 的所有請求：

端點	說明
POST /api/payment/create	建立付款訂單
POST /api/payment/query	查詢訂單狀態
POST /api/payment/balance	查詢雲帳戶餘額
POST /api/payment/payout	申請代付
POST /api/payment/payout/query	查詢代付狀態

表格欄位

欄位	說明
時間	請求發生的時間
商戶代碼	發起請求的商戶代碼
端點	API 路徑
狀態碼	HTTP 回應狀態碼，綠色為成功（< 400），紅色為失敗
耗時	請求處理時間（毫秒）
IP	請求來源 IP
User-Agent	用戶端標識
指紋	請求中的 x-fingerprint header
裝置	請求中的 x-device header
詳情	點擊查看完整請求與回應內容

詳情彈窗

點擊某筆記錄的詳情按鈕，會展開彈窗顯示：

• 請求基本資訊：時間、商戶代碼、端點、狀態碼、IP、耗時、指紋、裝置
• Request Headers：完整的請求標頭（Authorization 已脫敏為 ***）
• Request Body：請求內容（JSON 格式化顯示）
• Response Body：回應內容（JSON 格式化顯示）

ErrorCode 對照表

點擊篩選列右側的 「ErrorCode 對照表」 按鈕，會開啟彈窗顯示所有商戶 API 可能回傳的業務錯誤碼及其說明。

對照表內容依 API 端點分組，資料來源為後端 /enum API，會根據當前語系自動切換翻譯。常見的 ErrorCode 包含：

Code	說明
0	成功
4005	未授權（API Key 錯誤）
4308	簽名驗證失敗
4311	商戶未啟用
4302	找不到可用的支付通道
4309	商戶訂單號重複
4401	雲帳戶餘額不足

TIP

完整的 ErrorCode 對照表請直接在頁面上點擊按鈕查看，內容會隨系統更新自動同步。