システム間で記録が抜ける:Webhook・API連携を復旧するには
同じ通知が何度も届いたり、遅れて届いたりすることがあります。受信後の処理を記録しておけば、再試行するのか、欠けた記録を復旧するのか、調査が必要なのかを判断できます。

フローは設計を説明するための例であり、顧客事例ではありません。
- イベントを保存
- 処理・安全に再試行
- 定期照合
タイムアウト後に登録済みか確認する
両方のシステムが動いていても、受け渡しが失敗することはあります。タイムアウトしたときは、相手が登録を終え、返信だけが届かなかった可能性があります。そのまま再送すると重複するかもしれません。受信、処理、反映の確認を分けて記録すれば、次の対応を判断でき、再送を避けたために欠落を残すことも防げます。
再試行と復旧機能を確認する
まず連携サービスのログ、再試行、再実行の機能を確認します。StripeのWebhook資料では、通知の重複や順序の入れ替わりが説明されています。各サービスの仕様に合わせ、一度だけ順番どおりに届くことを前提にしない設計が必要です。
各イベントの処理状況を記録する
重要な一つの業務を選び、届いた通知を検証して番号を保存し、処理を順番待ちにします。失敗した項目には理由を表示し、再試行の前にすでに反映されていないか確認します。人の対応が必要な案件には復旧手順を用意します。元システムとも定期的に照合して欠落を探します。
再実行で二重請求にならないか
同じイベントを再実行し、二重決済や二重出荷にならないか確認します。そのうえで、通知の順序の入れ替わり、API制限、停止、タイムアウト、一部だけ完了した処理を試します。抜けた記録を見つけて復旧でき、対応が必要な失敗を通知から判断できることを確かめます。
失敗した処理の履歴を用意する
個人情報を除いた通知の時系列と失敗ログ、API資料、各ケースで期待する結果を用意してください。