Stripe と認証付き Next.js SaaS ボイラープレート:2026 年版ガイド
「Stripe と認証付き Next.js SaaS ボイラープレート」を探すのは、機能探しに見えます。しかし実際は違います。本当の問いはひとつです。コモディティ化した 60 パーセント——登録、データベース、課金、ダッシュボード、デプロイ——のうち、どれだけを自分で書かなければならないか、です。このガイドは、検討中のどんなスターターにも使える具体的な 10 分チェックを提示します。このサイトが配布しているものも含めて。

まずは譲れない 4 点
これらは「あれば良い」ではなく、合格か不合格かで判断してください。どれかひとつ欠けていれば、1 か月以内に作り直すことになります。しかもたいてい、実際の顧客がもう待っている最悪のタイミングで。
| 領域 | 最初から配線されているべきもの | コードで確認すること | | --- | --- | --- | | 認証 | メールのマジックリンクと OAuth、行レベルセキュリティが既定で有効 | Supabase Auth の連携と、実際に読める RLS ポリシー(スタブではないこと) | | 課金 | ホスト型チェックアウトと、データベースのプランフラグを切り替える Webhook | イベントが検証され、重複排除され、その順で書き込まれること | | データベース | シード済みスキーマとマイグレーション履歴を持つ Postgres | 初期スキーマがリポジトリにコミット済みで、README の散らかった SQL dumping ではないこと | | デプロイ | Vercel 対応設定と、1 コマンドで本番へ行ける導線 | 環境変数が名前で文書化され、サンプルファイルがあること |
ログインフォームと Stripe Checkout へのリダイレクト だけのスターターはデモです。検証済みの Webhook 署名 を権限の唯一の真実源にしているスターターがビジネスになります。
ほとんどのテンプレートがここで失敗する
この部分は 2 度読む価値があります。ブラウザのリダイレクトは嘘をつきます。ユーザーはタブを閉じ、プロバイダはリトライし、テストは 2 回発火します。検証済みの Webhook だけが、顧客の権限を変更すべきです。
私たちが使う契約は意図的に厳密です。
- 署名が欠落・無効・不正形式 → 即座にスローし、ルートは
400を返す。 - 正しく署名済みだが処理不要なイベント → 空リストを返し、ルートは ignored フラグ付きで
200を返す。 - 既に見たイベント id → プランやライセンスの書き込み前にスキップ。
これを逆にすると、それはセキュリティバグであり、好みの問題ではありません。このコードベースの初期版は検証失敗を「イベントなし」として 200 を返していました。つまり偽装リクエストが成功に見えていました。静かな 200 と引き換えに、本来の 400 を捨てないでください。

POST /api/webhook ルートでは、すべてのプロバイダアダプタが検証失敗でスローします。空配列が意味するのはちょうどひとつだけです。イベントは正しく署名済みだが、単に何もする必要がない——たとえばこのアプリが販売していない商品の checkout.session.completed。リプレイは書き込み前に webhook_events テーブルでイベント id により重複排除されます。イベントの種類に不慣れなら、Stripe の Webhook イベントリファレンス を自社プロバイダのドキュメントと並べて読むと分かりやすいです。
冪等性——最初の返金で出会うバグ
プロバイダはリトライします。ネットワークが信頼できない以上、そうするしかありません。冪等でない Webhook ハンドラは同じプランを 2 回書き込んだり、利用量を二重計上したり、顧客がすでに解約したサブスクリプションを再開したりします。修正は賢くありません。イベント id を記録し、まず照合し、その id が存在しないことを条件に書き込むだけです。
これが効くのは、めったにローンチ当日ではありません。最初の返金、最初の重複イベント、そして顧客が初めて請求書に疑問を持ったときです。その時点で冪等性を後付けするには、すでに出荷したすべての権限経路に手を入れる必要があります。必要になる前に組み込んでください。
関連する罠が、クライアントを証拠にしてしまうことです。ブラウザに成功ページが表示されても、Webhook が届いていないことはあります。権限はデータベースから読むべきです。そのデータベースは検証済みイベントによってのみ書き込まれます。クエリ文字列やローカルの状態フラグから読んではいけません。
1 つのゲートウェイか、5 つのプロバイダか
Uncorne の既定は Waffo Pancake です。これは販売税と VAT を代行する Merchant of Record、つまり平たく言えば merchant of record モデルです。Stripe、Creem、PayPal、Waffo Acquiring、Lemon Squeezy は生成時に切り替え可能で、自前で課金する場合は none も有効な選択です。
これらはすべて単一の PaymentProvider インターフェースとひとつの POST /api/webhook ルートの下にあります。アプリケーションコードが、どのゲートウェイが決済を処理したかで分岐することはありません。この分離が要点です。ゲートウェイはアーキテクチャの決定ではなく、設定の決定なのです。トレードオフは5 つのゲートウェイ比較を参照してください。

