AI駆動開発でStripe審査を1回で突破する—「孤島コード」と「一発突破」の生存戦略

はじめに

Stripe本番審査で「基準未達」の宣告を受けました。原因を1つずつ修正して再申請するより、考えうる懸念点（特商法・利用規約・動作確認導線）を一度に全修正して再申請する「一発突破」戦略で突破できます。

Stripe審査でこんなことありませんか？

AIを使って爆速で決済機能を実装し、テストもパスして意気揚々と本番審査を申請した。
しかし、いざ蓋を開けてみると「基準未達」の宣告と、詳細の分からない修正依頼が届き、再申請のループに陥ってしまう。
不透明な審査待ちという「博打」に時間を費やし、収益化の機会を逃し続ける不完全な現状。

この記事をお勧めしない人

一つずつの修正を丁寧に検証し、審査時間をいくらでもかけられる人。
AIの出力したコードを無条件に信頼し、テストによる検証を不要と考える人。
不確実な外部プロセスに対して、外交的なアプローチが必要ないと思っている人。

もし一つでも当てはまらないなら、読み進める価値があるかもしれません。

突然のサービス停止と資金凍結

週末のリマインドメールによる精神的圧迫感が焦りを生み、本来必要な設計プロセスを省略する土壌が作られてしまう。
「早く直さなければ」という焦燥感がAIへの指示を歪め、共通コンポーネントを無視した、その場限りの「孤島コード」を生み出す原因となる。
ローカルで再現できないデプロイ・ラグの沼に沈み、システムの保守性を根本から破壊し、最悪の場合は決済機能の停止や資金凍結を招く。

「一発突破」の戦略という明るい未来

不透明な外部審査を最小コストで突破し、収益化へ最短で到達するための「一発突破」の判断軸が手に入る。
特商法の形式美と導線確保を同時に実行し、AI特有の「サボり」をテストで封じ込める、実戦的な設計図を習得できる。
この戦略は本プロジェクトのStripe審査で実証済みであり、巷の一般論では得られないAI時代の生存戦略を習得できる。

私も同じでした

筆者も「決済導入は数日で終わる」という甘い見積もりにより、週末をまたぐ審査のプレッシャーに沈んだ経験があります。
この記事で、合理的なシステムと向き合い、技術と外交を使い分けて最短で合格をもぎ取るための実践的なTipsをまとめました。
深掘りしたい方は、AI駆動開発におけるユニットテストの強制力についても確認できます。

📝 概要

AI（Claude Code）を用いて実装した決済機能のStripe本番審査において、複数の懸念点により一度審査落ちを経験しました。本記事では、不確実な審査基準に対して「原因の特定」に固執せず、考えうる懸念点を一気に修正して再申請1回で突破した「一発突破」の生存戦略を記録します。また、AI駆動開発特有の課題である「孤島コード」の発生メカニズムとその対策についても深掘りします。

発生環境

フレームワーク : Remix v2
ホスティング : Cloudflare Pages
AIツール : Claude Code
決済プラットフォーム : Stripe (Stripe本体審査 & JCBブランド審査)

⚠️ 問題の発見と症状

Stripeの統合を完了し、テスト環境での動作確認も万全な状態で本番審査を申請しました。しかし、数日後に届いたのは「審査不通過」を知らせるメールでした。

症状:

金曜日の「機能停止」宣告 : 「○日以内に対応しなければ決済機能を停止する」という、実害を伴う宣告。
土日のリマインド爆撃 : 作業が困難な週末にも「期限が迫っています」という自動送信メールが届き、精神的な圧迫感が増大。
情報の非対称性 : 「何が不足しているか」の詳細は明示されず、Stripeのダッシュボード上の簡素なステータスから推測するしかない状況。
博打のような再審査 : 1回の再審査に2営業日かかるため、一つの修正に賭けるのはリスクが高い。

🔍 調査と試行錯誤のプロセス

仮説1: 特商法の「形式美」が不足しているのではないか？

試したこと:
既存の特商法ページを見直し、Stripeのガイドラインと一文字一句照らし合わせました。

分かったこと:
返品規定の表現がやや曖昧であり、事業者名が登記情報と完全に一致していない（略称が含まれる）などの「審査官に疑念を抱かせる隙」があることが判明しました。

仮説2: TOPページのリダイレクトが審査員の視界を遮っている？

試したこと:
当時、開発中のTOPページをLP（ランディングページ）へ強制リダイレクトしていましたが、これが審査員の「サービス内容の直接確認」を妨げている可能性を疑いました。（このリダイレクト設定はCloudflare Pages独自ドメイン移行の全記録で設定したBulk Redirectsです。）

