金流對帳不能只靠人工:綠界撥款報表自動化處理的三個關鍵步驟
當你的電商平台每天只有幾筆訂單時,對帳可以靠人工——登入綠界後台、下載 CSV、打開 Excel 逐筆核對。但當訂單量成長到每天數十甚至數百筆,人工對帳不僅耗時,更容易出錯。金流對帳的核心問題其實只有一個:你的系統認為收到的錢,和綠界實際撥給你的錢,是否完全一致。
第一步:自動下載對帳檔。綠界提供「下載對帳檔」API(對應一般交易)和「下載信用卡撥款對帳檔」API(對應信用卡請退款紀錄),兩支 API 都會回傳 CSV 格式的資料。你可以建立一個每日排程任務(Cron Job),在每天凌晨自動呼叫這兩支 API,下載前一天的對帳資料並儲存到你的伺服器或雲端儲存空間。呼叫時需要傳入 MerchantID、日期區間和 CheckMacValue,與其他綠界 API 的驗證方式一致。
第二步:解析與正規化。下載回來的 CSV 檔案包含交易編號、商店訂單編號、交易金額、付款方式、手續費、處理費等欄位。這裡有一個重要的注意事項:2025 年 4 月起綠界新增了 ProcessFee(交易處理費)欄位,如果你的解析程式是用欄位的位置索引(例如第 5 欄是手續費)來讀取資料,新增的欄位會讓所有後續欄位的位置偏移,導致整份報表的解析結果錯誤。正確做法是以 CSV 的表頭(Header Row)作為欄位對應依據,這樣無論綠界未來再新增或調整欄位順序,你的程式都不會受到影響。
第三步:自動比對與產出差異報告。將綠界回傳的每一筆交易記錄,與你資料庫中的訂單記錄逐筆比對。比對的維度至少包含四個:訂單編號是否存在於你的系統中、交易金額是否一致、付款狀態是否一致、手續費加處理費的加總是否與預期的費率吻合。任何不一致的項目都應該被標記並產出一份差異報告,由財務或營運人員複查。
常見的差異情境包括:消費者在 ATM 繳款期限最後一刻轉帳成功,但你的系統已經自動關單;信用卡交易被銀行事後拒絕(授權成功但清算失敗);退刷金額與你的退款紀錄不符(可能是部分退款的計算誤差)。這些情境不會每天發生,但一旦發生而沒被及時發現,累積下來就會造成帳務差異。
技術實作上,建議在資料庫中建立一張 reconciliation_records 表,記錄每次對帳的日期、比對筆數、成功筆數、差異筆數和差異明細。同時設定告警:當差異比率超過一定閾值(例如 1%)時自動通知相關人員。對帳不是一次性的開發工作,而是一個需要持續運作的系統——它的價值會隨著你的營業額增長而越來越明顯。