実際に走らせられる 10 分評価
機能リストをもう読みません。スターターを動かしてください。
git clone <スターターリポジトリ>
cd starter && cp .env.example .env.local
# 認証と課金の変数を埋めてから
npm install && npm run devそして順に試します。
- メールと OAuth でそれぞれ登録する。どちらも保護領域に着地するはずです。
- 有料機能のペイウォールに当たる。UI で隠れているだけではなく、サーバーで止められるはずです。
- テスト決済を完了する。ページを更新せずにデータベースのプランフラグが切り替わるはずです。
- 不正な署名で Webhook を叩く。
200ではなく400を返さなければなりません。 - 同じ有効イベントを 2 回送る。2 回目の書き込みはno-op(何もしない)であるべきです。
どの手順でも「今から自分でコードを書く必要がある」と塞がったら、答えは出ています。良いスターターは 5 ステップすべてを退屈にします。
ダウンロードパッケージに何が入るべきか
出荷できるスターターは、動くアプリ以上のものを渡すはずです。実際に受け取る ZIP の中身を確認してください。未選択のモジュールはコメントアウトではなく削除されているべきです。残ったプロバイダ、認証バックエンド、機能フラグは、後で監視すべきデッドコードになります。ナビゲーションも書き換えられ、剪定されたページへのリンクが残らないようにすべきです。
パッケージには、あなたとツールのための機械可読な指示も入っているべきです。リポジトリ契約と完了定義を述べた AGENTS.md、選んだビジュアルスタイルに固定されたデザインガイド、そして対応するエディタールールを探してください。これらは、AI コーディングアシスタントが意図的に削除したモジュールを再導入しないために重要です。読み取り順がなぜ重要かはAgent-Ready ドキュメントガイドを参照してください。
最後にブランド面を確認します。ソースコードを販売するジェネレータは、自社のマーケティングページ、価格コンポーネント、ジェネレータ内部を顧客のダウンロードから除去しなければなりません。他社製品への残存参照は見た目の問題ではなく、そのままユーザーに届きます。18 通りの代表的なビルド組み合わせを CI でダウンロードして型チェックすべきです。そうすれば、ある剪定ルールが特定の構成を壊した場合、顧客が見る前に失敗します。
正直な限界
完全なスターターは存在しません。これはプロフィール変更とロール管理のエンドポイント、そして請求ポータルを持っていますが、ローカル SQLite フォールバックはアカウントディレクトリであり、完全な認証プロバイダではありません。MFA も OAuth もセッションローテーションもありません。SMTP は未実装で、REST メーラーか安全な no-op を差し込む必要があります。書き込み経路を単純に保てる箇所では Server Actions を使っています。
この正直さ自体が機能です。何でもできると謳うテンプレートは、あなたがコミットした後にギャップを隠していることが多いものです。受け入れられるギャップを持ち、Webhook が 400 を返すべきときに 400 を返すものを選んでください。
著者について:WangNan は https://www.uncorne.com で、ソース公開型 SaaS のデリバリーについて執筆しています。
FAQ
Stripe と認証付き Next.js SaaS ボイラープレートで、まず確認すべきことは?+
まず Webhook の署名検証です。署名の欠落や無効には HTTP 400 を返し、権限書き込み前にイベント id を重複排除し、空のイベントリストは「正しく署名済みだが未処理」の場合だけに限定すべきです。他は比較的に表面的です。
ボイラープレートは Stripe を使わなければなりませんか?+
いいえ。Stripe はドキュメントが最も充実していますが、法人なしでグローバル販売するなら Waffo Pancake や Lemon Squeezy のような Merchant of Record が販売税処理を省きます。重要なのは payment に依存しない単一のチェックアウトと Webhook 契約です。
行レベルセキュリティはここで何を守りますか?+
RLS は、アプリケーションコードが WHERE 句を忘れてもデータベースがテナント境界を強制します。Supabase ベースのスターターでは、ユーザー所有テーブルに最初のマイグレーションから auth.uid() ポリシーがあるべきで、後付けではありません。
決済アカウントなしでスターターを評価できますか?+
できます。クローンしてサンプル環境変数を設定し、開発サーバーを起動し、不正な署名で Webhook を叩くと 400 を返すはずです。同じイベントを 2 回送って 2 回目が no-op なことも確認できます。実際の決済にはサンドボックスアカウントが必要です。