決済システムドキュメントインデックス

NEXTY.DEV決済システムのドキュメントへようこそ！このドキュメントは、基本概念から高度な機能まで、決済システムの使用に関する完全なガイドを提供し、迅速に始められるよう支援し、深い理解を得られるようサポートします。

ドキュメント構造

ドキュメントは「トップダウン」構造に従い、全体概要から始まり、徐々に特定の機能モジュールに深く入り込んでいきます。

コアドキュメント

1. 決済システム概要

• システムアーキテクチャの紹介
• コア機能の説明
• データベーステーブル構造
• コアモジュールの説明
• 決済フローの概要

2. 料金プラン管理

• 料金プランのデータ構造
• 料金プランの作成と管理
• 多言語サポート
• 特典の設定
• 決済プロバイダーの設定

3. 決済フローの詳細

• 完全な決済フローの説明
• チェックアウトセッションの作成
• 決済の検証
• エラーハンドリング
• セキュリティに関する考慮事項

4. Webhook処理メカニズム

• Stripe Webhookの処理
• Creem Webhookの処理
• イベントタイプの説明
• Webhookのテストとデバッグ

5. クレジットシステム

• クレジットタイプの説明
• クレジット付与メカニズム
• クレジットの使用と控除
• クレジットの取り消し
• クレジットログのクエリ

6. 注文とサブスクリプション管理

• 注文のクエリと管理
• サブスクリプションステータスの同期
• カスタマーポータルの使用
• クレジット履歴のクエリ

クイックスタート

新規ユーザーガイド

NEXTY.DEV決済システムを初めて使用する場合は、以下の順序で読むことをお勧めします：

1. ステップ1: 決済システム概要を読んで、全体のアーキテクチャを理解する
2. ステップ2: 料金プラン管理を読んで、料金プランの作成方法を学ぶ
3. ステップ3: 決済フローの詳細を読んで、決済プロセスを理解する
4. ステップ4: Webhook処理メカニズムを読んで、Webhookの設定について学ぶ
5. ステップ5: クレジットシステムを読んで、クレジット管理について学ぶ
6. ステップ6: 注文とサブスクリプション管理を読んで、注文とサブスクリプション管理をマスターする

ニーズ別検索

システムアーキテクチャを理解したい

→ 決済システム概要

料金プランを作成したい

→ 料金プラン管理

決済フローを理解したい

→ 決済フローの詳細

Webhookを設定したい

→ Webhook処理メカニズム

クレジットシステムを管理したい

→ クレジットシステム

注文とサブスクリプションをクエリしたい

→ 注文とサブスクリプション管理

機能の能力

サポートされている機能

• 複数の決済プロバイダー（Stripe、Creem）
• 一回限りの決済とサブスクリプション決済
• 月額サブスクリプションと年額サブスクリプション
• クレジットシステム（一回限りのクレジットとサブスクリプションクレジット）
• 多言語サポート
• クーポンと割引コード
• カスタマーポータル統合
• 自動Webhook処理
• 注文とサブスクリプション管理
• クレジット履歴のクエリ

環境変数の設定

Stripe

STRIPE_SECRET_KEY=sk_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_CUSTOMER_PORTAL_URL=/dashboard/subscription

Creem

CREEM_API_KEY=your_api_key
CREEM_WEBHOOK_SECRET=your_webhook_secret
CREEM_API_BASE_URL=https://api.creem.io/v1  # オプション

その他

NEXT_PUBLIC_PRICING_PATH=/pricing
NEXT_PUBLIC_SITE_URL=https://yourdomain.com
[email protected]

よくある質問

Q: 決済システムの使い始め方は？

A: まず環境変数を設定し、次に料金プランを作成し、最後にWebhookを設定します。詳細な手順については、各ドキュメントを参照してください。

Q: どの決済プロバイダーがサポートされていますか？

A: 現在、2つの決済プロバイダーをサポートしています：StripeとCreemです。

Q: 決済機能をテストするにはどうすればよいですか？

A: 決済プロバイダーのテストモードを使用し、Webhook転送を設定します。詳細な手順については、Webhook処理メカニズムを参照してください。

Q: クレジットシステムはどのように機能しますか？

A: クレジットシステムは2つのタイプをサポートしています：一回限りのクレジットとサブスクリプションクレジットです。詳細な説明については、クレジットシステムを参照してください。

Q: ユーザーのサブスクリプションを管理するにはどうすればよいですか？

A: ユーザーはカスタマーポータルを通じてサブスクリプションを管理でき、管理者はAPIを通じてサブスクリプションステータスをクエリできます。詳細な手順については、注文とサブスクリプション管理を参照してください。