AI駆動開発でStripe審査を1回で突破する—「孤島コード」と「一発突破」の生存戦略
Stripe本番審査で「基準未達」の宣告を受けた。原因を1つずつ修正して再申請するより、考えうる懸念点(特商法・利用規約・動作確認導線)を一度に全修正して再申請する「一発突破」戦略で突破した。
症状
- 使用スタック: Remix v2 / Cloudflare Pages / Claude Code / Stripe(本体審査&JCBブランド審査)
- 「○日以内に対応しなければ決済機能を停止する」という宣告と、週末を挟んだリマインドメール
- 「何が不足しているか」の詳細は開示されず、ダッシュボードの簡素なステータスから推測するしかない
- 再審査に2営業日かかるため、1つの修正に賭けるのはリスクが高い状況だった
原因(2つの仮説検証と、潜んでいた別の問題)
仮説1: 特商法の「形式美」不足
既存の特商法ページをStripeのガイドラインと一文字一句照らし合わせた結果、返品規定の表現が曖昧で、事業者名が登記情報と完全に一致していない(略称を含む)という「審査官に疑念を抱かせる隙」が見つかった。
仮説2: TOPページのリダイレクトが視界を遮っている
当時、独自ドメインへの移行に伴い、TOPページをLPへ強制リダイレクトするBulk Redirects設定を入れていた。審査員は申請ドメインのルートから確認を始めるため、これは「実体不明なサイト」と判定される要因だった。
潜んでいた別の問題: AIによる「孤島コード」
調査の過程で、特商法モーダルの一部が既存UIコンポーネントを再利用せず、AIが「それっぽく見える別実装」を生成していたことが発覚した。「既存のヘッダー・フッターと同じラベル、構造にして」と指示しても、AIはラベル名だけ合わせて中身をハードコードした別実装を作っていた。審査用の簡易実装という油断からテストを省略していたため、発見が遅れた。この問題はStripeエージェントがSSoT違反の実装を「完了」と報告してきた事件と同じ構造。
根本原因は3つの要素の組み合わせだった: ①「決済導入は簡単」という見積もりの甘さがタイトなスケジュールを招いた ②期限の圧迫で「テストを書いて共通化を強制する」設計プロセスを省略した ③AIは指示が具体的でも既存コードのコンテキストを読み飛ばして「もっともらしい新規コード」を生成する
解決策
「どれが原因か」を切り分ける時間を捨て、考えうる懸念点を全て同時に修正して再申請1回で合格を取る戦略を採用した。
// app/lib/blog/common/resolveLegalContent.ts
export const legalContent = {
returnPolicy: "デジタルコンテンツの特性上、返品・キャンセルはお受けできません。購入前に必ず利用規約をご確認ください。",
sellerName: "登記簿上の正確な事業者名(株式会社○○)", // 略称を排除
};- TOPページのリダイレクトを一時的に解除し、審査員が即座にサービス内容を確認できる導線を確保
- 修正完了後、Stripe担当者へ「修正箇所の箇条書き」「修正後URLと変更意図」を明示した再審査依頼メールを送付
孤島コードを防ぐため、簡易ページであっても共通コンポーネントの使用をテストで担保した。
// 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等)には、原因の特定に固執するより「懸念点の全排除」が結果として最速の解決策になる
- 決済導入の「週末またぎ」を避ける。金曜日に申請せず、月曜日に申請して週内に対応を完結させるリソース配分にする
- シークレット管理が複雑な処理ほど、ローカルでのスタブ実行を整備してフィードバックループを短くする