料金・決済モジュール完全ガイド
Nexty.devはStripeをベースとした完全なSaaS料金・決済ソリューションを提供します。コード設計はSaaS製品の決済機能のベストプラクティスに従い、一回限りの購入とサブスクリプション決済モデルの両方をサポートし、完全なユーザー特典管理、クレジットシステム、多言語対応を備えています。
主要機能
- ✅ デュアル決済モデル：一回限りの購入 + サブスクリプション、月額・年額サブスクリプションオプション対応
- ✅ クレジットシステム：一回限りのクレジット + サブスクリプションクレジット管理、年額サブスクリプションは毎月クレジットリセット可能
- ✅ ユーザークレジット変更履歴：ユーザーはクレジット取引記録を確認可能
- ✅ Stripe統合：完全な決済フローとwebhook処理
- ✅ 多言語対応：料金プランの国際化対応
- ✅ 管理ダッシュボード：視覚的な料金プラン管理
- ✅ 特典管理：柔軟なユーザー特典設定
- ✅ 返金処理：自動返金と特典回収
コア機能
料金プラン管理
- 環境分離：Stripeの
testとlive環境をサポートし、自動環境分離検証によりデータ混同を回避 - 多言語設定：
lang_jsonbフィールドを通じて多言語対応、ワンクリック翻訳 - 特典定義：デフォルトで
one_time_creditsとmonthly_creditsフィールドをクレジット特典として提供、benefits_jsonbフィールドによる柔軟なプラン特典定義 - 表示制御：ハイライト、ソート、アクティベーション状態制御をサポート
- リアルタイムプレビュー：カード変更のリアルタイムプレビュー、安全で制御可能な料金プラン表示コンテンツ
料金管理の詳細については、料金プラン管理をご覧ください。
決済プロセス
一回限りの購入フロー
Loading diagram...
サブスクリプションフロー
Loading diagram...
クレジットシステム
Nextyのクレジットシステムは以下の機能を標準で提供します：
- 一回限りクレジット：購入後永続的に有効、累積計算をサポート
- サブスクリプションクレジット：各請求サイクルでリセット、月額/年額割り当て、年額サブスクリプションクレジットは毎月配布/リセット可能
- 控除戦略：サブスクリプションクレジットを優先、サブスクリプションクレジット不足時に一回限りクレジットを控除
- 残高管理：リアルタイム残高照会と更新
- クレジット履歴：ユーザーはクレジット取引履歴を確認可能
シンプルなSaaS製品では、組み込みロジックを直接使用できます。より複雑なクレジットシステムと処理ロジックが必要な場合は、benefits_jsonbフィールドを通じて自由に拡張し、後続のチュートリアルに従って対応するロジックを開発できます。
データベース設計
コアテーブル構造
- pricing_plans - 料金プランテーブル
- すべての料金プラン設定を保存
- 多言語と特典定義をサポート
- Stripe環境分離 (test/live)
- orders - 注文テーブル
- すべての決済トランザクションを記録
- 複数の注文タイプをサポート
- 完全な決済情報追跡
- subscriptions - サブスクリプションテーブル
- Stripeサブスクリプション状態を同期
- サブスクリプションライフサイクル管理
- 請求サイクル追跡
- usage - 使用量テーブル
- ユーザークレジット残高管理
- 複数のクレジットタイプをサポート
- リアルタイム残高更新
- credit_logs - クレジットログテーブル
- ユーザー変更履歴記録
- 紛争時の証拠として提出可能な完全な変更記録
主要コンポーネント
バックエンドコンポーネント
lib/stripe/- Stripeコア処理ロジックactions/prices/- 料金プラン管理actions/usage/- クレジット管理
フロントエンドコンポーネント
components/home/Pricing.tsx- カテゴリ別料金表示（デフォルト）components/home/PricingAll.tsx- すべての料金を一度に表示components/home/PricingCTA.tsx- 購入ボタンapp/[locale]/(protected)/dashboard/(admin)/prices/- 管理ダッシュボードapp/[locale]/(protected)/dashboard/(user)/subscription/- ユーザーサブスクリプション管理app/[locale]/(protected)/dashboard/(user)/credit-history- ユーザークレジット変更履歴