チェックアウト障害は実取引に関わるため、複数のプラグインやキャッシュを変更する前にログと注文データを保全します。
実課金や重複注文が起きる可能性があるテストは、安全な決済方法またはステージングで行ってください。
1. 正確な失敗手順を再現する
カート内容、顧客状態、決済方法、ブラウザ操作、表示エラーを記録します。「チェックアウトできない」より再現手順の方が重要です。
2. フロントとサーバーを分ける
JavaScript エラー、ブロックされたリクエスト、検証失敗と、PHP エラーや決済ゲートウェイ応答は別です。ブラウザネットワークとサーバーログの両方を確認します。
3. 決済と Webhook を確認する
フォーム送信は成功しても、決済確認や後続 Webhook が失敗することがあります。ゲートウェイログと注文ステータス遷移を確認します。
4. キャッシュ・最適化の除外を確認する
カート、チェックアウト、アカウントは通常ページのようにキャッシュすべきではありません。スクリプト遅延や圧縮も決済部品を壊すことがあります。
5. 拡張を一つずつ切り分ける
可能ならステージングで、配送、税、サブスク、不正検知など疑わしい境界を一つずつテストします。
6. 修正後は取引全体を確認する
決済、注文作成、メール、在庫、Webhook、外部フルフィルメントや CRM まで確認します。