価格設定と決済モジュール完全ガイド
Nexty.devは、Stripe決済ゲートウェイとSupabaseデータベースに基づいて構築された完全なSaaS価格設定と決済ソリューションを提供します。コード設計はSaaS製品の決済機能のベストプラクティスに従い、一回限りの購入とサブスクリプション決済モデルの両方をサポートし、包括的なユーザー特典管理、クレジットシステム、および多言語サポートを提供します。
主要機能
- ✅ デュアル決済モデル：一回限り購入 + サブスクリプション
- ✅ クレジットシステム：一回限りクレジット + サブスクリプションクレジット管理
- ✅ Stripe連携：完全な決済フローとWebhook処理
- ✅ 多言語サポート：価格プランの国際化対応
- ✅ 管理ダッシュボード：視覚的な価格プラン管理
- ✅ 特典管理：柔軟なユーザー特典設定
- ✅ 返金処理：自動返金と特典回収
コア機能
価格プラン管理
- 環境分離：
testとlive環境をサポートし、Stripe環境と連携してデータの混同を回避 - 多言語設定：
lang_jsonbフィールドによる多言語サポートとワンクリック翻訳 - 特典定義：デフォルトの
one_time_creditsとmonthly_creditsフィールドをクレジット特典として使用し、benefits_jsonbフィールドによるプラン特典の自由定義 - 表示制御：ハイライト表示、並び替え、アクティベーション状態制御をサポート
- リアルタイムプレビュー：カード修正のリアルタイムプレビューと安全で制御可能な価格カード表示コンテンツ
決済フロー
一回限り購入フロー
Loading diagram...
サブスクリプションフロー
Loading diagram...
クレジットシステム
Nexty.devのクレジットシステムは、以下の機能を標準で提供します：
- 一回限りクレジット：購入後永続的に有効、累積計算をサポート
- サブスクリプションクレジット：各請求サイクルでリセット、月次/年次配布
- 消費戦略：複数の消費優先度戦略をサポート
- 残高管理：リアルタイム残高照会と更新
シンプルなSaaS製品の場合、組み込みロジックを直接使用できます。より複雑なクレジットシステムと処理ロジックが必要な場合は、benefits_jsonbフィールドを通じて自由に拡張し、後続のチュートリアルに従って対応するロジックを開発できます。
データベース設計
コアテーブル構造
- pricing_plans - 価格プランテーブル
- すべての価格プラン設定を保存
- 多言語と特典定義をサポート
- 環境分離（test/live）
- orders - 注文テーブル
- すべての決済取引を記録
- 複数の注文タイプをサポート
- 完全な決済情報追跡
- subscriptions - サブスクリプションテーブル
- Stripeサブスクリプション状態の同期
- サブスクリプションライフサイクル管理
- 請求サイクル追跡
- usage - 使用量テーブル
- ユーザークレジット残高管理
- 複数のクレジットタイプをサポート
- リアルタイム残高更新
主要コンポーネント
バックエンドコンポーネント
lib/stripe/- Stripeコア処理ロジックactions/prices/- 価格プラン管理actions/usage/- クレジット管理
フロントエンドコンポーネント
components/home/Pricing.tsx- 価格表示components/home/PricingCTA.tsx- 購入ボタンapp/[locale]/(protected)/dashboard/(admin)/prices/- 管理ダッシュボードapp/[locale]/(protected)/dashboard/(user)/subscription/- ユーザーサブスクリプション管理