ブログ一覧に戻る

公開日:

Subscriptions for WooCommerceでWC_Gateway_Stripe_Sepa not foundのFatal Errorになるときの解決方法

Subscriptions for WooCommerce有効化後にWC_Gateway_Stripe_Sepa not foundでサイト全体が500になる状態から、関連プラグインの停止、修正版更新、Stripe決済と定期購入の確認まで行う手順をご紹介します。

発生したケース

Subscriptions for WooCommerceを有効化したあと、公開ページ、管理画面、WP-CLIまでFatal Errorで止まるケースがありました。

Subscriptions for WooCommerceは、WooCommerceに定期購入、継続課金、会員課金などを追加するサブスクリプション系プラグインです。WooCommerce Stripe Payment Gatewayは、WooCommerceへStripe決済を追加する公式決済プラグインです。この2つを組み合わせているサイトでは、片方だけを見ても原因を見誤ります。

ログには、次のようなクラス未検出エラーが出ていました。

PHP Fatal error:
Uncaught Error:
Class "WC_Gateway_Stripe_Sepa" not found

場所:
wp-content/plugins/subscriptions-for-woocommerce/package/gateways/stripe-sepa/
class-wps-subscriptions-payment-stripe-sepa.php

今回のポイントは、WC_Gateway_Stripe_Sepa の機能を深く理解することではありません。重要なのは、Subscriptions for WooCommerce側がStripeの旧SEPA決済クラスを前提にしている一方で、WooCommerce Stripe Payment Gateway 10.3.0ではlegacy checkout系の決済クラスが削除されていた点です。

Subscriptions for WooCommerceとStripe 10.3.0の依存関係

今回の事例の対応状況

今回は、Subscriptions for WooCommerce側の修正版へ更新することで復旧できる事例です。

管理画面へ入れない場合は、先にSubscriptions for WooCommerceをファイル名変更で一時停止し、管理画面へ戻れる状態を作ります。そのうえで、Subscriptions for WooCommerce側を修正版または最新版へ更新し、WooCommerce Stripe Payment Gatewayのバージョンと決済導線を確認します。

緊急復旧だけを目的にする場合、WooCommerce Stripe Payment Gatewayを10.2.0へ一時的に戻す方法も報告されています。ただし、これは根本対応ではありません。Stripe側の旧クラスへ依存しているSubscriptions側を更新しないままにすると、次回更新時に同じ依存ズレが再発します。

このケースの解決方法

このケースで有効な解決方法は、Subscriptions for WooCommerceを修正版または最新版へ更新し、Stripe SEPA旧クラスへの依存が残らない状態にすることです。

管理画面へ入れる場合は、次の順番で対応します。

解決の筋:
1. バックアップを取得する
2. Subscriptions for WooCommerceを修正版または最新版へ更新する
3. WooCommerce Stripe Payment Gatewayのバージョンを確認する
4. Stripe決済、SEPAを使っている場合はSEPA、定期購入の作成・更新を確認する
5. Fatal ErrorがPHPログに再発していないことを確認する

管理画面へ入れない場合は、FTP/SFTPまたはサーバーのファイルマネージャーで wp-content/plugins/subscriptions-for-woocommerce を _subscriptions-for-woocommerce などへディレクトリ名変更します。WordPressがSubscriptions for WooCommerceを読み込めなくなるため、管理画面へ戻るための経路を作れます。

管理画面へ戻れたら、フォルダ名を戻して無効状態のまま修正版へ更新するか、公式配布ファイルで入れ直します。決済プラグインの復旧では、サイトが表示されるだけで完了にしません。定期購入の新規作成、既存サブスクリプションの更新、決済方法の表示、Webhook、注文ステータスまで確認します。

WC_Gateway_Stripe_Sepa Fatal Errorの復旧順

ログをどう判断したか

ログでは、Subscriptions for WooCommerce配下のSEPA決済ファイルで、WC_Gateway_Stripe_Sepa が見つからないと記録されていました。

