初回送信前のWebhook契約

Webhook契約のないプリペイド送信は、共通の真実がないまま支出することと同義です。財務部門からステータスと台帳の不一致について指摘される前に、バイヤーは最初の有料メッセージがウォレットから出る前に、署名付きURL、イベントリスト、べき等キーを固定しなければなりません。このページは「ローンチ時のキー設定チェックリスト」でも「署名の詳細解説」でもなく、バイヤーパスそのものです。

関連：ローンチ時のWebhookとキー、ローンチを生き抜くWebhook習慣、初回引き落とし前のプリペイド残高確保、Day-1ランウェイ：グリーンの条件。

IOSORはホワイトラベルのプリペイドシステムです。USD 20で1つの回線での契約パイロットに資金を供給し、月額USD 1,000付近のソフトレビューでは「送信が先、契約は後」というアプローチを偵察的負債として価格設定します。クライアントにはホワイトラベルのイベント名のみが表示されます。

最初の有料送信の前に契約に合意する

有料送信とは、ウォレットからの引き落としが可能な状態を指します。契約とは、プロダクト、財務、オペレーションが、コールバックの送信先、お金やステータスの真実としてカウントされるイベント、およびリトライを安全にするキーについて、すでに認識を共有していることを意味します。契約内容がSlackのスレッドの中に残ったままでは、ローンチの習慣やランウェイがグリーンに見えても、準備完了とは言えません。ローンチ時のWebhookとキーとDay-1ランウェイ：グリーンの条件を確認してください。先週のステージング用コールバックURLでトラフィックを購入してはなりません。

署名付きURLとコンシューマーの所有権

所有者のいない署名付きURLは、夜中の2時にはただの神話になってしまいます。月額USD 1,000のソフト制限では、このような神話をボリュームリスクとして扱います。USD 20があれば、1つのURL、1つの所有者、そして署名ミドルウェア有効化後の2xx応答によるスモークテストを証明できます。ローンチを生き抜くWebhook習慣も参照してください。

プロダクトと財務が共有するイベントタイプ

最初の送信の前に、お金やステータスを動かす可能性のあるイベントを列挙します：accepted、delivered、failed、expired、inbound STOP、および真実として扱う検証結果。リストにないイベントはフェイルクローズされ、台帳の行を勝手に生み出すことはありません。共通の言葉：プロダクトと財務のための共通ステータス言語。プリペイドの証明がない場合、ホールドは依然としてフェイルクローズします(初回引き落とし前のプリペイド残高確保)。契約はイベントメニューであり、その行が信頼できるかどうかの判断は後続のゲートが行います。

支出前のべき等キー

支出の前にキーの形状について合意します：プラットフォームのイベントIDまたはメッセージIDを副作用の前に保存し、引き落とし行の隣で読み取れるようにします。タイムスタンプとボディからキーを勝手に生成すると、リトライによって二重課金が発生します。重複イベントのスモークテストによって1つの台帳行が示されるまで、ボリュームに関するソフトな議論はブロックされます。

Webhook契約のためのバイヤーチェックリスト

1. 初回有料送信の前に本番用署名付きURLが命名され、所有者が明確になっているか？
2. プロダクトと財務が共有するイベントリストが口頭ではなく文書化されているか？
3. べき等キーの形状に合意し、副作用の前に保存されているか？
4. パイロット用と本番用のコンシューマーが別々のシークレットで分離されているか？
5. 不明または未署名のコールバックが正しいステータスでフェイルクローズするか？
6. 契約がドラフト段階のままで、月額USD 1,000の議論がブロックされているか？

「いいえ」が1つでもある場合、Webhook契約および有料トラフィックはドラフトのままとなります。

IOSORで始める

有料メッセージ配信を有効にする前に、IOSORコンソールにアクセスし、署名済みHTTPSコールバックURLと指定した冪等性キーフィールドを登録してください。プロダクト、財務、エンジニアリングのチームリードがdelivered、failed、expiredなどの共有イベントスキーマを確認し、未登録のコールバックが自動的に閉塞状態になることを保証してください。トラフィックの制限を解除する前に、ウェブフックゲート経由で金額発生ゼロの重複イベントペイロードテストを実行し、リトライが単一の台帳行に記録されることを検証してください。

IOSORの要点

ウェブフック契約は単なる非公式なすり合わせではなく、財務やプロダクト部門を二重引き落としや幽霊ステータスの更新から守るための明確な境界線です。最初の有料配信を行う前に、署名シークレットの所有権、正確なURLの所有権、および厳密な冪等性キーの解析を確立することで、リトライストームによる架空の台帳エントリの発生を防ぎます。

コールバックイベントリストを固定し、すべてのインバウンドコールバックにおいて副作用の前にACKを返すアーキテクチャを徹底してください。タイムスタンプやボディハッシュから生成された合成キーを使用して本番トラフィックを稼働させないこと、そしてイベントステータスの定義に関して口頭の合意に依存することは絶対に避けてください。