分かったこと:
審査員は申請されたドメインのルートから確認を開始するため、リダイレクトは「実体不明なサイト」と判定される大きなリスク要因でした。

潜んでいた別の問題: AIによる「孤島コード」の生成

調査の過程で、特商法モーダルの一部が既存のUIコンポーネントを再利用せず、AIによって「それっぽく見える別実装」として生成されていることが発覚しました。この「孤島コード」問題は実はStripe実装の前段階でより深刻な形で発生していました。StripeエージェントがSSoT違反の実装を「完了」と報告してきた事件の記録も合わせて読むと、AI駆動開発の落とし穴の構造が見えてきます。

指示 : 「既存のヘッダー・フッターと同じラベル、構造にして」
AIの挙動 : ラベル名は合わせたが、中身はハードコードされた「孤島（別実装）」を生成。
結果 : 共通のスタイル変更が反映されず、審査用の簡易実装という「油断」からテストを省略していたため、発見が遅れました。

💡 根本原因の特定

今回の問題は、単なる技術的なミスではなく、以下の3つの要素が組み合わさった構造的なものでした。

原因:

見積もりの甘さ : 「決済導入は簡単」という予断が、週末をまたぐタイトなスケジュールを招き、心理的な余裕を奪いました。
焦燥感によるプロセスの崩壊 : 期限の圧迫により「テストを書いて共通化を強制する」という本来の設計プロセスを省略してしまいました。
AI駆動開発の盲点 : AIは指示が具体的であっても、既存コードのコンテキストを読み飛ばして「もっともらしい新規コード」を生成（サボり）する傾向があります。

🔧 解決策

「どれが原因か」を切り分ける時間を捨て、考えうる懸念点をすべて同時に修正して再申請1回で合格をもぎ取る戦略を採用しました。

1. 特商法の「形式美」の追求

返品不可条項の明記と、事業者名の完全同期を実施しました。

// app/lib/blog/common/resolveLegalContent.ts の修正例
export const legalContent = {
  // 審査官が迷わないよう、返品不可であることを冒頭に明記
  returnPolicy: "デジタルコンテンツの特性上、返品・キャンセルはお受けできません。購入前に必ず利用規約をご確認ください。",
  sellerName: "登記簿上の正確な事業者名（株式会社○○）", // 略称を排除
};

2. リダイレクト解除による導線の確保

審査員がアクセスした瞬間に「何を提供しているか」がわかるよう、TOPページのリダイレクトを一時的に解除しました。

3. 外交の初動（再審査依頼メール）

改修完了後、Stripe担当者へ以下のポイントを押さえたメールを送信しました。

修正箇所の箇条書き : 「特商法の表記修正」「リダイレクト解除による導線確保」を明示。
証拠の提示 : 修正後のURLと、変更の意図を説明。
丁寧な外交 : 「貴社の合理的な基準を理解した上での修正である」という敬意を示す。

4. ユニットテストによる共通化の強制

「孤島コード」を防ぐため、簡易ページであっても共通コンポーネントの使用をテストで担保しました。

// LegalModal.test.tsx にて共通化を強制する
it('should use the common styling labels defined in specs', () => {
  render(<LegalModal isOpen={true} ... />);
  // 独自ラベルではなく、プロジェクト共通のspecから値を参照しているか確認
  expect(screen.getByText(spec.labels.close)).toBeInTheDocument();
});

🎓 学んだこと・まとめ

技術的な学び

AIは「サボる」 : 「既存と同じに」という指示は、テストがない限りAIにとって「それっぽく作る」というライセンスになり得ます。
デプロイ・ラグの回避 : シークレット管理（環境変数）が複雑な場合こそ、ローカルでのスタブ実行を整備し、フィードバックループを回すべきです。

今後のベストプラクティス（生存戦略）

決済導入の「週末またぎ」を避ける : 金曜日に申請せず、月曜日に申請して週内に外交を完結させるリソース配分。
一発突破の精神 : 審査という不透明な外部プロセスに対しては、原因の特定よりも「懸念点の全排除」が結果として最速の解決策になる。
システムへの敬意 : Stripeの厳しい審査は、プラットフォームの信頼性を守るための合理的な設計です。それを恨むのではなく、自分の「見積もりの甘さ」を改善の起点にするプロフェッショナリズムが重要です。

🔗 関連リソース

同じような問題で困っている方の参考になれば幸いです！