產品與財務的共用狀態語言

共用狀態語言是產品與財務部門在繪製圖表前達成的共識。一套統一的結果詞彙——已接受、保留中、已結算、已釋放、已封鎖、已閘控、已送達、失敗、未知、遺失——勝過三個對同一意圖意見分歧的儀表板。本頁是「儀表板前的詞彙」，而非簡訊狀態字典。鄰近文章：未送達、拒收與過期狀態與回執、時延與故障轉移——而非本頁。

IOSOR 是白牌預付費系統。USD 20 的資金足以證明共用字彙的試驗；接近 USD 1,000/month 的溫和審查會讓不匹配的標籤更為顯眼。相關連結：同一帳本上的扣款列與送達狀態、當啟動被封鎖時：誠實的狀態呈現、撐過上線週的 webhook 習慣。

儀表板前的詞彙

儀表板會放大你們本已在爭論的字眼。如果產品端說已送達，而財務端仍讀取為保留中，那麼一個綠色磚塊就是月底的事故。首先凍結共用詞彙表：哪些標籤代表資金已移動、已預留、已退回、流量已停止，或是尚未有人知曉。簽署單頁文件，然後將使用者介面、匯出項目與支援巨集與這些精確字串綁定。

產品與財務必須共用的字彙

沒有平行的同義詞(如「ok」、「完成」)。已封鎖/已閘控透過當啟動被封鎖時：誠實的狀態呈現保持誠實。

未知與遺失並非成功

未知與遺失是一等公民結果。空白儲存格、靜默的 webhook 或延遲的空值絕不能預設為送達或結算的成功。產品端說未知或遺失；財務端保持該列開啟，直到終端字詞到達或指定負責人關閉它。可連接的結果需要撐過上線週的 webhook 習慣。

將狀態對應至金錢結果

每個共用的字詞都對應至預留、結算、釋放/退款或停止。單純的已接受不會花錢；保留會預留；結算在一個意圖 ID 下消費一次；釋放退回從未欠款的金額；封鎖停止新流量。已送達更新相同的借記列——見同一帳本上的扣款列與送達狀態。失敗是終端狀態；保留或釋放——絕不虛構第二次靜默結算。未知/遺失使對帳保持開啟；絕不自動結算為成功。

共用狀態語言的買方檢查清單

1. 已簽署詞彙表：/gated, delivered, failed, unknown/missing？
2. 介面、總帳匯出與支援巨集是否重複使用相同的字串？
3. 未知/遺失是否絕不會預設為成功？
4. 財務能否為每個共用字詞說出對應的金錢動詞？
5. 簡訊百科與 DLR 時延指南被視為同胞——而非本頁？
6. USD 20 試驗能否在接近 USD 1,000/month 的審查前證明詞彙表？

任何「否」都會暫停儀表板工作。

從 IOSOR 開始

匯出您目前的 Webhook 事件與帳簿匯出結構描述，並在主控台中進行並排稽核。對齊已接受、保留、結算與釋放等關鍵術語，讓您的產品 Webhook 與財務借方資料列達成 1:1 對應。更新使用者介面狀態指示器與 Webhook 處理常式，確保未知或遺漏的結果絕不會默默轉換為成功結算。

IOSOR 要點

統一產品與財務部門的狀態用詞，可避免因定義不一致而導致成本高昂的月底對帳爭議。將意圖識別碼直接對應至保留、結算與釋放等明確的財務結果，能確保營運事件準確反映餘額變動。

請在使用者介面、支援巨集與會計匯出之間建立共同簽署的詞彙表，並將未知與遺漏的狀態視為進行中的待處理項目。切勿讓安靜的 Webhook 或含糊不清的狀態預設為成功，或在沒有明確終端狀態的情況下自動關閉帳簿資料列。