異常排查與狀態參考

如何排查異常與解讀狀態

統一排查順序

確認環境、客戶、實體、賬戶／預算／卡片和時間範圍。

記錄唯一 ID：實體 ID、賬戶 ID、卡 ID、交易 ID、外部參考號。

在列表和詳情核對當前狀態、金額、時間及操作人。

沿實體 → 主賬戶 → 子賬戶 → 預算 → 卡 → 交易的關係逐層核對。

查審計日誌與外部渠道記錄，判斷是資料延遲、配置、許可權還是真實業務失敗。

重試或人工調整前確認冪等性，避免重複入賬、重複扣款或重複通知。

常見問題

現象	優先檢查	處理方向
查不到客戶或賬戶	環境、實體 ID、狀態、時間範圍與許可權	清空非必要篩選後用唯一 ID 重查
賬戶金額對不上	充值明細、賬戶流水、凍結、預算分配／退回	按時間順序重建資金變動
預算顯示有額度但卡不能用	已用額度、限額卡預留、卡狀態、交易授權	區分可消費金額和可用額度
交易長時間處理中	髮卡方參考號、授權／清算時間、Webhook	避免盲目重試，先確認上游最終狀態
Webhook 未收到	啟用狀態、訂閱事件、URL、IP／網路、簽名與重試	請在客戶系統中檢查回撥請求日誌、響應狀態、簽名校驗及防火牆配置。確認配置無誤後，等待下一筆真實業務事件；如仍未收到，再聯絡支援團隊核對傳送和重試記錄。
使用者看不到選單	使用者狀態、角色、選單狀態、父子層級	按最小許可權補齊並重新登入驗證

狀態解讀

物件	常見狀態	運營含義
賬戶	正常／停用／登出	正常可按規則使用；凍結需確認原因；登出通常不可再操作
VCC 卡	正常／禁用／已登出	禁用可按許可權恢復；登出通常為終態
交易		授權：批准／拒絕／過期／部分批准	授權撤銷：成功／失敗	衝正：成功／失敗／處理中	清算：成功／無授權清算	退款：成功／失敗／處理中／部分退款	拒付：已發起／待商戶回應／勝訴／敗訴／仲裁中／已撤銷	授權：批准表示支付請求已透過，但不代表已經完成最終清算；拒絕表示本次支付未透過；過期表示授權在有效期內未完成後續處理；部分批准表示只批准了部分請求金額，需要核對實際批准金額。	授權撤銷：用於取消此前的授權。撤銷成功後，原授權佔用的額度通常會釋放或調整；撤銷失敗時，需要繼續關注原交易狀態，不能直接視為已完成撤銷。	衝正：用於撤回或更正原交易。處理中表示系統尚未完成衝正；成功表示衝正已完成；失敗表示原交易可能仍需進一步核對。	清算：表示交易進入最終結算階段。成功表示清算完成；無授權清算表示存在清算記錄，但未匹配到對應的授權記錄，需要核查交易明細及相關業務原因。	退款：成功表示退款已完成；處理中表示退款仍在處理；部分退款表示僅退回部分金額；失敗表示本次退款未完成。退款不等同於授權撤銷或衝正。	拒付：表示交易進入爭議處理流程。已發起表示拒付案件已建立；待商戶回應表示等待補充資料或處理；勝訴、敗訴和仲裁中分別表示爭議處理結果或當前階段；已撤銷表示拒付案件被撤回，不代表原交易已經退款。
配置	啟用／停用		停用可能影響新請求，既有資料處理方式需按產品規則確認

升級問題時 附上環境、唯一 ID、發生時間（含時區）、預期結果、實際結果、重現步驟和必要截圖；對敏感欄位先脫敏。