Stripe を使っているときに 429 というエラーが出た場合、このページで解決できます。難しい知識は不要です。上から順に確認していきましょう。

まずこれだけ試してください

難しいことを調べる前に、次の3つを確認してください。多くの場合、これだけで解決します。

  1. 一度ログアウトして、再度ログインする
  2. ブラウザのキャッシュ・Cookieをクリアして再試行する
  3. しばらく待ってから（5〜10分後）再試行する

このエラーの意味

429 は、Stripe が「短時間に送ったリクエスト数がStripe APIのレート制限を超えた。」という状態のときに表示されます。

エラーが出ても、データが消えたり壊れたりするわけではないので安心してください。

よくある原因

このエラーが出るときによく見られるパターンです。自分の状況に近いものを探してみてください。

  • ループ処理の中でAPIを呼び出す間隔を設けていない
  • 一括処理でAPIを連続実行している

解決手順（上から順に試す）

  1. リトライ時にRetry-Afterヘッダーの値だけ待機する
  2. Stripe公式SDKのバックオフ機能を有効化する
  3. 一括処理は非同期キュー（Webhookやバッチ処理）に変更する

それでも解決しない場合

  • Stripe のサポートに問い合わせる：エラーメッセージの全文をスクリーンショットで送ると対応が早くなります
  • 公式ヘルプページを検索する：「429 Stripe」で検索すると関連ページが見つかることがあります
  • 時間をおいて再試行する：Stripe 側で一時的な問題が起きているケースもあります

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。