実装ガイド
決済 API の冪等性を実装事故ベースで理解する
Stripe を中心に、冪等性キーが必要な理由、注文 ID とどう結びつけるか、再送やタイムアウト時に何を保証できるかを整理します。
決済 API の事故で多いのは、通信失敗後の再実行を『もう一度 POST するだけ』で済ませることです。冪等性キーを内部注文 ID と束ねると、二重課金と調査コストを大きく減らせます。
タグ
冪等性
このタグに紐づく記事は 2 本です。 関連記事を横断して読みたいときの入口として使えます。
障害運用
Stripe Webhook で起きやすい失敗を運用視点で10個に整理する
Stripe Webhook で起きやすい失敗を、署名検証、再送、冪等性、順不同イベント、監視不足の観点から整理します。
Webhook障害の多くは、イベントを一回だけ来る前提で処理していることが原因です。署名、保存、冪等性、再処理導線までを最初から含めると、後の運用が大きく楽になります。