> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SaaSサブスクリプションを運営

> 月額/年額の定期課金プランを設定。トライアル、キャンセル対応を含む

## 対象者

このガイドは、サブスクリプションベースのサービスや商品を販売するマーチャント向けです。一般的な例：

| ビジネスタイプ       | 例                             |
| ------------- | ----------------------------- |
| SaaS製品        | プロジェクト管理ツール、CRM、分析プラットフォーム    |
| コンテンツプラットフォーム | オンライン学習、プレミアムニュースレター、メディアアクセス |
| デジタルサービス      | クラウドホスティング、APIアクセス、デザインツール    |
| メンバーシップ       | コミュニティアクセス、プレミアムサポート、限定コンテンツ  |

***

## サブスクリプションライフサイクル

設定を始める前に、サブスクリプションの全体フローを理解しましょう：

```
トライアル → アクティブ → (毎期更新) → キャンセル中 → キャンセル済み
                    ↑                       ↓
                    └──── 再有効化 ─────────┘
```

| ステータス       | 意味                      |
| ----------- | ----------------------- |
| `trialing`  | 無料トライアル期間中              |
| `active`    | 支払い中の顧客、サブスクリプションはアクティブ |
| `past_due`  | 支払い失敗、Waffoが自動リトライ中     |
| `canceling` | 顧客がキャンセル済み、期間終了までアクセス継続 |
| `canceled`  | サブスクリプションが完全に終了         |

***

## ステップ1：サブスクリプション商品を作成

通常、異なる価格ティア用に複数の商品を作成します（例：ベーシック、プロ、エンタープライズ）。

<Steps>
  <Step title="商品ページへ移動">
    Dashboardのサイドバーから**商品**をクリックします。

    <Frame>
      <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/guides/products-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=2644c3ec77acc0f3c7769bdd91553232" alt="商品一覧ページ" width="1440" height="900" data-path="images/guides/products-list.png" />
    </Frame>
  </Step>

  <Step title="サブスクリプション商品を作成">
    **商品を作成**をクリックし、商品タイプとして**サブスクリプション**を選択します。

    <Frame>
      <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/guides/create-subscription-product.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=93bbcb12bcebb09ce92d5e961981986a" alt="サブスクリプション商品作成フォーム" width="1440" height="900" data-path="images/guides/create-subscription-product.png" />
    </Frame>
  </Step>

  <Step title="価格を設定">
    * **名前**：プラン名（例：「ベーシックプラン」「Proプラン」）
    * **課金期間**：月次、四半期、または年次を選択
    * **価格**：定期価格を設定
    * **説明**：このプランに含まれるもの

    <Tip>
      各課金期間ごとに別々の商品を作成してください。例えば、同じプランの月額版と年額版をそれぞれ作成します。
    </Tip>
  </Step>

  <Step title="保存して有効化">
    **保存**をクリック。商品はデフォルトでテストモードで作成されます。準備ができたら有効化してください。
  </Step>
</Steps>

***

## ステップ2：商品グループでプランを整理

複数のティア（ベーシック、プロ、エンタープライズ）がある場合、**商品グループ**で整理します。

<Steps>
  <Step title="商品グループを作成">
    **商品**に移動し、新しい商品グループを作成（例：「料金プラン」）。
  </Step>

  <Step title="商品をグループに追加">
    同じグループに属するサブスクリプション商品を選択。価格ティアをまとめて管理できます。
  </Step>

  <Step title="グループ設定を構成">
    * **共有トライアル**：有効にすると、同じグループ内の1つのプランでトライアルを使用した顧客は、別のプランでトライアルを再利用できません。
  </Step>
</Steps>

<Note>
  商品グループは任意ですが、複数の価格ティアを提供する場合は推奨です。トライアルの不正利用を防ぎ、管理を簡素化します。
</Note>

***

## ステップ3：共有して販売開始

一回限りの商品と同様に、サブスクリプション商品にもチェックアウトリンクがあります。

### チェックアウトリンクを共有

商品詳細ページからチェックアウトリンクをコピー：

```
https://checkout.waffo.ai/your-store/my-product
```

### 料金ページを作成

ウェブサイトに各プランのチェックアウトURLにリンクする料金ページを作成：

> 以下の価格は例です。実際のビジネスに合わせて設定してください。

| プラン      | 価格     | チェックアウトリンク                                             |
| -------- | ------ | ------------------------------------------------------ |
| ベーシック    | \$9/月  | `https://checkout.waffo.ai/your-store/basic-plan`      |
| プロ       | \$29/月 | `https://checkout.waffo.ai/your-store/pro-plan`        |
| エンタープライズ | \$99/月 | `https://checkout.waffo.ai/your-store/enterprise-plan` |

***

## ステップ4：サブスクリプションを監視

### サブスクリプションダッシュボード