この時点で、Stripeの設定ミスやAPIキー不備より先に、プラグイン同士のバージョン不整合を疑います。WooCommerce Stripe Payment Gateway 10.3.0ではlegacy checkout系の決済クラスと設定取得メソッドが削除されています。つまり、Stripe側から削除された旧クラスを、Subscriptions側が読み込もうとして落ちていると判断できます。

ログや確認結果判断した内容
subscriptions-for-woocommerce 配下で落ちている発火元はSubscriptions側の読み込み処理
WC_Gateway_Stripe_Sepa が見つからないStripe側の旧SEPAクラスを前提にしている
WooCommerce Stripe 10.3.0で発生10.3.0のlegacy checkout系クラス削除と関係すると判断
WP-CLIでも停止できないWordPressの読み込み完了前にFatal Errorになっている
開発元が修正完了を案内Subscriptions側の修正版更新を恒久対応にする

この表で見るべきなのは、「どちらのプラグインを先に直すか」です。Stripe 10.3.0を一時的に戻すと表示は戻るかもしれませんが、長期的にはSubscriptions側が削除済みクラスへ依存しない状態に更新されているかを確認します。

具体的な解決手順

Subscriptions for WooCommerce / Stripe SEPA Fatal Error復旧手順

[ ] データベースとwp-contentをバックアップする
[ ] PHPエラーログで `WC_Gateway_Stripe_Sepa` を確認する
[ ] Subscriptions for WooCommerceのバージョンを確認する
[ ] WooCommerce Stripe Payment Gatewayのバージョンを確認する
[ ] 管理画面へ入れない場合は `subscriptions-for-woocommerce` を `_subscriptions-for-woocommerce` へ変更して停止する
[ ] 管理画面へ戻れたらSubscriptions for WooCommerceを修正版または最新版へ更新する
[ ] 必要に応じてWooCommerce Stripe Payment Gatewayも最新版へ更新する
[ ] キャッシュ、OPcache、オブジェクトキャッシュを削除する
[ ] 公開ページ、管理画面、商品ページ、購入手続き画面を確認する
[ ] Stripe決済と定期購入の更新処理をテストする

緊急時にWooCommerce Stripe Payment Gatewayを10.2.0へ戻す場合は、決済停止時間を短くするための暫定対応に留めます。復旧後はSubscriptions for WooCommerce側の修正版を確認し、Stripeを古いまま固定しないようにします。

保守現場ではこう判断する

決済系プラグインでFatal Errorが出たときは、落ちているプラグイン名だけで判断しません。特に定期購入、Stripe、PayPal、会員課金、請求書発行などは、複数プラグインが決済クラスや注文ステータスを前提にして動きます。

今回のようなケースでは、次の順で見ます。

確認すること見る理由次の対応
どのプラグイン配下でFatal Errorが出ているか発火元を絞るSubscriptions側の読み込み処理を確認
どのクラスが存在しないか依存先を特定するStripe側のバージョン変更を見る
決済プラグインの更新履歴削除・非推奨になった機能を確認する関連プラグインの互換性を確認
管理画面へ入れるか更新経路を決める入れない場合はフォルダ名変更で停止
定期購入の課金に影響するか売上影響を判断する復旧後に更新決済とWebhookを確認

「Stripeが悪い」「Subscriptionsが悪い」と決めつけるより、削除されたクラスをどちらが呼んでいるかをログで確認します。今回の復旧判断では、Subscriptions側の修正版更新を優先し、Stripe側のロールバックは緊急時の一時手段に留めます。

やってはいけない対応

NG理由
PHPファイルへ class_exists() や return を直接追記する更新で消えてしまい、決済処理の判断もしづらくなる
Stripeだけを古いバージョンへ固定するlegacy checkout移行やセキュリティ更新を追いにくくなる
Subscriptionsを停止したまま営業再開する定期購入、更新決済、会員課金に影響する
トップページ表示だけで復旧完了にする購入手続き、サブスク更新、Webhookが壊れていることがある
複数の決済プラグインを同時に更新するどの更新で復旧したか、どの更新で壊れたかが分からなくなる

