オンライン決済実装研究所
用語集

PaymentIntent

Stripeにおける PaymentIntent の役割を短く整理します。

PaymentIntent は、決済の途中状態を表す中心オブジェクトです。

単に「支払いが成功したか」ではなく、認証待ち、処理中、失敗、再試行といった状態を扱うため、注文状態と決済状態をどう分けるか の設計に直結します。

特に重要なのは次の3点です。

  • 内部注文IDと必ず紐づける
  • Webhookイベントと合わせて追跡する
  • 成功前に受注確定しない