公開日:
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側の修正版へ更新することで復旧できる事例です。
管理画面へ入れない場合は、先に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、注文ステータスまで確認します。
ログをどう判断したか
ログでは、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側の修正完了が案内されています。
- Subscriptions for WooCommerce - WordPress.org
- WooCommerce Stripe Payment Gateway - WordPress.org
- WC_Gateway_Stripe_Sepa not foundの解決済み事例
- Updated Stripe Checkout Experience - WooCommerce Docs
確認環境
確認対象:
- 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になる問題の解決方法 も合わせて確認します。
あわせて確認したい記事
- WooCommerce Stripe 10.5.0でAmazon Pay使用時にFatal Errorになる問題の解決方法 は、同じStripe決済プラグインで発生した別のFatal Error事例です。
- WooCommerce更新後にRestApiCacheが見つからずFatal Errorになるときの直し方 は、更新ファイル不整合を疑うときに使えます。
- WordPressで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ログまで確認します。
※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。
この記事を書いた人
WordPress Monitoring Service
WordPressサイトの異常に、
早く気づける体制を作りませんか?
死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。
合わせてこんな記事も読まれています
2026-11-18
wp-maintenance
WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方
WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。
2026-11-16
wp-maintenance
WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること
WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。
2026-11-13
wp-maintenance
WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること
WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。
最新記事はこちら
2026-11-20
wp-guide
ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき
ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。
2026-11-18
wp-maintenance
WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方
WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。
2026-11-16
wp-maintenance
WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること
WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。