顧客向け通知例

Subscriptions for WooCommerceとStripe決済プラグインの組み合わせで、旧SEPA決済クラスを読み込もうとしてFatal Errorが発生していることを確認しました。

まずSubscriptions for WooCommerceを一時停止して管理画面へ戻れる状態を確保し、修正版または最新版へ更新します。復旧後、公開ページ、購入手続き、Stripe決済、定期購入の更新処理、Webhook、PHPエラーログを確認します。

緊急復旧としてStripe側を旧バージョンへ戻す選択肢もありますが、恒久対応はSubscriptions側の修正版更新です。決済受付の再開は、テスト注文と定期購入の確認後に判断します。

公式情報

WooCommerce Stripe Payment Gatewayの公式ページでは、10.3.0でlegacy checkout系の決済クラスと設定取得メソッドが削除されたことが案内されています。Subscriptions for WooCommerceの解決済み事例では、WC_Gateway_Stripe_Sepa が存在しないことでサイト全体が停止し、Subscriptions側の修正完了が案内されています。

確認環境

確認対象:
- WordPress:
- WooCommerce:
- Subscriptions for WooCommerce:
- WooCommerce Stripe Payment Gateway: 10.2.0 / 10.3.0以降
- PHP:
- 決済方法: Stripeカード / SEPA / Express Checkout
- 確認画面: wp-admin / Plugins / WooCommerce設定 / 購入手続き / サブスクリプション一覧

復旧確認チェック

復旧確認:
[ ] 公開ページが表示される
[ ] WordPress管理画面へ入れる
[ ] WP-CLIでFatal Errorが出ない
[ ] Subscriptions for WooCommerceを有効化できる
[ ] WooCommerce Stripe Payment Gatewayが有効化できる
[ ] 購入手続き画面に決済方法が表示される
[ ] Stripeのテスト決済が完了する
[ ] 定期購入の作成・更新ができる
[ ] Stripe Webhookに失敗が出ていない
[ ] PHPログに `WC_Gateway_Stripe_Sepa` のFatal Errorが再発していない

NexraOneでできること

決済プラグイン同士の依存ズレは、トップページの外形監視だけでは見落とすことがあります。公開ページが500になっていれば気づきやすいですが、管理画面、購入手続き、定期購入更新、Webhookだけが止まるケースでは発見が遅れます。

NexraOne AgentでFatal Error、更新履歴、Heartbeat、WP-Cronの状態を見られるようにしておくと、保守担当者は「直前にどのプラグインを更新したか」「WordPress内部でどのエラーが出たか」を早く照合できます。決済系プラグインの更新後は、プラグイン更新前の確認チェックリスト と WooCommerce Stripe 10.5.0でAmazon Pay使用時にFatal Errorになる問題の解決方法 も合わせて確認します。

あわせて確認したい記事

まとめ

Subscriptions for WooCommerceで WC_Gateway_Stripe_Sepa not found のFatal Errorが出る場合、このケースではSubscriptions for WooCommerce側の修正版または最新版への更新が解決方法です。

管理画面へ入れない場合は、wp-content/plugins/subscriptions-for-woocommerce を _subscriptions-for-woocommerce などへ変更して一時停止し、管理画面へ戻れる状態を作ります。Stripe 10.2.0へのロールバックは緊急時の一時手段に留め、復旧後はSubscriptions側の修正版更新、Stripe決済、定期購入更新、Webhook、PHPログまで確認します。

※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。

WordPress Monitoring Service

WordPressサイトの異常に、
早く気づける体制を作りませんか?

死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。

ブログ一覧に戻る

合わせてこんな記事も読まれています

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

2026-11-13

wp-maintenance

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。

最新記事はこちら

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

2026-11-20

wp-guide

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。