サイドバーの**サブスクリプション**をクリックして、すべてのアクティブ、トライアル中、キャンセル済みのサブスクリプションを確認。

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/guides/subscriptions-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=b096a5c0a55a9a70ae469be890dd431e" alt="サブスクリプション一覧ページ" width="1440" height="900" data-path="images/guides/subscriptions-list.png" />
</Frame>

各サブスクリプションに表示される情報：

* 顧客メールアドレス
* 現在のプラン
* ステータス（アクティブ、トライアル中、期限超過など）
* 現在の課金期間の開始・終了日
* 次回課金日

### サブスクリプション詳細

任意のサブスクリプションをクリックして詳細を表示：

* 支払い履歴
* プラン変更履歴
* キャンセル詳細（該当する場合）

***

## ステップ5：キャンセルに対応

顧客がキャンセルすると、サブスクリプションは**キャンセル中**状態になります。現在の課金期間が終了するまでアクセスは継続し、その後**キャンセル済み**になります。

### 自動処理

* 顧客にキャンセル確認メールが送信
* あなたに通知が届く
* 期間終了までアクセスは継続
* 追加の請求は発生しない

### Dashboardでキャンセルを確認

**キャンセル中**または**キャンセル済み**ステータスでフィルターして、離脱した顧客を確認。

***

## ビジネスシナリオ

<Note>
  以下はシナリオ例です。実際のビジネスに合わせて調整してください。
</Note>

### シナリオ1：月額・年額プランのSaaS

1. **商品を作成**：同じプランの月額版と年額版をそれぞれ作成
2. **グループ化**：商品グループを作成してリンク
3. **料金ページ**：ウェブサイトで各オプションにリンク
4. **監視**：分析ページでMRRと解約率を追跡

### シナリオ2：無料トライアル付きコンテンツプラットフォーム

1. **商品を作成**：サブスクリプションプランと価格を設定
2. **トライアルを有効化**：14日間の無料トライアル期間を設定
3. **リンクを共有**：顧客が登録するとトライアルが即座に開始
4. **トライアル終了後**：自動的に有料サブスクリプションに移行、または支払い方法が未追加の場合は期限切れ

### シナリオ3：ティア制APIサービス

1. **商品を作成**：各ティアごとにサブスクリプション商品を作成し、異なるAPIコールクォータと価格を設定
2. **グループ化**：商品グループを作成、共有トライアルを有効化
3. **Webhookを統合**：顧客が購読したプランに基づいて適切なAPI制限を付与

***

## さらに進む：コード統合

### コードが必要な場合

* **アクセス制御**：アプリ内でサブスクリプションステータスを確認して機能をゲート
* **自動プロビジョニング**：Webhookでアカウント作成や制限調整を自動化
* **カスタムキャンセルフロー**：フィードバック収集付きのアプリ内キャンセルを構築

### 主要なWebhookイベント

| イベント                             | トリガータイミング       |
| -------------------------------- | --------------- |
| `subscription.activated`         | 新しいサブスクリプション開始  |
| `subscription.updated`           | プラン変更または更新      |
| `subscription.canceled`          | サブスクリプションが完全に終了 |
| `subscription.payment_succeeded` | 定期支払いが処理された     |
| `subscription.past_due`          | 支払い試行が失敗        |

Webhookの設定は[Webhookガイド](/ja/guides/webhooks)をご覧ください。APIの詳細は[APIリファレンス](/ja/api-reference/introduction)をご覧ください。

***

## テスト

<Steps>
  <Step title="テストモードを有効化">
    Dashboardでテストモードに切り替えます。
  </Step>

  <Step title="テストカードでサブスクライブ">
    `4576 7500 0000 0110` を使用して成功するサブスクリプションをシミュレート。
  </Step>

  <Step title="サブスクリプションを確認">
    サブスクリプションページに正しいプランとステータスで表示されることを確認。
  </Step>

  <Step title="キャンセルをテスト">
    テストサブスクリプションをキャンセルし、キャンセル中 → キャンセル済みへの遷移を確認。
  </Step>
</Steps>

***

## ローンチチェックリスト

* [ ] 各プラン/ティアのサブスクリプション商品を作成
* [ ] 商品グループを設定（複数ティアの場合）
* [ ] 料金ページが正しいチェックアウトURLにリンク
* [ ] テストサブスクリプションフローがエンドツーエンドで動作
* [ ] キャンセルフローをテスト済み
* [ ] 通知メールが正しく表示
* [ ] 商品を本番環境に公開

***

## 次のステップ

<CardGroup cols={2}>
  <Card title="Webhook通知を設定" icon="webhook" href="/ja/guides/webhooks">
    サブスクリプションイベント通知でアクセス制御を自動化
  </Card>

  <Card title="AIプロダクト課金" icon="chart-line" href="/ja/guides/ai-billing">
    サブスクリプションと従量課金を組み合わせる
  </Card>
</CardGroup>