> ## 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.

# サブスクリプション

> 継続課金と購読者関係の管理

## サブスクリプション管理

サブスクリプションページには、顧客とのすべての継続課金契約が表示されます。

## サブスクリプションリスト

詳細なテーブルですべてのサブスクリプションを表示：

| 列     | 説明                |
| ----- | ----------------- |
| ステータス | 現在のサブスクリプションステータス |
| プロダクト | プロダクト名と画像         |
| 顧客    | 購読者のメール           |
| 金額    | 通貨付きのサブスクリプション価格  |
| サイクル  | 請求頻度              |
| 次回請求  | 次回の請求日            |
| 作成日   | サブスクリプション開始日時     |

## サブスクリプションステータス

<CardGroup cols={2}>
  <Card title="アクティブ" icon="check-circle" color="#22c55e">
    サブスクリプションが稼働中で通常通り請求中。
  </Card>

  <Card title="試用中" icon="flask" color="#3b82f6">
    顧客が無料試用期間中。
  </Card>

  <Card title="延滞" icon="clock" color="#f59e0b">
    支払い失敗、リトライ待ち。
  </Card>

  <Card title="キャンセル中" icon="hourglass-half" color="#f59e0b">
    キャンセルリクエスト済み、期間終了まで有効。
  </Card>

  <Card title="期限切れ" icon="calendar-xmark" color="#6b7280">
    サブスクリプションが期限切れ。
  </Card>

  <Card title="キャンセル済み" icon="xmark" color="#ef4444">
    サブスクリプション終了。
  </Card>
</CardGroup>

## 請求サイクル

| サイクル | 請求頻度   | MRR計算     |
| ---- | ------ | --------- |
| 週次   | 7日ごと   | 金額 × 4.33 |
| 月次   | 毎月     | 金額 × 1    |
| 四半期  | 3ヶ月ごと  | 金額 ÷ 3    |
| 年次   | 12ヶ月ごと | 金額 ÷ 12   |

## サブスクリプションのフィルタリング

| フィルター | オプション                            |
| ----- | -------------------------------- |
| ステータス | アクティブ、試用中、延滞、キャンセル中、期限切れ、キャンセル済み |
| プロダクト | 任意のサブスクリプション商品                   |
| サイクル  | 週次、月次、四半期、年次                     |
| 顧客    | メールで検索                           |

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

サブスクリプションをクリックして表示：

### 概要

* サブスクリプションID
* ステータスとステータス履歴
* プロダクト詳細
* 価格と通貨
* 請求サイクル

### 請求情報

* 現在の期間開始/終了
* 次回請求日
* 保存された支払い方法
* 請求履歴

### 顧客

* 顧客メール
* アカウント詳細
* 同じ顧客の他のサブスクリプション

### 支払い履歴

* このサブスクリプションのすべての請求
* 成功および失敗した試行
* 返金

## サブスクリプション管理

### キャンセル

<Steps>
  <Step title="サブスクリプション詳細を開く">
    キャンセルしたいサブスクリプションをクリック。
  </Step>

  <Step title="「サブスクリプションをキャンセル」をクリック">
    アクションメニューでボタンを見つける。
  </Step>

  <Step title="キャンセルを確認">
    キャンセルは現在の請求期間の終了時に有効になります。サブスクリプションは期間終了まで「キャンセル中」ステータスになり、その後「キャンセル済み」になります。
  </Step>
</Steps>

<Note>
  顧客は現在の支払い済み請求期間が終了するまでアクセスを維持します。
</Note>

### 再開

「キャンセル中」ステータスのサブスクリプションに対して、再アクティベーションエンドポイントは存在しますが、現在 501 を返します（未実装）。

## サブスクリプションメトリクス

### 統計カード

| メトリクス   | 説明               |
| ------- | ---------------- |
| MRR     | 月次経常収益           |
| アクティブ   | アクティブなサブスクリプション数 |
| 試用中     | 試用期間中のサブスクリプション数 |
| キャンセル済み | キャンセル数（今期）       |
| ARPU    | ユーザーあたり平均収益      |

### MRR計算

MRRはすべてのアクティブなサブスクリプションから計算：

```
MRR = Σ (サブスクリプション金額 × サイクル係数)

サイクル係数：
- 週次: 4.33
- 月次: 1
- 四半期: 0.33
- 年次: 0.083
```

## 支払い失敗

サブスクリプションの支払いが失敗した場合：

1. ステータスが「延滞」に変更
2. 自動リトライ（7日間で3回試行）
3. 顧客にメールで通知
4. すべてのリトライが失敗した場合、サブスクリプションがキャンセルされる可能性あり

### 催促メール

顧客に自動送信されるメール：

* 初回支払い失敗通知
* リトライリマインダー
* キャンセル前の最終警告
* キャンセル確認

## 試用期間

試用が有効なプロダクトの場合：

| フィールド   | 説明          |
| ------- | ----------- |
| 試用ステータス | アクティブな試用の表示 |
| 試用日数    | 総試用期間       |
| 残り日数    | 試用の残り時間     |
| 変換日     | 初回請求が発生する日時 |

試用変換を追跡：

* 試用 → アクティブ（変換済み）
* 試用 → キャンセル済み（変換前に解約）

## サブスクリプションアクション

<AccordionGroup>
  <Accordion title="プロダクト/プランを変更">
    サブスクリプションを異なるプロダクトにアップグレードまたはダウングレード。注意：このエンドポイントは現在 501 を返します（未実装）。
  </Accordion>

  <Accordion title="支払い方法を更新">
    顧客に保存されたカードを更新するリンクを送信。
  </Accordion>
</AccordionGroup>