リッチメッセージが有料SMSにフォールバックした際の元帳ホールド管理方法

リッチメッセージが有料SMSにフォールバックした際の元帳ホールド管理方法。

プリペイドフォールバックのメカニズムを理解する

RCSやWhatsAppなどのチャネルが、受信者の未検証状態、ネットワークタイムアウト、またはセッション期限切れにより配信に失敗した場合、プラットフォームは自動的にSMSへのフォールバックを開始します。ホワイトラベルのプリペイドCPaaSオペレーターにとって、この切り替えには即座の元帳介入が必要です。リッチメッセージと標準SMSでは料金表が大きく異なるため、静的な残高控除に頼ることはできません。システムは、初期の高価格帯ホールドを即座に解除し、新しい処理を適用する必要があります。

JIT残高ホールドと元帳調整

プラットフォームの流動性を保護するため、IOSORはアウトバウンドリクエストが生成された瞬間にJIT残高ホールドを利用します。RCSテンプレートがディスパッチされると、元帳はリッチチャネルの料金に一致する資金を凍結します。配信の失敗を示すネガティブDLRまたはタイムアウトWebhookを受信すると、トランザクションエンジンは元帳調整をトリガーします。元のホールドは即座に無効化され、フォールバックSMSに対する新しいデビットが投稿されます。これにより、USD 20のプリペイドフロアが保護されます。

料金デルタとウォレット残高の処理

リッチメッセージは通常、基本メッセージよりも高いコストが発生します。フォールバックが発生した場合、元帳は元のホールドと最終的なSMS料金の間のネット差額を計算します。顧客がUSD 20のプリペイドフロアを上回るプラス残高を維持している場合、デルタがきれいに差し引かれます。月額USD 1,000付近のソフトレビューに向けて急速にスケールするテナントにとって、自動化された元帳調整により、大規模キャンペーン全体でマイナス残高が蓄積するのを防ぎます。

WebhookとDLRの突合

配信レシートは、元帳決済の正確なタイミングを決定します。キャリアゲートウェイからのWebhookは非同期で到着し、順序が崩れることもあります。IOSORエンジンは、アウトバウンドメッセージのUUIDを着信DLRステータスコードと照合して、料金を確定します。RCSセッションが60秒後にタイムアウトした場合、Webhookはプライマリホールドのキャンセルイベントを送信し、その直後にSMS送信料金を送信します。この緊密なフィードバックループにより、テナントの元帳が現実世界と同期した状態に保たれます。

二重課金と競合状態の防止

同時リクエストが発生すると、元のリッチメッセージがまだリトライされている最中にフォールバックSMSが送信される競合状態を引き起こす可能性があります。元帳の整合性を維持するために、すべてのトランザクションには厳格なべき等性キーが適用されます。重複するDLRが同時に到着した場合、元帳はセカンダリチャージを拒否します。関連する手順の詳細については、未ライブ時のWhatsAppとRCSを参照してください。

関連ガイド: 未ライブ時のWhatsAppとRCS · テンプレートとセッションの費用 · 冪等・再試行と資金.

IOSORで始める

IOSORコンソールを開き「請求と元帳」に移動して、フォールバックワークフローのアクティブなJITホールドパラメータを確認します。DLRウェブフックデーモンがフォールバックのダウングレードステータスコードをリアルタイムで解析するように設定されていることを確認してください。元帳デーモンが元のリッチメッセージングのホールドを自動的に無効化し、標準SMSの料金表に対してアトミックな残高調整を実行することを検証します。

IOSORの要点

リッチメッセージングチャネル全体でのプリペイド残高ホールドの管理には、配信がフォールバックSMSにダウングレードされた際の迅速な元帳突合が必要です。未処理のフォールバックイベントは未解放のホールドをそのまま残し、アカウントの流動性を人工的に制限するため、誤った残高枯渇によって有効な後続の送信が失敗する原因となります。

端末のダウングレードステータスコードを受信した直後に、リッチチャネルの承認ホールドを無効化し、正確な宛先SMS料金でイベントの再料金設定を行うようにDLRウェブフックハンドラーを設定してください。保留中のホールドをクリアするために遅延バッチ突合に依存しないでください。フローティング残高ホールドは運転資金を固定化し、トラフィック急増時にプラットフォームのスループットを低下させます。