決済API

決済 API の冪等性を実装事故ベースで理解する

Stripe を中心に、冪等性キーが必要な理由、注文 ID とどう結びつけるか、再送やタイムアウト時に何を保証できるかを整理します。

決済 API の事故で多いのは、通信失敗後の再実行を『もう一度 POST するだけ』で済ませることです。冪等性キーを内部注文 ID と束ねると、二重課金と調査コストを大きく減らせます。