處理器重試不得重複加值

具冪等性付款觸發機理

在 IOSOR 生態系中，自動加值受嚴格的冪等性協定規範。當您的餘額達到 USD 20 預付保底門檻時，系統會產生一個獨特的交易 UUID。預付錢包會暫時持有(Hold)待處理資金，確保在交易確認前，不會因重複觸發而導致資金重疊。此憑證能確保即使網路抖動導致付款處理器重試請求，帳本也只記錄單一的信用事件。這能防止破壞財務報表與現金流管理的「重複加值」情境，確保每一分預算都精確對應到實際的通訊容量。

管理閘道延遲與逾時狀態

付款閘道有時會經歷超出標準 HTTP 逾時視窗的延遲。若未能在定義視窗內收到回應，IOSOR 中介軟體會進入「等待中」狀態，而非盲目觸發重試。此外，系統導入了「靜止時段」(Quiet Hours)邏輯，在特定系統維護或高負載期間，會自動調節重試頻率，避免對 API 造成不必要的壓力。透過使用冪等性金鑰，我們確保後續任何處理相同加值事件的嘗試，皆會與現有記錄進行比對與核對，從而消除因網路不穩定產生的冗餘交易記錄。

維持 USD 20 預付保底金額

USD 20 預付保底金額是自動化補足餘額的觸發點。一旦即時帳本偵測到餘額低於此閾值，JIT(即時)計費引擎便會啟動加值。這可確保 E.164 號碼指派與主動訊息活動的 MRC(每月固定費用)絕不會中斷。預付錢包會鎖定這筆保底資金，作為維持通訊服務連續性的緩衝區。系統會將交易保持在「驗證成功」狀態，直到處理器確認資金到位。這種機制特別適用於高吞吐量的企業應用，確保在流量高峰期，帳戶餘額始終足以支撐當前的通訊需求。

帳本同步與網路鉤子驗證

每一次成功的加值都會觸發送往您後端的網路鉤子(Webhook)通知。這些網路鉤子包含 DLR(傳遞回條)同步資料與更新後的帳本餘額，這被視為系統的「唯一事實來源」。此外，系統會自動處理退訂同步(Opt-out Sync)，確保當終端用戶選擇拒絕接收訊息時，相關狀態會立即反映在帳本與路由邏輯中。透過驗證這些網路鉤子，開發人員可以確保其本地資料庫與 IOSOR 主記錄完全一致。若發生處理器重試，網路鉤子仍會反映原始的交易 UUID，為所有財務運作維護清晰且不可篡改的稽核軌跡。

擴展限制與支出控制審查

隨著流量成長，IOSOR 提供安全網來保護您的資本。針對接近每月 USD 1,000 軟性審查的帳戶，我們的合規團隊會監控加值頻率，以確保使用模式與合法流量保持一致。我們會根據您的通訊吞吐量與線路容量需求，動態調整信用額度。此審查流程有助於防止因 API 金鑰洩漏導致的詐欺性支出，同時允許通訊基礎設施在受控的環境下無縫擴展。我們會評估您的歷史加值記錄，並在必要時提供更高的預付上限，以支援大規模的全球推廣活動。

相關閱讀: 當寬限期結束發送即會暫停 — 運行絕不假成功 · 自動加值確保即時流量不中斷 · 首次扣款前的預付資金保留.

從 IOSOR 開始

開啟帳務，查出最近一筆跨過 USD 20 觸發線的門檻列，把冪等鍵抄下來。處理端若仍停在 pending，別再發第二筆自動儲值。只等一個終態：settled 或 declined。Webhook 用這組 UUID 入帳，不是因為又來一則 HTTP 200。

IOSOR 要點

逾時不是第二次儲值。一次門檻突破只綁一把冪等鍵；pending 在處理端結案前都還是 pending。要做：重試必須對上既有那一列。不要：第一把鍵還開著就再灌錢包。Ledger 認 UUID，不認第二個 200。