財務エクスポートのためのVerifyセッション相関：二つの借方、一つの台帳の話

利用者はコードを求めた。プロダクトは一つのOTPを見た。ウォレットは二行を落とすことがある。コードを運んだSMS配送の借方と、作成・TTL・確認のVerifyセッション借方。「OTPコスト」に溶かすチームは取締役資料で二重計上するか、二行目を月末まで隠す。どちらも制御ではない。二つの借方には、財務が書き出せる一つのセッション物語が要る。

IOSOR は 一つの white-label prepaid 台帳で Verify を SMS の横で動かす。カタログ live は本物のチャネル。in setup は無料セッションではない。月次 USD 1,000+ 付近で SMS 行と Verify セッション行が商務レビューに入る。二つの借方の分解は OTP配送の引き落としとverifyセッション。混乱のない OTP は 混乱のないOTP検証。支出停止は プリペイド支出の制御。

配送の借方とverifyの借方

旅は一つ。金は二つ。関連するが別名ではない。配送借方はコードを運んだチャネルを覆う。エンコード、セグメント、宛先、端末DLR。Verifyセッション借方は発行、TTL窓、確認、期限切れまたは再送ポリシーを覆う。財務がSMSだけ見ればVerifyは「無料」に見える。プロダクトがVerifyだけ見ればSMS汲み上げは「セッション増」に見える。両行は同じ correlation id で見える必要がある。

財務が書き出すべきセッションID項目

財務エクスポートはセッションごとに再構成できねばならない。verify_session_id、関連する message_id または配送id、宛先、チャネル、TTL、端末理由、行ごとの借方額と時刻。correlation id のない一週間は領収の山であり台帳ではない。プロダクトのダッシュボードがセッション成功を示しSMSがまだ pending DLR なら、エクスポートは両側を合わせねばならない。別々の「完了」二つではない。セッションidはサポートチケットと突合表に生き、ログだけに閉じない。

再送TTLと重複行

再送ポリシーは重複行が出るかを決める。セッションを止めてもSMSを撃つ冷却（または逆）は二つの台帳を争わせる。TTL満了は同じVerify行を閉じ、「幽霊セッション」を開いてはならない。利用者起点の再送とシステムの再試行は別の主人、別の冷却。エクスポートは resend_reason と parent_session_id を印し、財務が正当な再送を二重課金事故と扱わないようにする。

規模の前の突合

規模の前に一週間の突合。作成セッション対SMS（またはフォールバック）試行。端末DLR対セッション端末（配達+確認、未達+期限切れ、拒否+未確認）。利用者再送をシステム再試行から分ける。試行がセッションを大きく上回ればブラスト。セッションが試行を大きく上回ればチャネルなしでVerifyを課金している。どちらも商務レビューに落ちる。live の回廊で完了を証明してから USD 1,000+ 付近の強度を語る。

危険信号

• SMSとセッション分割のない混合「OTP料金」
• マーケティングブラストのように課金されるVerify
• 方針なしにSMSを返しセッション行を触らない（または逆）
• 二つの経路の一方の冷却を無視する再送ボタン
• 顧客エラーが上流ブランド名を出す
• チャネルが in setup なのにVerifyを約束
• セッション相関IDのない週次エクスポート

IOSORで始める

検証ダッシュボードからサンプルの週次CSVをエクスポートし、すべてのverify_session_idが対応する配信message_idのレコードと直接紐づいていることを確認してください。本番環境へのアップデートを反映させる前に、キャリアの配信受領証とセッションの終了理由を記録するようウェブフックのログを設定してください。財務部門がユーザー起因の再送とシステムの再試行による引き落としを7日間の期間全体で正常に突合できるまで、トラフィックの拡大は保留してください。

IOSORの要点

検証コストの追跡には、セッションのライフサイクルと、その下位にあるメッセージ配信の引き落としを切り分けて管理することが求められます。財務部門が認証手数料をセッションとの相関関係を考慮せず単一の混合配信枠として捉えると、架空の引き落としや未割当の再送コストによって会計帳簿が損なわれます。

財務部門向けのエクスポートには、必ずverify_session_id、関連する配信message_id、有効期限ウィンドウ、終了ステータス、および行ごとの正確な引き落とし内訳を含めるようにしてください。元のセッション行を更新したり、明示的な相関IDを記録したりしないまま、再送ポリシーによって配信試行が実行されることがないようにしてください。