IOSOR ガイド

プロダクトと財務のための共通ステータス言語

ダッシュボード構築の前に、結果に対するプロダクトと財務共通の用語(受付、保留、決済、解放、ブロック、配信、失敗、不明)を合意します。

共通ステータス言語とは、グラフを描く前にプロダクトと財務が交わす合意であり、受付、保留、決済、解放、ブロック、配信、失敗、不明という結果に対する一つの用語集は、同じ意図で意見が分かれる複数のダッシュボードよりも価値があります。このページはダッシュボード前の語彙に関するものであり、SMSステータス辞典ではありません。隣接するガイド:未達・拒否・期限切れステータス および DLR・遅延・フェイルオーバー(本ページではありません)。IOSORはホワイトラベル型prepaidです。USD 20のトップアップで共通語を証明するパイロットを実施でき、約USD 1,000/月付近のソフトレビューでは不一致のラベルがより明確になります。関連記事:同一台帳のデビット行と配信ステータス、ローンチブロック時:嘘のないステータス表示、ローンチを生き抜くwebhook習慣。

ダッシュボードの前の語彙

ダッシュボードは、すでに議論している言葉を増幅させます。プロダクトが配信済みと言い、財務が保留と読むなら、緑色のタイルは月末のインシデントです。まずは共通の用語集を凍結してください。どのラベルが資金移動、予約、返金、トラフィック停止、あるいは不明を意味するかを定義します。1ページに署名し、UI、エクスポート、サポートマクロをその文字列に一致させます。

プロダクトと財務が共有すべき言葉

言葉 プロダクト 財務
受付 意図を受信 未決済
保留 予約オープン 残高を予約
決済 課金単位の消費 最終デビット
解放 ホールド終了 残高へ返金
ブロック 本番停止 ボリュームゼロ

並行する同義語を作らないこと。ブロックの状態はローンチブロック時:嘘のないステータス表示に準拠します。

不明と未達は成功ではありません

不明と未達は第一級の結果です。空白セルやサイレントWebhook、遅れたnullを、配信成功や決済成功にデフォルト設定してはなりません。プロダクトが不明またはmissingとし、財務側は確定語が届くか担当者が閉じるまで行を開いたままにします。結合可能な結果にはローンチを生き抜くWebhook習慣が必要です。

ステータスをマネー結果にマッピングする

すべての共有ワードは、予約、決済、解放・返金、または停止にマッピングされます。受付だけでは支出されず、保留は残高を予約し、決済は一度だけ消費されます。配信成功時はデビット行を更新します—同一台帳のデビット行と配信ステータスを参照してください。失敗は終端状態であり、二重決済を行ってはなりません。不明は照合を開いたままにします。

共通ステータス言語のバイヤーチェックリスト

  1. 用語集に署名済みか(受付、保留、決済、解放、ブロック、配信、失敗、不明)?
  2. UI、台帳エクスポート、サポートマクロが同じ文字列を使用しているか?
  3. 不明・未達が成功としてデフォルト処理されていないか?
  4. 財務がすべての共有ワードに対して資金の動詞を説明できるか?
  5. SMS辞典やDLR遅延ガイドは姉妹記事として扱われているか?
  6. USD 20のパイロットが、約USD 1,000/月のレビュー前に用語集を証明するか?

「いいえ」がある場合、ダッシュボードの作業は一時停止します。

IOSORで始める

コンソール上で現在のWebhookイベントと台帳エクスポートスキーマを単一の並列監査にエクスポートします。accepted、held、settled、releasedなどの主要な用語を揃え、プロダクトのWebhookと財務の借方行が1対1で対応するようにします。UIのステータスインジケーターとWebhookハンドラーを更新し、未知の結果や欠落している結果が暗黙的に正常な決済に変換されないようにします。

IOSORの要点

プロダクトと財務の間でステータスの表現を統一することで、定義の不一致に起因する月末の煩雑な照合トラブルを防ぎます。インテント識別子を保留、決済、解放といった明確な財務上の結果に直接マッピングすることで、運用イベントが残高の動きを正確に反映するようになります。

UI、サポートマクロ、および会計エクスポートの間で共通の用語集を確立し、未知および欠落しているステータスを未解決の項目として扱ってください。サイレントなWebhookや曖昧なステータスをデフォルトで成功とみなしたり、明示的な終了状態なしに台帳行を自動クローズさせたりしないでください。

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

関連ガイド