IOSOR ガイド

ウォレット復旧週: 利用再開前にスタックしたホールドをクリアする

ホワイトラベルCPaaSプラットフォームで本番利用を再開する前に、復旧週に台帳内のスタックしたホールドを監査、クリア、返金する方法を学びます。

ウォレット復旧週: 利用再開前にスタックしたホールドをクリアする。

不完全な台帳での支出再開がもたらす危険性

システム停止や上流の障害が発生した際、有効なSMSやOTPメッセージは保留中のホールド状態のまま捕捉されがちです。これらのはぐれた予約をクリアせずに本番トラフィックを再開すると、即座に会計上のズレが生じます。表示上の残高が実際の利用可能資金よりも高額あるいは低額になり、早期の配信停止や予期せぬクレジット枯渇を引き起こします。

ウォレット障害中に問題が発生した場合は、ウォレット障害対応週: 留置ホールドは重複請求ではありませんのガイドを参照し、障害時にホールドがどのように蓄積されるかを確認してください。復旧週では、既存の残高ホールドの監査、未完了予約の解放、そして新規トラフィックを解放する前に台帳が利用可能資金を正確に反映していることの確認という厳格な手順が求められます。

保留中の台帳割り当ての監査

復旧週においては、すべての未確認ルーティングジョブを評価する必要があります。ホワイトラベルCPaaS環境では、メッセージング運用にJIT番号割り当てと即座のクレジット予約が活用されます。キャリアが配信確認(DLR)のウェブフックを遅延して送信したり、停止中に完全にドロップしたりした場合、保留中の残高ホールドはロックされたままになります。

これらのスタックした割り当てを監査するには、標準のタイムアウトウィンドウを超過した保留中ステータスでタグ付けされたすべての台帳エントリを検査します。未承認のトラフィックが、新しい本番キャンペーンに必要な利用可能クレジットを消費していないことを確認してください。

スタックした残高と自動返金の照合

トランザクションの状態に応じて、それぞれ異なる会計処理が必要となります。手動での解放を強制すべきタイミングと、自動照合を待つべきタイミングを理解することで、財務エンジンを同期状態に保つことができます。

ホールド状態 根本原因 必要なアクション 台帳の結果
保留中DLR 上流ウェブフックのドロップ 手動タイムアウト強制 ホールドが残高に解放
配信失敗 未達SMSルート 自動返金エンジン クレジットがウォレットに返還
孤立JIT 割り当て中断 ホールドキャンセルと解放 利用可能資金が復元
スタックHB ハートビート監視の遅延 台帳状態の再同期 正しい残高が表示

詳細な自動フェイルオーバーメカニズムについては、プリペイド確保失敗時の自動返金と状態の真実の解説をご覧ください。これらの項目をクリアすることで、同一のメッセージ試行に対してシステムが二重に資金をコミットすることを防げます。

最低フロアとレビュー閾値

復旧週におけるシステムの整合性維持には、確立された流動性ルールの遵守が伴います。システム保護のため、メッセージングチャネルをアクティブに保ち、突然のボリューム急増時のセッション中ドロップを防ぐために、20米ドルの必須プリペイドフロアが求められます。

さらに、メッセージングの規模が拡大するにつれて、月額1,000米ドルに近いソフトレビューを超えると、自動安全チェックがトリガーされます。これらのチェックポイントにより、支出のロック解除直後に欠陥のあるクライアント再試行ロジックが発火した場合でも、急速な残高消耗を防ぐことができます。

メッセージルーティングの安全な再有効化

ホールドブロックを解除する前に、メッセージングインフラストラクチャ全体すベての保護バリアを確認してください。本番トラフィック前のウォレット停止ラインに関するガイドを参照し、速度キャップ、残高モニター、ルーティングルールが有効であることを確認します。

ホールドがクリアされ、安全ルールが検証されたら、アウトバウンドのOTPおよびプロモーションチャネルを段階的にスケールさせます。手入れの行き届いた綺麗な台帳で支出を再開することで、ドミノ式障害を防ぎ、財務報告の完全な透明性を維持します。

IOSORで始める

IOSORコンソールの請求元帳へ移動し、障害発生期間中に作成された保留中のホールドを絞り込みます。期限切れの予約に対して手動解放を実行するため、確認済みではないDLRウェブフックをアウトバウンドのルーティングログと突き合わせます。元帳の残高が検証済みの配信状態と一致したら、メッセージのルーティングゲートを再度有効にして、本番トラフィックを安全に復旧させます。

IOSORの要点

孤立した元帳のホールドを解消せずにメッセージの送出を再開すると、残高のずれや予期せぬアカウント停止が確実に引き起こされます。未確認の配信状態を体系的に消し込むことで、幽霊のようなクレジット予約がアクティブな残高へと戻り、運用復旧後のシステムの流動性が確保されます。

アウトバウンドのキューを解除する前に、残存するホールド状態を監査し、通信事業者の配信レポートを必ず検証してください。未解放のホールドキューが残高の早期枯渇を引き起こすため、検証されていない元帳のまま本番メッセージングを再開しないでください。

このガイドは役に立ちましたか?

関連ガイド